From a2c55f3831ebdf07948016d8fe7d14dd1f228a0a Mon Sep 17 00:00:00 2001
From: demo-kratia <56242907+demo-kratia@users.noreply.github.com>
Date: Thu, 20 Jul 2023 14:25:22 -0700
Subject: [PATCH 1/4] doc2 update

---
 docs/api-reference/tasks-api.md | 363 +++++++++++++++++++++++---------
 1 file changed, 258 insertions(+), 105 deletions(-)

diff --git a/docs/api-reference/tasks-api.md b/docs/api-reference/tasks-api.md
index 1d745abfd29e..b7bf23538119 100644
--- a/docs/api-reference/tasks-api.md
+++ b/docs/api-reference/tasks-api.md
@@ -25,16 +25,17 @@ sidebar_label: Tasks
 
 This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid. Tasks are individual jobs performed by Druid to complete operations such as ingestion, querying, and compaction.  
 
-In this document, `http://<SERVICE_IP>:<SERVICE_PORT>` is a placeholder for the server address of deployment and the service port. For example, on the quickstart configuration, replace `http://<ROUTER_IP>:<ROUTER_PORT>` with `http://localhost:8888`.
+In this topic, `http://ROUTER_IP:ROUTER_PORT` is a placeholder for the Router service address and port. For example, on the quickstart configuration, use `http://localhost:8888`.
 
 ## Task information and retrieval 
 
 ### Get an array of tasks
 
+Retrieves an array of all tasks in the Druid cluster. Each task object includes information on its ID, status, associated datasource, and other metadata. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+
 #### URL
-<code class="getAPI">GET</code> `/druid/indexer/v1/tasks`
 
-Retrieves an array of all tasks in the Druid cluster. Each task object includes information on its ID, status, associated datasource, and other metadata. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/tasks</code>
 
 #### Query parameters
 
@@ -53,14 +54,23 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--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-->
 
 ---
@@ -77,13 +87,16 @@ The following example shows how to retrieve a list of tasks filtered with the fo
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12_2015-09-13&max=10&type=query_worker"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12_2015-09-13&max=10&type=query_worker"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/tasks/?state=complete&datasource=wikipedia_api&createdTimeInterval=2015-09-12_2015-09-13&max=10&type=query_worker HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -156,10 +169,11 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get an array of complete tasks
 
+Retrieves an array of completed tasks in the Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+
 #### URL
-<code class="getAPI">GET</code> `/druid/indexer/v1/completeTasks`
 
-Retrieves an array of completed tasks in the Druid cluster. This is functionally equivalent to `/druid/indexer/v1/tasks?state=complete`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/completeTasks</code>
 
 #### Query parameters
 
@@ -177,11 +191,17 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--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-->
 
 ---
@@ -191,14 +211,18 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/completeTasks"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/completeTasks"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/completeTasks HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
@@ -251,10 +275,11 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get an array of running tasks
 
+Retrieves an array of running task objects in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+
 #### URL
-<code class="getAPI">GET</code> `/druid/indexer/v1/runningTasks`
 
-Retrieves an array of running task objects in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=running`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/runningTasks</code>
 
 #### Query parameters
 
@@ -272,7 +297,9 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved list of running tasks* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -284,14 +311,18 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/runningTasks"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/runningTasks"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/runningTasks HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 
@@ -327,10 +358,11 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get an array of waiting tasks
 
+Retrieves an array of waiting tasks in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+
 #### URL
-<code class="getAPI">GET</code> `/druid/indexer/v1/waitingTasks`
 
-Retrieves an array of waiting tasks in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=waiting`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/waitingTasks</code>
 
 #### Query parameters
 
@@ -348,7 +380,9 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved list of waiting tasks* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -360,14 +394,18 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/waitingTasks"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/waitingTasks"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/waitingTasks HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
@@ -438,11 +476,11 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get an array of pending tasks
 
-#### URL
+Retrieves an array of pending tasks in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
 
-<code class="getAPI">GET</code> `/druid/indexer/v1/pendingTasks`
+#### URL
 
-Retrieves an array of pending tasks in the Druid cluster. It is functionally equivalent to `/druid/indexer/v1/tasks?state=pending`. For definitions of the response properties, see the [Tasks table](../querying/sql-metadata-tables.md#tasks-table).
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/pendingTasks</code>
 
 #### Query parameters
 
@@ -460,8 +498,11 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved list of pending tasks* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -471,14 +512,18 @@ The endpoint supports a set of optional query parameters to filter results.
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/pendingTasks"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/pendingTasks"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/pendingTasks HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
@@ -531,19 +576,26 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get task payload
 
+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.
+
 #### 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 that includes task configuration details and relevant specifications associated with the execution of the task.
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/task/:taskId</code>
 
 #### 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-->
@@ -557,14 +609,18 @@ The following examples shows how to retrieve the task payload of a task with the
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/index_parallel_wikipedia_short_iajoonnd_2023-07-07T17:53:12.174Z"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/task/index_parallel_wikipedia_short_iajoonnd_2023-07-07T17:53:12.174Z"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/task/index_parallel_wikipedia_short_iajoonnd_2023-07-07T17:53:12.174Z HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 
@@ -727,20 +783,28 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get task status
 
+Retrieves the status of a task given the task ID. It returns a JSON object with the task's status code, runner status, task type, datasource, and other relevant metadata.
+
 #### 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 status code, runner status, task type, datasource, and other relevant metadata.
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/task/:taskId/status</code>
 
 #### Responses 
+
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved task status* 
+
 <!--404 NOT FOUND-->
+
 <br/>
+
 *Cannot find task with ID* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -752,18 +816,23 @@ The following examples shows how to retrieve the status of a task with the speci
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/query-223549f8-b993-4483-b028-1b0d54713cad/status"
+curl "http://ROUTER_IP:ROUTER_PORT/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: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
 
@@ -791,22 +860,26 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### 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.
 
 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 logs, configure a cleanup strategy to prevent overloading the metadata store with old audit logs which may cause performance issues. To enable automated cleanup of audit logs on the Coordinator, set `druid.coordinator.kill.audit.on`. You may also manually export the audit logs to external storage. For more information, see [Audit records](../operations/clean-metadata-store.md#audit-records).
 
+#### URL
+
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/task/:taskId/segments</code>
+
 #### Responses
+
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved task segments* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -818,14 +891,18 @@ The following examples shows how to retrieve the task segment of the task with t
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+curl "http://ROUTER_IP:ROUTER_PORT/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: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
@@ -834,15 +911,16 @@ A successful request returns a `200 OK` response and an array of the task segmen
 
 ### Get task log
 
-#### URL
-
-<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/log`
-
 Retrieves the event log associated with a task. It returns a list of logged events during the lifecycle of the task. The endpoint is useful for providing information about the execution of the task, including any errors or warnings raised. 
 
 Task logs are automatically retrieved from the Middle Manager/Indexer or in long-term storage. For reference, see [Task logs](../ingestion/tasks.md#task-logs).
 
+#### URL
+
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/task/:taskId/log</code>
+
 #### Query parameters
+
 * `offset` (optional)
     * Type: Int
     * Exclude the first passed in number of entries from the response.
@@ -852,8 +930,11 @@ Task logs are automatically retrieved from the Middle Manager/Indexer or in long
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved task log* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -865,14 +946,18 @@ The following examples shows how to retrieve the task log of a task with the spe
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/index_kafka_social_media_0e905aa31037879_nommnaeg/log"
+curl "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/task/index_kafka_social_media_0e905aa31037879_nommnaeg/log"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 GET /druid/indexer/v1/task/index_kafka_social_media_0e905aa31037879_nommnaeg/log HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
@@ -946,19 +1031,22 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Get task completion report
 
-#### URL
+Retrieves 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 Druid raised.
 
-<code class="getAPI">GET</code> `/druid/indexer/v1/task/{taskId}/reports`
+#### URL
 
-Retrieves 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 Druid raised.
+<code class="getAPI">GET</code> <code>/druid/indexer/v1/task/:taskId/reports</code>
 
 #### Responses
 
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully retrieved task report* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -970,17 +1058,22 @@ The following examples shows how to retrieve the completion report of a task wit
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/query-52a8aafe-7265-4427-89fe-dc51275cc470/reports"
+curl "http://ROUTER_IP:ROUTER_PORT/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: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
   
@@ -1022,29 +1115,42 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Submit a task
 
-#### URL
-
-<code class="postAPI">POST</code> `/druid/indexer/v1/task`
-
 Submits a JSON-based ingestion spec or supervisor spec to the Overlord. It returns the task ID of the submitted task. For information on creating an ingestion spec, refer to the [ingestion spec reference](../ingestion/ingestion-spec.md).
 
 Note that for most batch ingestion use cases, you should use the [SQL-ingestion API](./sql-ingestion-api.md) instead of JSON-based batch ingestion.
 
+#### URL
+
+<code class="postAPI">POST</code> <code>/druid/indexer/v1/task</code>
+
 #### 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-->
 
 ---
@@ -1056,54 +1162,57 @@ The following request is an example of submitting a task to create a datasource
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task" \
---header "Content-Type: application/json" \
---data "{
-  \"type\" : \"index_parallel\",
-  \"spec\" : {
-    \"dataSchema\" : {
-      \"dataSource\" : \"wikipedia_auto\",
-      \"timestampSpec\": {
-        \"column\": \"time\",
-        \"format\": \"iso\"
+curl "http://ROUTER_IP:ROUTER_PORT/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
+      "dimensionsSpec" : {
+        "useSchemaDiscovery": true
       },
-      \"metricsSpec\" : [],
-      \"granularitySpec\" : {
-        \"type\" : \"uniform\",
-        \"segmentGranularity\" : \"day\",
-        \"queryGranularity\" : \"none\",
-        \"intervals\" : [\"2015-09-12/2015-09-13\"],
-        \"rollup\" : false
+      "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\"
+    "ioConfig" : {
+      "type" : "index_parallel",
+      "inputSource" : {
+        "type" : "local",
+        "baseDir" : "quickstart/tutorial/",
+        "filter" : "wikiticker-2015-09-12-sampled.json.gz"
       },
-      \"inputFormat\" : {
-        \"type\" : \"json\"
+      "inputFormat" : {
+        "type" : "json"
       },
-      \"appendToExisting\" : false
+      "appendToExisting" : false
     },
-    \"tuningConfig\" : {
-      \"type\" : \"index_parallel\",
-      \"maxRowsPerSegment\" : 5000000,
-      \"maxRowsInMemory\" : 25000
+    "tuningConfig" : {
+      "type" : "index_parallel",
+      "maxRowsPerSegment" : 5000000,
+      "maxRowsInMemory" : 25000
     }
   }
-}"
+}'
+
 ```
 <!--HTTP-->
+
 ```HTTP
 POST /druid/indexer/v1/task HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 Content-Type: application/json
 Content-Length: 952
 
@@ -1148,9 +1257,11 @@ Content-Length: 952
   }
 }
 ```
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
 
@@ -1164,20 +1275,28 @@ Content-Length: 952
 
 ### Shut down a task
 
+Shuts down a task if it not already complete. Returns a JSON object with the ID of the task that was shut down successfully.
+
 #### 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 shut down successfully.
+<code class="postAPI">POST</code> <code>/druid/indexer/v1/task/:taskId/shutdown</code>
 
 #### Responses
+
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully shut down task* 
+
 <!--404 NOT FOUND-->
+
 <br/>
+
 *Cannot find task with ID or task is no longer running* 
+
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 ---
@@ -1189,18 +1308,22 @@ The following request shows how to shut down a task with the ID `query-52as 8aaf
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl --request POST "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/task/query-52as 8aafe-7265-4427-89fe-dc51275cc470/shutdown"
+curl --request POST "http://ROUTER_IP:ROUTER_PORT/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: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
 
@@ -1214,21 +1337,28 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Shut down all tasks for a datasource
 
+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.
+
 #### 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.
+<code class="postAPI">POST</code> <code>/druid/indexer/v1/datasources/:datasource/shutdownAllTasks</code>
 
 #### 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-->
 
 ---
@@ -1240,18 +1370,22 @@ The following request is an example of shutting down all tasks for datasource `w
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl --request POST "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks"
+curl --request POST "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 POST /druid/indexer/v1/datasources/wikipedia_auto/shutdownAllTasks HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
   
@@ -1267,21 +1401,28 @@ Host: http://<ROUTER_IP>:<ROUTER_PORT>
 
 ### Retrieve status objects for tasks
 
+Retrieves 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.
+
 #### URL
-<code class="postAPI">POST</code> `/druid/indexer/v1/taskStatus`
 
-Retrieves 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.
+<code class="postAPI">POST</code> <code>/druid/indexer/v1/taskStatus</code>
 
 #### 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-->
 
 ---
@@ -1293,24 +1434,29 @@ The following request is an example of retrieving status objects for task ID `in
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl "http://<ROUTER_IP>:<ROUTER_PORT>/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\"]"
+curl "http://ROUTER_IP:ROUTER_PORT/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: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 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>
   
@@ -1345,20 +1491,23 @@ Content-Length: 134
 
 ### Clean up pending segments for a datasource
 
-#### 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` for the number 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)
 which automates this operation to perform periodically.
 
+#### URL
+
+<code class="deleteAPI">DELETE</code> <code>/druid/indexer/v1/pendingSegments/:datasource</code>
+
 #### Responses
+
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--200 SUCCESS-->
+
 <br/>
+
 *Successfully deleted pending segments* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1372,18 +1521,22 @@ The following request is an example of cleaning up pending segments for the `wik
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--cURL-->
+
 ```shell
-curl --request DELETE "http://<ROUTER_IP>:<ROUTER_PORT>/druid/indexer/v1/pendingSegments/wikipedia_api"
+curl --request DELETE "http://ROUTER_IP:ROUTER_PORT/druid/indexer/v1/pendingSegments/wikipedia_api"
 ```
+
 <!--HTTP-->
+
 ```HTTP
 DELETE /druid/indexer/v1/pendingSegments/wikipedia_api HTTP/1.1
-Host: http://<ROUTER_IP>:<ROUTER_PORT>
+Host: http://ROUTER_IP:ROUTER_PORT
 ```
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
 #### Sample response
+
 <details>
   <summary>Click to show sample response</summary>
   

From 31c052d37a42477fa6f41de49593fc569b0179c7 Mon Sep 17 00:00:00 2001
From: demo-kratia <56242907+demo-kratia@users.noreply.github.com>
Date: Fri, 21 Jul 2023 09:18:21 -0700
Subject: [PATCH 2/4] Update spellcheck exception

---
 website/.spelling | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/website/.spelling b/website/.spelling
index 984a658bca1a..82421ca318bd 100644
--- a/website/.spelling
+++ b/website/.spelling
@@ -2289,3 +2289,8 @@ prometheus-emitter
 kubernetes-overlord-extensions
 UCS
 ISO646-US
+completeTasks
+runningTasks
+waitingTasks
+pendingTasks
+shutdownAllTasks
\ No newline at end of file

From 87e17eae7966e8bdbcc51973be683e086b8a5a5e Mon Sep 17 00:00:00 2001
From: demo-kratia <56242907+demo-kratia@users.noreply.github.com>
Date: Thu, 27 Jul 2023 11:25:09 -0700
Subject: [PATCH 3/4] remove <br> tags

---
 docs/api-reference/tasks-api.md | 52 ---------------------------------
 1 file changed, 52 deletions(-)

diff --git a/docs/api-reference/tasks-api.md b/docs/api-reference/tasks-api.md
index b7bf23538119..4f7261a5b842 100644
--- a/docs/api-reference/tasks-api.md
+++ b/docs/api-reference/tasks-api.md
@@ -55,20 +55,14 @@ The endpoint supports a set of optional query parameters to filter results.
 
 <!--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-->
@@ -192,14 +186,10 @@ The endpoint supports a set of optional query parameters to filter results.
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved list of complete tasks* 
 
 <!--404 NOT FOUND-->
 
-<br/>
-
 *Request sent to incorrect service* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -298,8 +288,6 @@ The endpoint supports a set of optional query parameters to filter results.
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved list of running tasks* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -381,8 +369,6 @@ The endpoint supports a set of optional query parameters to filter results.
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved list of waiting tasks* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -499,8 +485,6 @@ The endpoint supports a set of optional query parameters to filter results.
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved list of pending tasks* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -588,14 +572,10 @@ Retrieves the payload of a task given the task ID. It returns a JSON object with
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved payload of task* 
 
 <!--404 NOT FOUND-->
 
-<br/>
-
 *Cannot find task with ID* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -795,14 +775,10 @@ Retrieves the status of a task given the task ID. It returns a JSON object with
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved task status* 
 
 <!--404 NOT FOUND-->
 
-<br/>
-
 *Cannot find task with ID* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -876,8 +852,6 @@ In addition to enabling audit logs, configure a cleanup strategy to prevent over
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved task segments* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -931,8 +905,6 @@ Task logs are automatically retrieved from the Middle Manager/Indexer or in long
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved task log* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1043,8 +1015,6 @@ Retrieves a [task completion report](../ingestion/tasks.md#task-reports) for a t
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved task report* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1129,26 +1099,18 @@ Note that for most batch ingestion use cases, you should use the [SQL-ingestion
 
 <!--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-->
@@ -1287,14 +1249,10 @@ Shuts down a task if it not already complete. Returns a JSON object with the ID
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully shut down task* 
 
 <!--404 NOT FOUND-->
 
-<br/>
-
 *Cannot find task with ID or task is no longer running* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1349,14 +1307,10 @@ Shuts down all tasks for a specified datasource. If successful, it returns a JSO
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully shut down tasks* 
 
 <!--404 NOT FOUND-->
 
-<br/>
-
 *Error or datasource does not have a running task* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1413,14 +1367,10 @@ Retrieves list of task status objects for list of task ID strings in request bod
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully retrieved status objects* 
 
 <!--415 UNSUPPORTED MEDIA TYPE-->
 
-<br/>
-
 *Missing request body or incorrect request body type* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->
@@ -1506,8 +1456,6 @@ which automates this operation to perform periodically.
 
 <!--200 SUCCESS-->
 
-<br/>
-
 *Successfully deleted pending segments* 
 
 <!--END_DOCUSAURUS_CODE_TABS-->

From 79e364db8b9ebb1f7117cb4ec986c937e842e77a Mon Sep 17 00:00:00 2001
From: demo-kratia <56242907+demo-kratia@users.noreply.github.com>
Date: Thu, 27 Jul 2023 13:14:14 -0700
Subject: [PATCH 4/4] merge conflict in spelling

---
 website/.spelling | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/.spelling b/website/.spelling
index 52e35caff428..775c056dcf0b 100644
--- a/website/.spelling
+++ b/website/.spelling
@@ -2300,5 +2300,5 @@ suspendAll
 resumeAll
 terminateAll
 selfDiscovered
-isLeader
 loadstatus
+isLeader