@grepr/cli 1.11.5-a7cb911 → 1.11.5-b97c32b

package/build/dist/docs-index/{630dae50-763a-4fa9-b501-4e7a90310faa.txt → 00290b80-5bef-42bb-b54b-29dfe8e18188.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `getVendorEstimationRunResults`
 **Summary**: Get vendor estimation results for a run
-Returns the run's per-exception estimates keyed by composite exception id. Each entry is one of four variants selected by its type field, because an estimate can be pending, unparseable or failed as well as counted. An exception missing from the response was not in this run, which is not the same as matching nothing.
+Returns the run's per-exception estimates keyed by composite exception id. Each is counted, pending, unparseable or an error, selected by its type field. An exception missing from the response was not in this run.
 
 ## Tags
 - Integration Exceptions

package/build/dist/docs-index/07fb8952-bb7f-441a-a4b9-1684ed334f58.txt

@@ -0,0 +1,19 @@
+# PromotionPolicy
+
+**Type**: `object`
+
+## Properties
+
+- name: attributes (required)
+  type: `PromotionPolicyAttributes`
+
+- name: revision (optional)
+  type: integer
+  description: Which store of the table's policy this is, assigned by the server: 0 when the table has none. Echo it on a PUT to be refused with 409 if the policy changed since it was read; omit it to replace whatever is stored.
+
+- name: tags (required)
+  type: `PromotionPolicyTags`
+
+- name: v (required)
+  type: integer
+  description: Promotion policy document version.

package/build/dist/docs-index/{8301f89a-2e14-4a07-af7e-1dfc1191e3e6.txt → 0a242d89-add9-4242-81a2-95b13061c8b0.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `listVendorEstimationRuns`
 **Summary**: List vendor estimation runs for an integration
-Returns the integration's estimation runs newest first, including failed and stopped ones. Scope and window identify a run: numbers from runs over different scopes or windows are not comparable.
+Returns the integration's estimation runs newest first, in every state.
 
 ## Tags
 - Integration Exceptions
@@ -14,7 +14,7 @@ Returns the integration's estimation runs newest first, including failed and sto
   - Integration id
   - Type: string
 - **limit** (optional) - query
-  - Maximum runs to return
+  - Maximum runs to return, 1 to 100
   - Type: integer
 
 ## Responses
@@ -24,6 +24,10 @@ Returns the integration's estimation runs newest first, including failed and sto
 Runs retrieved
 
 - **Content-Type**: `application/json` / array of `VendorEstimationRun`
+### 400
+
+Bad Request - Limit is outside 1 to 100.
+
 ### 401
 
 Unauthorized

package/build/dist/docs-index/{80e19bc5-8101-4313-a374-82992dddaefe.txt → 0a7b6874-8b32-4191-b126-8d835097e490.txt}

@@ -4,8 +4,6 @@
 
 **Operation ID**: `list_3`
 **Summary**: List skills
-## Tags
-- Skills
 ## Parameters
 
 - **query** (optional) - query

package/build/dist/docs-index/{e08cbb04-7efe-441d-831e-efe30ee4e05e.txt → 0c074c04-f780-4928-9e9e-2457cdbd1a34.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `getVendorEstimationRun`
 **Summary**: Get a vendor estimation run
-Returns the run's current state and progress. Poll this while the run is non-terminal; results land incrementally and are readable throughout.
+Returns the run's state and progress. Results are readable while it runs.
 
 ## Tags
 - Integration Exceptions

package/build/dist/docs-index/{95d6d604-bd71-42b3-a719-aee71fdcaa4c.txt → 0df88634-f741-4ac1-8d27-6abdf2e68738.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `subscriptions`
 **Summary**: List an agent's subscriptions
-Returns the pipeline ids the agent is subscribed to.
+Returns the agent's pipeline subscriptions, including when each was paused.
 
 ## Tags
 - Agents
@@ -19,7 +19,7 @@ Returns the pipeline ids the agent is subscribed to.
 
 Subscriptions retrieved successfully
 
-- **Content-Type**: `application/json` / array of string
+- **Content-Type**: `application/json` / array of `AgentPipelineSubscription`
 ### 401
 
 Unauthorized

package/build/dist/docs-index/{8f823857-1336-498f-b61b-3d82b16beee5.txt → 0f58f6cd-bede-4972-84f3-db9faf2d3e35.txt}

@@ -1,10 +1,10 @@
 # Stop a vendor estimation run
 
-**DELETE** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}`
+**POST** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/stop`
 
 **Operation ID**: `stopVendorEstimationRun`
 **Summary**: Stop a vendor estimation run
-Stops the run and keeps every count it has already made. The run ends partial, with a stop reason recording that a person stopped it. No rows are deleted; calling this on a run that has already finished is a no-op.
+Stops the run and keeps every count it has made. A stopped run can be resumed or deleted. A no-op on a run that is not in progress.
 
 ## Tags
 - Integration Exceptions

package/build/dist/docs-index/1206c19d-6eb3-4c60-99e7-37a3d6f369f0.txt

@@ -0,0 +1,18 @@
+# ExceptionUsageResponse
+
+Usage the vendor reports for an integration's parsed queries
+
+**Type**: `object`
+
+## Properties
+
+- name: reportedTypes (required)
+  type: array of string
+  description: The parsed query exception types (values of a parsed query's exceptionType) the vendor reports usage for. Empty when the vendor reports none; a query of any other type has no usage to show.
+
+- name: status (required)
+  type: `UsageStatus`
+
+- name: usage (required)
+  type: object
+  description: Usage keyed by composite exception id (integrationId:vendorResourceId:exceptionType), the key the impacts endpoint uses. A query the vendor reported nothing for is absent, which is not the same as never viewed.

package/build/dist/docs-index/{61a3fb16-1562-401e-8983-bb0a355ae035.txt → 136c5714-25dc-42d7-bfc4-d42e13d19168.txt}

@@ -4,8 +4,6 @@
 
 **Operation ID**: `archive`
 **Summary**: Archive an organization skill
-## Tags
-- Skills
 ## Parameters
 
 - **id** (required) - path

package/build/dist/docs-index/{d77ebd2e-a7d9-4408-a221-65af02780654.txt → 152b94df-8f83-43f0-8a0d-7ba78d3c2e15.txt}

@@ -10,7 +10,7 @@
 
 - name: windowEnd (required)
   type: string
-  description: Absolute end of the window to count over; must be after the start
+  description: Absolute end of the window to count over; must be after the start and not in the future
 
 - name: windowStart (required)
   type: string

package/build/dist/docs-index/19f3545a-2f34-4174-b723-d0a4b85afc4c.txt

@@ -0,0 +1,40 @@
+# Pause or resume an agent's pipeline subscription
+
+**PUT** `/v1/agents/{id}/pipelines/{jobId}/state`
+
+**Operation ID**: `setPipelineState`
+**Summary**: Pause or resume an agent's pipeline subscription
+Sets one subscription to PAUSED or ACTIVE. While paused, new signals from the pipeline are dropped for this agent, and the pipeline keeps marking new patterns as sent. Investigations already queued still run. The running pipeline is not restarted.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+- **jobId** (required) - path
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `StateChangeRequest`
+
+## Responses
+
+### 204
+
+State set (or already set)
+
+### 400
+
+The state is not ACTIVE or PAUSED
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent not found, or not subscribed to the pipeline

package/build/dist/docs-index/20f6c1b9-74a9-4604-a792-53eb68693059.txt

@@ -0,0 +1,11 @@
+# PromotionPolicyAttributeExclude
+
+**Type**: `object`
+
+## Properties
+
+- name: path (required)
+  type: string
+
+- name: prefix (optional)
+  type: boolean

package/build/dist/docs-index/23cb153e-fa0a-46f3-968b-6738a4bdbc94.txt

@@ -0,0 +1,102 @@
+Learn how Grepr indexes log attributes and tags as columns in the data lake, and the rules that decide which fields each dataset indexes.
+
+# Indexed columns
+
+Grepr stores each raw log's attributes as one JSON document and its tags as a map. A search that filters on one attribute reads every log's whole attribute document to find a match.
+
+An *indexed column* removes that cost for one field. Grepr writes the field into its own column in the dataset's data lake table, so a search that filters on the field reads that column and skips the files that can't contain a match. See [The Grepr data lake](/grepr-platform/data-lake).
+
+Searches don't change. The same search returns the same results whether or not a field is indexed, and runs faster when it is.
+
+## What Grepr indexes
+
+Each dataset's raw log table has indexing settings for two groups of fields:
+
+* Attributes, named by their dotted path, such as `http.method` or `kube.pod.name`. An indexed path has a column for its value, and a path that holds numbers can also have a numeric column, so that range filters skip files too.
+* Tags, named by their key, such as `region` or `pod_name`. An indexed tag key has a column for its value.
+
+Grepr always indexes the `service` and `host` tags, whatever the settings say.
+
+For each group, you choose whether Grepr discovers new fields, which fields it always indexes, and which fields it never indexes.
+
+## Discovery \[#discovery]
+
+When discovery is on, Grepr adds a column for a new field it finds in your logs, until the group has as many columns as its *discovery cap*. Your organization sets the largest cap you can choose. The tag cap doesn't count `service` and `host`.
+
+Discovery is off for a new dataset, so until you turn it on, Grepr indexes only `service`, `host`, and the fields on the always-index lists.
+
+When discovery is on and Grepr finds a number at an indexed path, the path also gets a numeric column. A numeric column doesn't count toward the cap.
+
+Turning discovery off stops Grepr from adding columns. Columns the table already has keep being written. To stop writing a column, add the field to the never-index list.
+
+## Always index and never index \[#lists]
+
+Grepr indexes a field on an always-index list whether discovery is on or off, and whether or not the group has reached its cap. Grepr stops writing a field on a never-index list.
+
+For attribute paths:
+
+* A path matches exactly and is case-sensitive. Write the path as it appears in the log.
+* An entry that includes nested paths covers the path and every path under it, split at dots. For example, `kube` with nested paths covers `kube` and `kube.pod.name`, but not `kubernetes`. Wildcards aren't supported.
+* An always-index entry marked numeric gets its numeric column the next time a pipeline writes the path, whether or not discovery is on. Use it for values that are numbers written as strings.
+* When a path is on both lists, always index wins. To stop indexing a subtree except for one path, add the subtree to the never-index list with nested paths, and add the one path to the always-index list.
+
+For tag keys:
+
+* A key matches exactly.
+* A key can't be on both lists.
+* `service`, `host`, and any key the table is partitioned on can't be on the never-index list.
+* To partition a table on a tag key, the key must be on the always-index list, and it stays there while the table is partitioned on it.
+
+## When changes take effect
+
+A change reaches running pipelines within about a minute, without a restart. A tag key you add to the always-index list gets its column when you save, so you can partition on it immediately. An attribute path gets its column the next time a pipeline writes a log that has it.
+
+## Excluded fields and removed columns \[#excluded]
+
+Grepr doesn't drop an indexed column. When you add a field to a never-index list, Grepr stops writing the field's column for new logs, and searches read the field from the log's attributes or tags instead, so they return the same results. The column and the data already written stay in the table, and the column still counts toward the discovery cap. To have columns removed, contact <support@grepr.ai>.
+
+## Change indexing through the API
+
+Reading a table's configuration returns its indexing settings with a `revision`. To change them, send the complete settings for both groups to the promotion endpoint, which replaces what's stored. Include the `revision` you read: if the settings changed since then, the request fails with a 409 error, and you read them again before you retry. Without a `revision`, the request replaces the stored settings whatever they are. See the [Datasets specification](/apis/api-spec#tag/Datasets).
+
+## Frequently Asked Questions
+
+### What is an indexed column in Grepr?
+
+An indexed column is a log attribute path or tag key that Grepr writes into its own column in the dataset's data lake table, instead of leaving it only in the log's attribute document or tags. Searches that filter on the field read that column and skip files that can't match, which makes them faster.
+
+### Do I have to list the fields I want indexed?
+
+No, if you turn on discovery. Grepr then adds a column for each new field it finds, up to the discovery cap. Discovery is off for a new dataset. List a field on the always-index list to index it whether or not discovery is on.
+
+### Do my searches change when a field is indexed?
+
+No. The same search returns the same results whether or not a field is indexed, and runs faster when it is.
+
+### What happens when I turn discovery off?
+
+Grepr stops adding columns. Every column the table already has keeps being written, and fields on the always-index list keep their columns.
+
+### How do I stop Grepr from writing a column?
+
+Add the field to the never-index list. Turning discovery off doesn't do it, because that only stops new columns. The column stays in the table, and the data already written stays searchable.
+
+### What if an attribute path is on both the always-index and never-index lists?
+
+Always index wins. You can exclude a subtree with a nested-paths entry and keep one path inside it indexed. A tag key can't be on both lists.
+
+### When do indexing changes take effect?
+
+Within about a minute on running pipelines, without a restart. A tag key you add gets its column when you save. An attribute path you add gets its column the next time a pipeline writes a log that has it.
+
+### Can I delete an indexed column?
+
+No. Adding the field to the never-index list stops Grepr from writing it, but the column stays in the table, the data already written stays searchable, and the column still counts toward the discovery cap. Contact support\@grepr.ai if you need columns removed.
+
+### Can I stop indexing service and host?
+
+No. Grepr always indexes the service and host tags, and neither key can be on the never-index list.
+
+### What does marking an always-index path numeric do?
+
+The path gets its numeric column the next time a pipeline writes it, whether or not discovery is on. Use it for values that are numbers written as strings.

package/build/dist/docs-index/{3c2465b1-7427-4ef6-aef0-9eac934197cb.txt → 29cf0e5d-fa06-4713-aa29-e2eef7f7faee.txt}

@@ -37,6 +37,15 @@
 - name: maxPipelines (optional)
   type: integer
 
+- name: maxPromotedAttributeColumns (optional)
+  type: integer
+
+- name: maxPromotedTagColumns (optional)
+  type: integer
+
+- name: maxPromotionPolicyEntriesPerList (optional)
+  type: integer
+
 - name: maxS3DataWarehouseIntegrations (optional)
   type: integer
 

package/build/dist/docs-index/{2804c552-ecce-4132-b74c-b504e259e28b.txt → 31d75374-f4a0-4ac6-92f2-89267b84a50e.txt}

@@ -19,6 +19,9 @@
 - name: payload (required)
   type: `AgentConfigPayload`
 
+- name: state (optional)
+  type: enum: `ACTIVE`, `PAUSED`, `DELETED`
+
 - name: updatedAt (required)
   type: string
 

package/build/dist/docs-index/36195777-b6e0-45d9-a6b6-b78b8cded73b.txt

@@ -0,0 +1,23 @@
+# PromotedAttribute
+
+Attribute paths the table indexes, with the policy applied to each.
+
+**Type**: `object`
+
+## Properties
+
+- name: excluded (required)
+  type: boolean
+  description: Whether the stored policy leaves this path's columns NULL.
+
+- name: numeric (required)
+  type: boolean
+  description: Whether the path also has an n_ numeric index column.
+
+- name: path (required)
+  type: string
+  description: The attribute path this column indexes.
+
+- name: valueColumn (required)
+  type: string
+  description: The a_ value index column for the path.

package/build/dist/docs-index/38ccd4ef-8d55-4b5d-b579-d813d886d9f9.txt

@@ -0,0 +1,14 @@
+# PromotionPolicyAttributeInclude
+
+**Type**: `object`
+
+## Properties
+
+- name: numeric (optional)
+  type: boolean
+
+- name: path (required)
+  type: string
+
+- name: prefix (optional)
+  type: boolean

package/build/dist/docs-index/4084149a-1666-44c3-9521-f99daf5f747c.txt

@@ -0,0 +1,36 @@
+# Delete a vendor estimation run
+
+**DELETE** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}`
+
+**Operation ID**: `deleteVendorEstimationRun`
+**Summary**: Delete a vendor estimation run
+Deletes a stopped, complete or failed run and its results. A run in progress returns 409 and has to be stopped first.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **runId** (required) - path
+  - Run id
+  - Type: string
+
+## Responses
+
+### 204
+
+Run deleted
+
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration or run not found.
+
+### 409
+
+Conflict - The run is in progress; stop it first.

package/build/dist/docs-index/41bf65a9-1e3a-448d-8818-bec9809834e2.txt

@@ -0,0 +1,38 @@
+# Pause or resume an agent
+
+**PUT** `/v1/agents/{id}/state`
+
+**Operation ID**: `setState`
+**Summary**: Pause or resume an agent
+Sets the agent to PAUSED or ACTIVE. A paused agent runs no investigations: signals from every source are dropped, manual starts and resumes are refused, and queued investigations wait until the agent is resumed. Pipelines keep marking new patterns as sent, so after resuming, the agent usually reacts only to patterns that are new since then.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `StateChangeRequest`
+
+## Responses
+
+### 204
+
+State set (or already set)
+
+### 400
+
+The state is not ACTIVE or PAUSED
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent not found

package/build/dist/docs-index/47f915c2-7852-41f4-9f43-034c067a2883.txt

@@ -0,0 +1,14 @@
+# AgentPipelineSubscription
+
+**Type**: `object`
+
+## Properties
+
+- name: jobId (required)
+  type: string
+
+- name: pausedAt (optional)
+  type: string
+
+- name: subscribedAt (required)
+  type: string

package/build/dist/docs-index/{4c6f1221-8f9a-410d-8218-896d73d0531d.txt → 4c311712-7504-48e6-ad15-a872183066d6.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `previewVendorEstimationRun`
 **Summary**: Preview a vendor estimation run
-Classifies the exceptions a run would cover — every one the integration has imported — and returns how many distinct queries it would send to the vendor and which exceptions cannot be counted because their query never parsed. Writes nothing.
+Returns how many exceptions and distinct queries a run would cover, and which exceptions cannot be counted because their query never parsed. Writes nothing.
 
 ## Tags
 - Integration Exceptions
@@ -29,7 +29,7 @@ Preview computed
 - **Content-Type**: `application/json` / `VendorEstimationRunPreview`
 ### 400
 
-Bad Request - Window is inverted or scope is invalid.
+Bad Request - The window is inverted, starts or ends in the future, or is too long.
 
 ### 401
 

package/build/dist/docs-index/{e7d2953a-3cf7-4b31-9689-8ab4232bd024.txt → 633954fa-fd61-46f5-8ca7-63935186cd6c.txt}

@@ -1,10 +1,10 @@
-# Resume a stalled vendor estimation run
+# Resume a stopped vendor estimation run
 
 **POST** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/resume`
 
 **Operation ID**: `resumeVendorEstimationRun`
-**Summary**: Resume a stalled vendor estimation run
-Triggers another slice for a run that has been running without progress for longer than the configured stale threshold. Returns 409 for a run that is progressing normally, parked on a rate limit, or already finished.
+**Summary**: Resume a stopped vendor estimation run
+Makes a stopped run active again; counting continues where it stopped. Returns 409 for a run that is not stopped, or when the organization has the most runs allowed in progress.
 
 ## Tags
 - Integration Exceptions
@@ -21,7 +21,7 @@ Triggers another slice for a run that has been running without progress for long
 
 ### 200
 
-Slice triggered
+Run resumed
 
 - **Content-Type**: `application/json` / `VendorEstimationRun`
 ### 401
@@ -34,4 +34,4 @@ Not Found - Integration or run not found.
 
 ### 409
 
-Conflict - The run is not eligible to be resumed.
+Conflict - The run cannot be resumed now.

package/build/dist/docs-index/{ba1f67e7-b6c6-4347-bb0d-6f9ee1b78711.txt → 66c5ac8e-78d9-4fd8-b39c-09d144fdab9d.txt}

@@ -26,7 +26,7 @@ The log reducer divides incoming log events into fixed-duration, tumbling window
 If the reducer cannot find a matching pattern for a message, the message passes through unmodified. Reasons that the reducer cannot find a pattern include:
 
 * The clustering process is unable to extract patterns from messages.
-* The log message field is empty or null.
+* The selected inputs contain neither message tokens nor attribute structure to group by. See [Choose which fields form a pattern](/transforms/reducer/configuration#structured-configuration).
 * The message matches a configured exception rule that prevents it from being reduced.
 
 To learn more about the transformations the reducer applies to messages and how to modify its default behavior, see [Configure the log reducer in a Grepr pipeline](/transforms/reducer/configuration).

package/build/dist/docs-index/{30ccdd68-c475-48db-a81f-1398a9eadcd7.txt → 69b2e56d-8758-4eeb-96b7-9ba5800f72ed.txt}

@@ -26,6 +26,10 @@ The payload containing integration data.
   type: string
   description: Client token for Datadog
 
+- name: dashboardFreshnessWindow (optional)
+  type: string
+  description: The active dashboard threshold: only dashboards viewed within it are imported as parsed queries. When unset, every dashboard is imported. Minimum one day.
+
 - name: exceptions (optional)
   type: object
   description: The imported exceptions from Datadog. This is a map from the vendor resource Id to the exception.
@@ -34,6 +38,10 @@ The payload containing integration data.
   type: string
   description: Filter to apply when reading any data from the Datadog API
 
+- name: includeNeverViewedDashboards (optional)
+  type: boolean
+  description: When the active dashboard threshold is set, whether dashboards that were never viewed are still imported. Unset means they are.
+
 - name: sendKeyId (optional)
   type: string
   description: Identifier of the API key used to send data back to Datadog. Defaults to the only key when unset.

package/build/dist/docs-index/768a87bc-25a7-4760-bb5c-5230a0b4b654.txt

@@ -0,0 +1,14 @@
+# PromotionPolicyAttributes
+
+**Type**: `object`
+
+## Properties
+
+- name: cap (required)
+  type: integer
+
+- name: exclude (optional)
+  type: array of `PromotionPolicyAttributeExclude`
+
+- name: include (optional)
+  type: array of `PromotionPolicyAttributeInclude`

package/build/dist/docs-index/{adf9e475-3162-4882-abdd-d9b7e09c80f2.txt → 76cc225b-2368-46f8-a0d0-b9cafea8bdad.txt}

@@ -4,8 +4,6 @@
 
 **Operation ID**: `get_3`
 **Summary**: Get a skill
-## Tags
-- Skills
 ## Parameters
 
 - **id** (required) - path

package/build/dist/docs-index/78c7f761-7f5a-4ec4-a2a2-c60c1561c84c.txt

@@ -0,0 +1,30 @@
+# Get the usage of an integration's parsed queries
+
+**GET** `/v1/integrations/{integrationId}/exceptions/usage`
+
+**Operation ID**: `getIntegrationExceptionUsage`
+**Summary**: Get the usage of an integration's parsed queries
+Returns the usage the observability vendor reports for the source of each parsed query, such as when a Datadog dashboard was last viewed and its total views, with whether the last attempt to read it worked. Queries the vendor reported nothing for are absent rather than reported as never viewed.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+
+## Responses
+
+### 200
+
+Usage retrieved
+
+- **Content-Type**: `application/json` / `ExceptionUsageResponse`
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration not found.

package/build/dist/docs-index/{817e9a9b-307e-4119-9c7a-cf2c9e20d8a7.txt → 7f9fcec1-6c0c-45d9-9d24-b1b38405824d.txt}

@@ -4,8 +4,6 @@
 
 **Operation ID**: `create_2`
 **Summary**: Create an organization skill
-## Tags
-- Skills
 ## Request Body
 
 **Content-Type**: `application/json`