Delete Stored Script API
Introduced 1.0
Deletes a stored script from the cluster state.
Endpoints
DELETE _scripts/my-script
Path parameters
Path parameters are optional.
| Parameter | Data type | Description |
|---|---|---|
| script-id | String | ID of script to delete. |
Query parameters
| Parameter | Data type | Description |
|---|---|---|
| cluster_manager_timeout | Time | Amount of time to wait for a connection to the cluster manager. Optional, defaults to 30s. |
| timeout | Time | The period of time to wait for a response. If a response is not received before the timeout value, the request will be dropped. |
Example request
The following request deletes the my-first-script script:
DELETE /_scripts/my-scriptresponse = client.delete_script(
id = "my-script"
)Example response
The DELETE _scripts/my-first-script request returns the following field:
{
"acknowledged" : true
}
To determine whether the stored script was successfully deleted, use the Get stored script API, passing the script name as the script path parameter.
Response body fields
The
| Field | Data type | Description |
|---|---|---|
| acknowledged | Boolean | Whether the delete script request was received. |