-->

Delete job API

Warning

This functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.

This API deletes an existing rollup job. A job must be stopped first before it can be deleted. Attempting to delete a started job will result in an error. Similarly, attempting to delete a nonexistent job will throw an exception.

Request

DELETE _rollup/job/<job_id>

Path Parameters

job_id (required)
(string) Identifier for the job

Request Body

There is no request body for the Delete Job API.

Authorization

You must have manage or manage_rollup cluster privileges to use this API. For more information, see Security Privileges.

Examples

If we have a rollup job named sensor, it can be deleted with:

DELETE _rollup/job/sensor

Which will return the response:

{
  "acknowledged": true
}

If however we try to delete a job which doesn’t exist:

DELETE _rollup/job/does_not_exist

A 404 resource_not_found exception will be thrown:

{
    "error" : {
        "root_cause" : [
            {
                "type" : "resource_not_found_exception",
                "reason" : "the task with id [does_not_exist] doesn't exist",
                "stack_trace": ...
            }
        ],
        "type" : "resource_not_found_exception",
        "reason" : "the task with id [does_not_exist] doesn't exist",
        "stack_trace": ...
    },
    "status": 404
}