You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@druid.apache.org by "vtlim (via GitHub)" <gi...@apache.org> on 2023/06/28 23:40:18 UTC

Re: [PR] Tasks API refactor (druid)

vtlim commented on code in PR #14492:
URL: https://github.com/apache/druid/pull/14492#discussion_r1245909926


##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 

Review Comment:
   ```suggestion
   This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. A task object provides information including its ID, status, associated datasource, and other metadata. The endpoint supports a set of optional query parameters to filter results. 
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses

Review Comment:
   Something to consider: To demarcate the responses section from the sample request section, you can add a horizontal rule `---` to the bottom of each response tab so that the sample request heading doesn't look like it's part of the response.
   ![image](https://github.com/apache/druid/assets/7747997/cada8cb7-10d0-4111-8201-7fc0c0291852)
   



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.

Review Comment:
   ```suggestion
   Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload that includes task configuration details and relevant specifications associated with the execution of the task.
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+  }
+  ```
+
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task" \
+--header "Content-Type: application/json" \
+--data "{
+  \"type\" : \"index_parallel\",
+  \"spec\" : {
+    \"dataSchema\" : {
+      \"dataSource\" : \"wikipedia_auto\",
+      \"timestampSpec\": {
+        \"column\": \"time\",
+        \"format\": \"iso\"
+      },
+      \"dimensionsSpec\" : {
+        \"useSchemaDiscovery\": true
+      },
+      \"metricsSpec\" : [],
+      \"granularitySpec\" : {
+        \"type\" : \"uniform\",
+        \"segmentGranularity\" : \"day\",
+        \"queryGranularity\" : \"none\",
+        \"intervals\" : [\"2015-09-12/2015-09-13\"],
+        \"rollup\" : false
+      }
+    },
+    \"ioConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"inputSource\" : {
+        \"type\" : \"local\",
+        \"baseDir\" : \"quickstart/tutorial/\",
+        \"filter\" : \"wikiticker-2015-09-12-sampled.json.gz\"
+      },
+      \"inputFormat\" : {
+        \"type\" : \"json\"
+      },
+      \"appendToExisting\" : false
+    },
+    \"tuningConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"maxRowsPerSegment\" : 5000000,
+      \"maxRowsInMemory\" : 25000
+    }
+  }
+}"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 952
+
+{
+  "type" : "index_parallel",
+  "spec" : {
+    "dataSchema" : {
+      "dataSource" : "wikipedia_auto",
+      "timestampSpec": {
+        "column": "time",
+        "format": "iso"
+      },
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
+      },
+      "metricsSpec" : [],
+      "granularitySpec" : {
+        "type" : "uniform",
+        "segmentGranularity" : "day",
+        "queryGranularity" : "none",
+        "intervals" : ["2015-09-12/2015-09-13"],
+        "rollup" : false
+      }
+    },
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
+      },
+      "inputFormat" : {
+        "type" : "json"
+      },
+      "appendToExisting" : false
+    },
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
+    }
+  }
+}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+      "task": "index_parallel_wikipedia_odofhkle_2023-06-23T21:07:28.226Z"
+  }
+  ```
+
+</details>
+
+### Shut down a task
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/task/{taskId}/shutdown`
+
+Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shutdown successfully.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down task of id `query-52as 8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown HTTP/1.1
+Host: (domain)
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-577a83dd-a14e-4380-bd01-c942b781236b'
+  }
+  ```
+
+</details>
+
+### Shut down all tasks for a datasource
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+
+Shuts down all tasks for a specified datasource. If successful, it returns a JSON object with the name of the datasource whose tasks are shut down.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Error or datasource does not have a running task* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down all tasks for datasource `wikipedia_auto`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "dataSource": "wikipedia_api"
+  }
+  ```
+
+</details>
+
+## Task management
+
+### Retrieve status objects for tasks
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/taskStatus`
+
+Retrieve list of task status objects for list of task id strings in request body. It returns a set of JSON objects with the status, duration, location of each task, and any error messages if applicable.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved status objects* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Missing request body or incorrect request body type* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of retrieving status objects for task id `index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z` and `index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z` .
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/taskStatus" \
+--header "Content-Type: application/json" \
+--data "[\"index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z\", \"index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z\"]"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/taskStatus HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 134
+
+["index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z", "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z"]
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z": {
+        "id": "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z",
+        "status": "SUCCESS",
+        "duration": 10630,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    },
+    "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z": {
+        "id": "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z",
+        "status": "SUCCESS",
+        "duration": 11012,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Clean up pending segments for a data source.
+
+#### URL
+
+<code class="deleteAPI">DELETE</code> `/druid/indexer/v1/pendingSegments/{dataSource}`
+
+Manually clean up pending segments table in metadata storage for `datasource`. It returns a JSON object response with
 `numDeleted` and count of rows deleted from the pending segments table. This API is used by the
 `druid.coordinator.kill.pendingSegments.on` [coordinator setting](../configuration/index.md#coordinator-operation)

Review Comment:
   ```suggestion
   `druid.coordinator.kill.pendingSegments.on` [Coordinator setting](../configuration/index.md#coordinator-operation)
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 

Review Comment:
   What does "or executed" mean, completed? Would it be accurate to say "all tasks objects in the Druid cluster"?
   
   Also not sure what "current" Druid cluster means. (and ditto for all the requests that mention it)



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|

Review Comment:
   If we use quotation marks around `"complete"` here, we should stay consistent for the description of `state`.



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 

Review Comment:
   ```suggestion
   This endpoint retrieves an array of completed tasks in the Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 

Review Comment:
   Suggest moving the last statement to the query parameters section, something like:
   ```
   You can filter query results with the following optional query parameters.
   ```
   (ditto for all requests)



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.

Review Comment:
   ```suggestion
   For query parameters that take an interval, provide ISO 8601 strings delimited by `_` instead of `/`.
   For example, `2023-06-27_2023-06-28`.
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.

Review Comment:
   The previous descriptions started with "This endpoint" but this one starts with a verb. Either is okay, but let's choose one and be consistent throughout.



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1391 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>[
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+]</code></pre>
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>[
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+]</code></pre>
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>[
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+]</code></pre>
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
+#### Responses
 
-`GET /druid/indexer/v1/completeTasks`
+<!--DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-`GET /druid/indexer/v1/runningTasks`
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+#### Sample request
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/pendingTasks`
+#### Sample response
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>[
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+]</code></pre>
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>[
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+]</code></pre>
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+}</code></pre>
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+ 'status': {'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+  'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+  'type': 'query_controller',
+  'createdTime': '2023-06-22T22:11:28.367Z',
+  'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+  'statusCode': 'RUNNING',
+  'status': 'RUNNING',
+  'runnerStatusCode': 'RUNNING',
+  'duration': -1,
+  'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+  'dataSource': 'wikipedia_api',
+  'errorMsg': None}
+}</code></pre>
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+}</code></pre>
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task" \
+--header "Content-Type: application/json" \
+--data "{
+  \"type\" : \"index_parallel\",
+  \"spec\" : {
+    \"dataSchema\" : {
+      \"dataSource\" : \"wikipedia_auto\",
+      \"timestampSpec\": {
+        \"column\": \"time\",
+        \"format\": \"iso\"
+      },
+      \"dimensionsSpec\" : {
+        \"useSchemaDiscovery\": true
+      },
+      \"metricsSpec\" : [],
+      \"granularitySpec\" : {
+        \"type\" : \"uniform\",
+        \"segmentGranularity\" : \"day\",
+        \"queryGranularity\" : \"none\",
+        \"intervals\" : [\"2015-09-12/2015-09-13\"],
+        \"rollup\" : false
+      }
+    },
+    \"ioConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"inputSource\" : {
+        \"type\" : \"local\",
+        \"baseDir\" : \"quickstart/tutorial/\",
+        \"filter\" : \"wikiticker-2015-09-12-sampled.json.gz\"
+      },
+      \"inputFormat\" : {
+        \"type\" : \"json\"
+      },
+      \"appendToExisting\" : false
+    },
+    \"tuningConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"maxRowsPerSegment\" : 5000000,
+      \"maxRowsInMemory\" : 25000
+    }
+  }
+}"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 952
+
+{
+  "type" : "index_parallel",
+  "spec" : {
+    "dataSchema" : {
+      "dataSource" : "wikipedia_auto",
+      "timestampSpec": {
+        "column": "time",
+        "format": "iso"
+      },
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
+      },
+      "metricsSpec" : [],
+      "granularitySpec" : {
+        "type" : "uniform",
+        "segmentGranularity" : "day",
+        "queryGranularity" : "none",
+        "intervals" : ["2015-09-12/2015-09-13"],
+        "rollup" : false
+      }
+    },
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
+      },
+      "inputFormat" : {
+        "type" : "json"
+      },
+      "appendToExisting" : false
+    },
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
+    }
+  }
+}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{
+    "task": "index_parallel_wikipedia_odofhkle_2023-06-23T21:07:28.226Z"
+}</code></pre>
+</details>
+
+### Shut down a task
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/task/{taskId}/shutdown`
+
+Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shutdown successfully.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down task of id `query-52as 8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown HTTP/1.1
+Host: (domain)
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{'task': 'query-577a83dd-a14e-4380-bd01-c942b781236b'}</code></pre>
+</details>
+
+### Shut down all tasks for a datasource
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+
+Shuts down all tasks for a specified datasource. If successful, it returns a JSON object with the name of the datasource whose tasks are shut down.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Error or datasource does not have a running task* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down all tasks for datasource `wikipedia_auto`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{
+    "dataSource": "wikipedia_api"
+}</code></pre>
+</details>
+
+## Task management
+
+### Retrieve status objects for tasks
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/taskStatus`
+
+Retrieve list of task status objects for list of task id strings in request body. It returns a set of JSON objects with the status, duration, location of each task, and any error messages if applicable.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved status objects* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Missing request body or incorrect request body type* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of retrieving status objects for task id `index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z` and `index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z` .
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/taskStatus" \
+--header "Content-Type: application/json" \
+--data "[\"index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z\", \"index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z\"]"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/taskStatus HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 134
+
+["index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z", "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z"]
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Toggle to show sample response</summary>
+  <pre><code>{
+    "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z": {
+        "id": "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z",
+        "status": "SUCCESS",
+        "duration": 10630,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    },
+    "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z": {
+        "id": "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z",
+        "status": "SUCCESS",
+        "duration": 11012,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    }
+}</code></pre>
+</details>
+
+### Clean up pending segments for a data source.

Review Comment:
   ```suggestion
   ### Clean up pending segments for a datasource
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.

Review Comment:
   Let's use all caps for ID



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.

Review Comment:
   If an endpoint doesn't have query parameters, we can remove this section altogether.



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).

Review Comment:
   This is a great addition. Are both of these required to access the endpoint? If so, I would phrase it more directly. For example:
   ```
   To use this endpoint, you must enable the following:
   * Enable the audit log...
   * Enable the cleanup of audit logs...
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.

Review Comment:
   We should refer to it as "state" instead of status to match the query parameter used in the first endpoint. Suggest also removing the parenthetical altogether, or creating a separate follow up sentence for it.



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+  }
+  ```
+
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".

Review Comment:
   ```suggestion
   The following request is an example of submitting a task to create a datasource named `"wikipedia_auto"`.
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+  }
+  ```
+
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task" \
+--header "Content-Type: application/json" \
+--data "{
+  \"type\" : \"index_parallel\",
+  \"spec\" : {
+    \"dataSchema\" : {
+      \"dataSource\" : \"wikipedia_auto\",
+      \"timestampSpec\": {
+        \"column\": \"time\",
+        \"format\": \"iso\"
+      },
+      \"dimensionsSpec\" : {
+        \"useSchemaDiscovery\": true
+      },
+      \"metricsSpec\" : [],
+      \"granularitySpec\" : {
+        \"type\" : \"uniform\",
+        \"segmentGranularity\" : \"day\",
+        \"queryGranularity\" : \"none\",
+        \"intervals\" : [\"2015-09-12/2015-09-13\"],
+        \"rollup\" : false
+      }
+    },
+    \"ioConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"inputSource\" : {
+        \"type\" : \"local\",
+        \"baseDir\" : \"quickstart/tutorial/\",
+        \"filter\" : \"wikiticker-2015-09-12-sampled.json.gz\"
+      },
+      \"inputFormat\" : {
+        \"type\" : \"json\"
+      },
+      \"appendToExisting\" : false
+    },
+    \"tuningConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"maxRowsPerSegment\" : 5000000,
+      \"maxRowsInMemory\" : 25000
+    }
+  }
+}"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 952
+
+{
+  "type" : "index_parallel",
+  "spec" : {
+    "dataSchema" : {
+      "dataSource" : "wikipedia_auto",
+      "timestampSpec": {
+        "column": "time",
+        "format": "iso"
+      },
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
+      },
+      "metricsSpec" : [],
+      "granularitySpec" : {
+        "type" : "uniform",
+        "segmentGranularity" : "day",
+        "queryGranularity" : "none",
+        "intervals" : ["2015-09-12/2015-09-13"],
+        "rollup" : false
+      }
+    },
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
+      },
+      "inputFormat" : {
+        "type" : "json"
+      },
+      "appendToExisting" : false
+    },
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
+    }
+  }
+}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+      "task": "index_parallel_wikipedia_odofhkle_2023-06-23T21:07:28.226Z"
+  }
+  ```
+
+</details>
+
+### Shut down a task
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/task/{taskId}/shutdown`
+
+Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shutdown successfully.

Review Comment:
   ```suggestion
   Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shut down successfully.
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 

Review Comment:
   It could be less wordy to refer to them as "tasks" instead of "task objects"



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 

Review Comment:
   Very handy to say what this endpoint is functionally equivalent to in the previous endpoint 👌 



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+  }
+  ```
+
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task" \
+--header "Content-Type: application/json" \
+--data "{
+  \"type\" : \"index_parallel\",
+  \"spec\" : {
+    \"dataSchema\" : {
+      \"dataSource\" : \"wikipedia_auto\",
+      \"timestampSpec\": {
+        \"column\": \"time\",
+        \"format\": \"iso\"
+      },
+      \"dimensionsSpec\" : {
+        \"useSchemaDiscovery\": true
+      },
+      \"metricsSpec\" : [],
+      \"granularitySpec\" : {
+        \"type\" : \"uniform\",
+        \"segmentGranularity\" : \"day\",
+        \"queryGranularity\" : \"none\",
+        \"intervals\" : [\"2015-09-12/2015-09-13\"],
+        \"rollup\" : false
+      }
+    },
+    \"ioConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"inputSource\" : {
+        \"type\" : \"local\",
+        \"baseDir\" : \"quickstart/tutorial/\",
+        \"filter\" : \"wikiticker-2015-09-12-sampled.json.gz\"
+      },
+      \"inputFormat\" : {
+        \"type\" : \"json\"
+      },
+      \"appendToExisting\" : false
+    },
+    \"tuningConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"maxRowsPerSegment\" : 5000000,
+      \"maxRowsInMemory\" : 25000
+    }
+  }
+}"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 952
+
+{
+  "type" : "index_parallel",
+  "spec" : {
+    "dataSchema" : {
+      "dataSource" : "wikipedia_auto",
+      "timestampSpec": {
+        "column": "time",
+        "format": "iso"
+      },
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
+      },
+      "metricsSpec" : [],
+      "granularitySpec" : {
+        "type" : "uniform",
+        "segmentGranularity" : "day",
+        "queryGranularity" : "none",
+        "intervals" : ["2015-09-12/2015-09-13"],
+        "rollup" : false
+      }
+    },
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
+      },
+      "inputFormat" : {
+        "type" : "json"
+      },
+      "appendToExisting" : false
+    },
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
+    }
+  }
+}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+      "task": "index_parallel_wikipedia_odofhkle_2023-06-23T21:07:28.226Z"
+  }
+  ```
+
+</details>
+
+### Shut down a task
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/task/{taskId}/shutdown`
+
+Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shutdown successfully.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down task of id `query-52as 8aafe-7265-4427-89fe-dc51275cc470`.

Review Comment:
   Prefer active voice when possible
   ```suggestion
   The following request shows how to shut down a task with the ID `query-52as 8aafe-7265-4427-89fe-dc51275cc470`.
   ```



##########
docs/api-reference/tasks-api.md:
##########
@@ -25,77 +25,1448 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.
 
-## Tasks
-
 Note that all _interval_ URL parameters are ISO 8601 strings delimited by a `_` instead of a `/`
 as in `2016-06-27_2016-06-28`.
 
-`GET /druid/indexer/v1/tasks`
+## Task information and retrieval 
+
+### Get an array of tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
+
+This endpoint retrieves an array of all task objects currently running or executed in the current Druid cluster. It provides information about each task such as its task id, task status, associated data source, and other metadata. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+|`state`|String|Filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of tasks* 
+<!--400 BAD REQUEST-->
+<br/>
+*Invalid `state` query parameter value* 
+<!--500 SERVER ERROR-->
+<br/>
+*Invalid query parameter* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following example shows how to retrieve a list of tasks filtered with the following query parameters:
+* State: `complete`
+* Datasource: `wikipedia_api`
+* Time interval: between `2015-09-12` and `2015-09-13`
+* Max entries returned: `10` 
+* Task type: `query_worker`
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12T00%3A00%3A00Z%2F2015-09-13T23%3A59%3A59Z&max=10&type=query_worker HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f-worker0_0",
+        "groupId": "query-fa82fa40-4c8c-4777-b832-cabbee5f519f",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:51:21.302Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 16911,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-5419da7a-b270-492f-90e6-920ecfba766a-worker0_0",
+        "groupId": "query-5419da7a-b270-492f-90e6-920ecfba766a",
+        "type": "query_worker",
+        "createdTime": "2023-06-20T22:45:53.909Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17030,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of complete tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
+
+This endpoint retrieves an array of completed task objects in the current Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of complete tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Request sent to incorrect service* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/completeTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/completeTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad-worker0_0",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_worker",
+        "createdTime": "2023-06-22T22:11:37.012Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 17897,
+        "location": {
+            "host": "localhost",
+            "port": 8101,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "groupId": "query-223549f8-b993-4483-b028-1b0d54713cad",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:11:28.367Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "SUCCESS",
+        "status": "SUCCESS",
+        "runnerStatusCode": "NONE",
+        "duration": 30317,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of running tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
+
+This endpoint retrieves an array of running task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. It supports a set of optional query parameters to filter results. 
+
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of running tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/runningTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/runningTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "type": "query_controller",
+        "createdTime": "2023-06-22T22:54:43.170Z",
+        "queueInsertionTime": "2023-06-22T22:54:43.170Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "RUNNING",
+        "duration": -1,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get an array of waiting tasks
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
+
+This endpoint retrieves an array of waiting task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. It supports a set of optional query parameters to filter results. 
 
-Retrieve list of tasks. Accepts query string parameters `state`, `datasource`, `createdTimeInterval`, `max`, and `type`.
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
 
-|Query Parameter |Description |
-|---|---|
-|`state`|filter list of tasks by task state, valid options are `running`, `complete`, `waiting`, and `pending`.|
-| `datasource`| return tasks filtered by Druid datasource.|
-| `createdTimeInterval`| return tasks created within the specified interval. |
-| `max`| maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
-| `type`| filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+#### Responses
 
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/completeTasks`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of waiting tasks* 
 
-Retrieve list of complete tasks. Equivalent to `/druid/indexer/v1/tasks?state=complete`.
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/runningTasks`
+#### Sample request
 
-Retrieve list of running tasks. Equivalent to `/druid/indexer/v1/tasks?state=running`.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`GET /druid/indexer/v1/waitingTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/waitingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/waitingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Retrieve list of waiting tasks. Equivalent to `/druid/indexer/v1/tasks?state=waiting`.
+#### Sample response
 
-`GET /druid/indexer/v1/pendingTasks`
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "groupId": "index_parallel_wikipedia_auto_biahcbmf_2023-06-26T21:08:05.216Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.217Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "groupId": "index_parallel_wikipedia_auto_afggfiec_2023-06-26T21:08:05.546Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:05.548Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    },
+    {
+        "id": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "groupId": "index_parallel_wikipedia_auto_jmmddihf_2023-06-26T21:08:06.644Z",
+        "type": "index_parallel",
+        "createdTime": "2023-06-26T21:08:06.671Z",
+        "queueInsertionTime": "1970-01-01T00:00:00.000Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "WAITING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_auto",
+        "errorMsg": null
+    }
+  ]
+  ```
 
-Retrieve list of pending tasks. Equivalent to `/druid/indexer/v1/tasks?state=pending`.
+</details>
 
-`GET /druid/indexer/v1/task/{taskId}`
+### Get an array of pending tasks
 
-Retrieve the 'payload' of a task.
+#### URL
 
-`GET /druid/indexer/v1/task/{taskId}/status`
+<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
 
-Retrieve the status of a task.
+This endpoint retrieves an array of pending task objects in the current Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. It supports a set of optional query parameters to filter results. 
 
-`GET /druid/indexer/v1/task/{taskId}/segments`
+#### Query parameters
+|Parameter|Type|Description|
+|---|---|---|
+| `datasource`|String| Return tasks filtered by Druid datasource.|
+| `createdTimeInterval`|String (ISO-8601)| Return tasks created within the specified interval. |
+| `max`|Integer|Maximum number of `"complete"` tasks to return. Only applies when `state` is set to `"complete"`.|
+| `type`|String|Filter tasks by task type. See [task documentation](../ingestion/tasks.md) for more details.|
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved list of pending tasks* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/pendingTasks"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/pendingTasks HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  [
+    {
+        "id": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "groupId": "query-7b37c315-50a0-4b68-aaa8-b1ef1f060e67",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.037Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.037Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    },
+    {
+        "id": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "groupId": "query-544f0c41-f81d-4504-b98b-f9ab8b36ef36",
+        "type": "query_controller",
+        "createdTime": "2023-06-23T19:53:06.616Z",
+        "queueInsertionTime": "2023-06-23T19:53:06.616Z",
+        "statusCode": "RUNNING",
+        "status": "RUNNING",
+        "runnerStatusCode": "PENDING",
+        "duration": -1,
+        "location": {
+            "host": null,
+            "port": -1,
+            "tlsPort": -1
+        },
+        "dataSource": "wikipedia_api",
+        "errorMsg": null
+    }
+  ]
+  ```
+
+</details>
+
+### Get task payload
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}`
+
+Retrieves the payload of a task given the task id. It returns a JSON object with the task id and payload which includes task configuration details and relevant specifications associated with the execution of the task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved payload of task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the task payload of a task with the specified id `query-32663269-ead9-405a-8eb6-0817a952ef47`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-32663269-ead9-405a-8eb6-0817a952ef47 HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "task": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+    "payload": {
+        "type": "query_controller",
+        "id": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "spec": {
+            "query": {
+                "queryType": "scan",
+                "dataSource": {
+                    "type": "external",
+                    "inputSource": {
+                        "type": "http",
+                        "uris": [
+                            "https://druid.apache.org/data/wikipedia.json.gz"
+                        ]
+                    },
+                    "inputFormat": {
+                        "type": "json",
+                        "keepNullColumns": false,
+                        "assumeNewlineDelimited": false,
+                        "useJsonNodeReader": false
+                    },
+                    "signature": [
+                        {
+                            "name": "added",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "channel",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "cityName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "comment",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "commentLength",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "countryIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "countryName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "deleted",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "delta",
+                            "type": "LONG"
+                        },
+                        {
+                            "name": "deltaBucket",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "diffUrl",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "flags",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isAnonymous",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isMinor",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isNew",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isRobot",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "isUnpatrolled",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "metroCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "namespace",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "page",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionIsoCode",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "regionName",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "timestamp",
+                            "type": "STRING"
+                        },
+                        {
+                            "name": "user",
+                            "type": "STRING"
+                        }
+                    ]
+                },
+                "intervals": {
+                    "type": "intervals",
+                    "intervals": [
+                        "-146136543-09-08T08:23:32.096Z/146140482-04-24T15:36:27.903Z"
+                    ]
+                },
+                "virtualColumns": [
+                    {
+                        "type": "expression",
+                        "name": "v0",
+                        "expression": "timestamp_parse(\"timestamp\",null,'UTC')",
+                        "outputType": "LONG"
+                    }
+                ],
+                "resultFormat": "compactedList",
+                "columns": [
+                    "added",
+                    "channel",
+                    "cityName",
+                    "comment",
+                    "commentLength",
+                    "countryIsoCode",
+                    "countryName",
+                    "deleted",
+                    "delta",
+                    "deltaBucket",
+                    "diffUrl",
+                    "flags",
+                    "isAnonymous",
+                    "isMinor",
+                    "isNew",
+                    "isRobot",
+                    "isUnpatrolled",
+                    "metroCode",
+                    "namespace",
+                    "page",
+                    "regionIsoCode",
+                    "regionName",
+                    "timestamp",
+                    "user",
+                    "v0"
+                ],
+                "legacy": false,
+                "context": {
+                    "finalize": true,
+                    "maxNumTasks": 3,
+                    "maxParseExceptions": 0,
+                    "queryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+                    "scanSignature": "[{\"name\":\"added\",\"type\":\"LONG\"},{\"name\":\"channel\",\"type\":\"STRING\"},{\"name\":\"cityName\",\"type\":\"STRING\"},{\"name\":\"comment\",\"type\":\"STRING\"},{\"name\":\"commentLength\",\"type\":\"LONG\"},{\"name\":\"countryIsoCode\",\"type\":\"STRING\"},{\"name\":\"countryName\",\"type\":\"STRING\"},{\"name\":\"deleted\",\"type\":\"LONG\"},{\"name\":\"delta\",\"type\":\"LONG\"},{\"name\":\"deltaBucket\",\"type\":\"STRING\"},{\"name\":\"diffUrl\",\"type\":\"STRING\"},{\"name\":\"flags\",\"type\":\"STRING\"},{\"name\":\"isAnonymous\",\"type\":\"STRING\"},{\"name\":\"isMinor\",\"type\":\"STRING\"},{\"name\":\"isNew\",\"type\":\"STRING\"},{\"name\":\"isRobot\",\"type\":\"STRING\"},{\"name\":\"isUnpatrolled\",\"type\":\"STRING\"},{\"name\":\"metroCode\",\"type\":\"STRING\"},{\"name\":\"namespace\",\"type\":\"STRING\"},{\"name\":\"page\",\"type\":\"STRING\"},{\"name\":\"regionIsoCode\",\"type\":\"STRING\"},{\"name\":\"regionName\",\"type\
 ":\"STRING\"},{\"name\":\"timestamp\",\"type\":\"STRING\"},{\"name\":\"user\",\"type\":\"STRING\"},{\"name\":\"v0\",\"type\":\"LONG\"}]",
+                    "sqlInsertSegmentGranularity": "\"DAY\"",
+                    "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+                },
+                "granularity": {
+                    "type": "all"
+                }
+            },
+            "columnMappings": [
+                {
+                    "queryColumn": "v0",
+                    "outputColumn": "__time"
+                },
+                {
+                    "queryColumn": "added",
+                    "outputColumn": "added"
+                },
+                {
+                    "queryColumn": "channel",
+                    "outputColumn": "channel"
+                },
+                {
+                    "queryColumn": "cityName",
+                    "outputColumn": "cityName"
+                },
+                {
+                    "queryColumn": "comment",
+                    "outputColumn": "comment"
+                },
+                {
+                    "queryColumn": "commentLength",
+                    "outputColumn": "commentLength"
+                },
+                {
+                    "queryColumn": "countryIsoCode",
+                    "outputColumn": "countryIsoCode"
+                },
+                {
+                    "queryColumn": "countryName",
+                    "outputColumn": "countryName"
+                },
+                {
+                    "queryColumn": "deleted",
+                    "outputColumn": "deleted"
+                },
+                {
+                    "queryColumn": "delta",
+                    "outputColumn": "delta"
+                },
+                {
+                    "queryColumn": "deltaBucket",
+                    "outputColumn": "deltaBucket"
+                },
+                {
+                    "queryColumn": "diffUrl",
+                    "outputColumn": "diffUrl"
+                },
+                {
+                    "queryColumn": "flags",
+                    "outputColumn": "flags"
+                },
+                {
+                    "queryColumn": "isAnonymous",
+                    "outputColumn": "isAnonymous"
+                },
+                {
+                    "queryColumn": "isMinor",
+                    "outputColumn": "isMinor"
+                },
+                {
+                    "queryColumn": "isNew",
+                    "outputColumn": "isNew"
+                },
+                {
+                    "queryColumn": "isRobot",
+                    "outputColumn": "isRobot"
+                },
+                {
+                    "queryColumn": "isUnpatrolled",
+                    "outputColumn": "isUnpatrolled"
+                },
+                {
+                    "queryColumn": "metroCode",
+                    "outputColumn": "metroCode"
+                },
+                {
+                    "queryColumn": "namespace",
+                    "outputColumn": "namespace"
+                },
+                {
+                    "queryColumn": "page",
+                    "outputColumn": "page"
+                },
+                {
+                    "queryColumn": "regionIsoCode",
+                    "outputColumn": "regionIsoCode"
+                },
+                {
+                    "queryColumn": "regionName",
+                    "outputColumn": "regionName"
+                },
+                {
+                    "queryColumn": "timestamp",
+                    "outputColumn": "timestamp"
+                },
+                {
+                    "queryColumn": "user",
+                    "outputColumn": "user"
+                }
+            ],
+            "destination": {
+                "type": "dataSource",
+                "dataSource": "wikipedia_api",
+                "segmentGranularity": "DAY"
+            },
+            "assignmentStrategy": "max",
+            "tuningConfig": {
+                "maxNumWorkers": 2,
+                "maxRowsInMemory": 100000,
+                "rowsPerSegment": 3000000
+            }
+        },
+        "sqlQuery": "\nINSERT INTO wikipedia_api \nSELECT \n  TIME_PARSE(\"timestamp\") AS __time,\n  * \nFROM TABLE(EXTERN(\n  '{\"type\": \"http\", \"uris\": [\"https://druid.apache.org/data/wikipedia.json.gz\"]}', \n  '{\"type\": \"json\"}', \n  '[{\"name\": \"added\", \"type\": \"long\"}, {\"name\": \"channel\", \"type\": \"string\"}, {\"name\": \"cityName\", \"type\": \"string\"}, {\"name\": \"comment\", \"type\": \"string\"}, {\"name\": \"commentLength\", \"type\": \"long\"}, {\"name\": \"countryIsoCode\", \"type\": \"string\"}, {\"name\": \"countryName\", \"type\": \"string\"}, {\"name\": \"deleted\", \"type\": \"long\"}, {\"name\": \"delta\", \"type\": \"long\"}, {\"name\": \"deltaBucket\", \"type\": \"string\"}, {\"name\": \"diffUrl\", \"type\": \"string\"}, {\"name\": \"flags\", \"type\": \"string\"}, {\"name\": \"isAnonymous\", \"type\": \"string\"}, {\"name\": \"isMinor\", \"type\": \"string\"}, {\"name\": \"isNew\", \"type\": \"string\"}, {\"name\": \"isRobot\", \"type\
 ": \"string\"}, {\"name\": \"isUnpatrolled\", \"type\": \"string\"}, {\"name\": \"metroCode\", \"type\": \"string\"}, {\"name\": \"namespace\", \"type\": \"string\"}, {\"name\": \"page\", \"type\": \"string\"}, {\"name\": \"regionIsoCode\", \"type\": \"string\"}, {\"name\": \"regionName\", \"type\": \"string\"}, {\"name\": \"timestamp\", \"type\": \"string\"}, {\"name\": \"user\", \"type\": \"string\"}]'\n  ))\nPARTITIONED BY DAY\n",
+        "sqlQueryContext": {
+            "sqlQueryId": "32663269-ead9-405a-8eb6-0817a952ef47",
+            "sqlInsertSegmentGranularity": "\"DAY\"",
+            "maxNumTasks": 3,
+            "queryId": "32663269-ead9-405a-8eb6-0817a952ef47"
+        },
+        "sqlResultsContext": {
+            "timeZone": "UTC",
+            "serializeComplexValues": true,
+            "stringifyArrays": true
+        },
+        "sqlTypeNames": [
+            "TIMESTAMP",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "BIGINT",
+            "BIGINT",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR",
+            "VARCHAR"
+        ],
+        "context": {
+            "forceTimeChunkLock": true,
+            "useLineageBasedSegmentAllocation": true
+        },
+        "groupId": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+        "dataSource": "wikipedia_api",
+        "resource": {
+            "availabilityGroup": "query-32663269-ead9-405a-8eb6-0817a952ef47",
+            "requiredCapacity": 1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Get task status
+
+#### URL
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/status`
+
+Retrieves the status of a task given the task id. It returns a JSON object with the task's current status (`running`, `complete`, `waiting`, `pending`), task type, datasource, and other relevant metadata.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses 
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task status* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the status of a task with the specified id `query-223549f8-b993-4483-b028-1b0d54713cad`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+    'status': {
+      'id': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'groupId': 'query-223549f8-b993-4483-b028-1b0d54713cad',
+      'type': 'query_controller',
+      'createdTime': '2023-06-22T22:11:28.367Z',
+      'queueInsertionTime': '1970-01-01T00:00:00.000Z',
+      'statusCode': 'RUNNING',
+      'status': 'RUNNING',
+      'runnerStatusCode': 'RUNNING',
+      'duration': -1,
+      'location': {'host': 'localhost', 'port': 8100, 'tlsPort': -1},
+      'dataSource': 'wikipedia_api',
+      'errorMsg': None
+    }
+  }
+  ```
+
+</details>
+
+### Get task segments
+
+#### URL
+
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/segments`
 
 > This API is deprecated and will be removed in future releases.
 
-Retrieve information about the segments of a task.
+Retrieves information about segments generated by the task given the task id. To hit this endpoint, make sure to enable the audit log config on the Overlord with `druid.indexer.auditLog.enabled = true`.
+
+In addition to enabling audit log config, enable the cleanup of audit logs on the Coordinator. For reference, see [Audit records](../operations/clean-metadata-store.md#audit-records).
+
+#### Query parameters
 
-`GET /druid/indexer/v1/task/{taskId}/reports`
+No query parameters.
 
-Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. Only works for completed tasks.
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/task`
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task segments* 
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.
+#### Sample request
 
-`POST /druid/indexer/v1/task/{taskId}/shutdown`
+The following examples shows how to retrieve the task segment of the task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
 
-Shuts down a task.
+<!--DOCUSAURUS_CODE_TABS-->
 
-`POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
 
-Shuts down all tasks for a dataSource.
+#### Sample response
 
-`POST /druid/indexer/v1/taskStatus`
+A successful request returns a `200 OK` response and an array of the task segments.
 
-Retrieve list of task status objects for list of task id strings in request body.
+### Get task completion report
 
-`DELETE /druid/indexer/v1/pendingSegments/{dataSource}`
+#### URL
 
-Manually clean up pending segments table in metadata storage for `datasource`. Returns a JSON object response with
+<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+
+Retrieve a [task completion report](../ingestion/tasks.md#task-reports) for a task. It returns a JSON object with information about the number of rows ingested, and any parse exceptions that occurred. It is available for both completed tasks and running tasks.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved task report* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following examples shows how to retrieve the completion report of a task with the specified id `query-52a8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+```
+<!--HTTP-->
+```HTTP
+GET /druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports HTTP/1.1
+Host: {domain}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "ingestionStatsAndErrors": {
+        "type": "ingestionStatsAndErrors",
+        "taskId": "query-52a8aafe-7265-4427-89fe-dc51275cc470",
+        "payload": {
+            "ingestionState": "COMPLETED",
+            "unparseableEvents": {},
+            "rowStats": {
+                "determinePartitions": {
+                    "processed": 0,
+                    "processedBytes": 0,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                },
+                "buildSegments": {
+                    "processed": 39244,
+                    "processedBytes": 17106256,
+                    "processedWithError": 0,
+                    "thrownAway": 0,
+                    "unparseable": 0
+                }
+            },
+            "errorMsg": null,
+            "segmentAvailabilityConfirmed": false,
+            "segmentAvailabilityWaitTimeMs": 0
+        }
+    }
+  }
+  ```
+
+</details>
+
+## Task operations
+
+### Submit a task
+
+#### URL
+
+<code class="postAPI">POST</code> `/druid/indexer/v1/task`
+
+Endpoint for submitting tasks and supervisor specs to the Overlord. It returns the task id of the submitted task.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully submitted task* 
+<!--400 BAD REQUEST-->
+<br/>
+*Missing information in query* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Incorrect request body media type* 
+<!--500 Server Error-->
+<br/>
+*Unexpected token or characters in request body* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of submitting a task to create a datasource named "wikipedia auto".
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/task" \
+--header "Content-Type: application/json" \
+--data "{
+  \"type\" : \"index_parallel\",
+  \"spec\" : {
+    \"dataSchema\" : {
+      \"dataSource\" : \"wikipedia_auto\",
+      \"timestampSpec\": {
+        \"column\": \"time\",
+        \"format\": \"iso\"
+      },
+      \"dimensionsSpec\" : {
+        \"useSchemaDiscovery\": true
+      },
+      \"metricsSpec\" : [],
+      \"granularitySpec\" : {
+        \"type\" : \"uniform\",
+        \"segmentGranularity\" : \"day\",
+        \"queryGranularity\" : \"none\",
+        \"intervals\" : [\"2015-09-12/2015-09-13\"],
+        \"rollup\" : false
+      }
+    },
+    \"ioConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"inputSource\" : {
+        \"type\" : \"local\",
+        \"baseDir\" : \"quickstart/tutorial/\",
+        \"filter\" : \"wikiticker-2015-09-12-sampled.json.gz\"
+      },
+      \"inputFormat\" : {
+        \"type\" : \"json\"
+      },
+      \"appendToExisting\" : false
+    },
+    \"tuningConfig\" : {
+      \"type\" : \"index_parallel\",
+      \"maxRowsPerSegment\" : 5000000,
+      \"maxRowsInMemory\" : 25000
+    }
+  }
+}"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 952
+
+{
+  "type" : "index_parallel",
+  "spec" : {
+    "dataSchema" : {
+      "dataSource" : "wikipedia_auto",
+      "timestampSpec": {
+        "column": "time",
+        "format": "iso"
+      },
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
+      },
+      "metricsSpec" : [],
+      "granularitySpec" : {
+        "type" : "uniform",
+        "segmentGranularity" : "day",
+        "queryGranularity" : "none",
+        "intervals" : ["2015-09-12/2015-09-13"],
+        "rollup" : false
+      }
+    },
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
+      },
+      "inputFormat" : {
+        "type" : "json"
+      },
+      "appendToExisting" : false
+    },
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
+    }
+  }
+}
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+      "task": "index_parallel_wikipedia_odofhkle_2023-06-23T21:07:28.226Z"
+  }
+  ```
+
+</details>
+
+### Shut down a task
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/task/{taskId}/shutdown`
+
+Shuts down a task if it not already complete. Returns a JSON object with the id of the task that was shutdown successfully.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down task* 
+<!--404 NOT FOUND-->
+<br/>
+*Cannot find task with id* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down task of id `query-52as 8aafe-7265-4427-89fe-dc51275cc470`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown HTTP/1.1
+Host: (domain)
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+
+  ```json
+  {
+    'task': 'query-577a83dd-a14e-4380-bd01-c942b781236b'
+  }
+  ```
+
+</details>
+
+### Shut down all tasks for a datasource
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks`
+
+Shuts down all tasks for a specified datasource. If successful, it returns a JSON object with the name of the datasource whose tasks are shut down.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully shut down tasks* 
+<!--404 NOT FOUND-->
+<br/>
+*Error or datasource does not have a running task* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of shutting down all tasks for datasource `wikipedia_auto`.
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl --request POST "{domain}/druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks HTTP/1.1
+Host: {domain}
+```
+
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "dataSource": "wikipedia_api"
+  }
+  ```
+
+</details>
+
+## Task management
+
+### Retrieve status objects for tasks
+
+#### URL
+<code class="postAPI">POST</code> `/druid/indexer/v1/taskStatus`
+
+Retrieve list of task status objects for list of task id strings in request body. It returns a set of JSON objects with the status, duration, location of each task, and any error messages if applicable.
+
+#### Query parameters
+
+No query parameters.
+
+#### Responses
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--200 SUCCESS-->
+<br/>
+*Successfully retrieved status objects* 
+<!--415 UNSUPPORTED MEDIA TYPE-->
+<br/>
+*Missing request body or incorrect request body type* 
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+#### Sample request
+
+The following request is an example of retrieving status objects for task id `index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z` and `index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z` .
+
+<!--DOCUSAURUS_CODE_TABS-->
+
+<!--cURL-->
+```shell
+curl "{domain}/druid/indexer/v1/taskStatus" \
+--header "Content-Type: application/json" \
+--data "[\"index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z\", \"index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z\"]"
+```
+<!--HTTP-->
+```HTTP
+POST /druid/indexer/v1/taskStatus HTTP/1.1
+Host: {domain}
+Content-Type: application/json
+Content-Length: 134
+
+["index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z", "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z"]
+```
+<!--END_DOCUSAURUS_CODE_TABS-->
+
+
+#### Sample response
+<details>
+  <summary>Click to show sample response</summary>
+  
+  ```json
+  {
+    "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z": {
+        "id": "index_parallel_wikipedia_auto_jbgiianh_2023-06-26T23:17:56.769Z",
+        "status": "SUCCESS",
+        "duration": 10630,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    },
+    "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z": {
+        "id": "index_parallel_wikipedia_auto_jndhkpbo_2023-06-26T17:23:05.308Z",
+        "status": "SUCCESS",
+        "duration": 11012,
+        "errorMsg": null,
+        "location": {
+            "host": "localhost",
+            "port": 8100,
+            "tlsPort": -1
+        }
+    }
+  }
+  ```
+
+</details>
+
+### Clean up pending segments for a data source.
+
+#### URL
+
+<code class="deleteAPI">DELETE</code> `/druid/indexer/v1/pendingSegments/{dataSource}`
+
+Manually clean up pending segments table in metadata storage for `datasource`. It returns a JSON object response with
 `numDeleted` and count of rows deleted from the pending segments table. This API is used by the

Review Comment:
   ```suggestion
   `numDeleted` for the number of rows deleted from the pending segments table. This API is used by the
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@druid.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@druid.apache.org
For additional commands, e-mail: commits-help@druid.apache.org