Delete saved objects

deprecated

Base URL: https://{kibana_url}

POST /api/saved_objects/_bulk_delete

Warning

This API is deprecated. This is a legacy Saved Objects API and may be removed in a future version of Kibana.

Deletes multiple Kibana saved objects in a single request.

There is currently no complete replacement for deleting arbitrary saved objects via an HTTP API.

Authentication

Api key

Authorization: <value>

These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: Authorization: ApiKey base64AccessApiKey

Basic

Authorization: Basic <credentials>

Query parameters

Header parameters

Request body

Responses

200

A bulk delete response.

application/json

400

A bad request.

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn://api/saved_objects/_bulk_delete?force=false
[{"type":"dashboard","id":"example-dashboard-1"},{"type":"dashboard","id":"does-not-exist"}]

curl Shell

curl \
  -X POST "${KIBANA_URL}/api/saved_objects/_bulk_delete?force=false" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  -H "Content-Type: application/json" \
  -d '[{"type":"dashboard","id":"example-dashboard-1"},{"type":"dashboard","id":"does-not-exist"}]'

Response

{
  "error": "Bad Request",
  "message": "Unsupported saved object type(s): unknownType",
  "statusCode": 400
}

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn:/api/saved_objects/_bulk_delete
[
  {
    "id": "example-dashboard-1",
    "type": "dashboard"
  },
  {
    "id": "does-not-exist",
    "type": "dashboard"
  }
]

Generated from the API spec

curl Shell

curl \
  -X POST "${KIBANA_URL}/api/saved_objects/_bulk_delete" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "id": "example-dashboard-1",
      "type": "dashboard"
    },
    {
      "id": "does-not-exist",
      "type": "dashboard"
    }
  ]'

Generated from the API spec

Response

{
  "statuses": [
    {
      "id": "example-dashboard-1",
      "success": true,
      "type": "dashboard"
    },
    {
      "error": {
        "error": "Not Found",
        "message": "Saved object [dashboard/does-not-exist] not found",
        "statusCode": 404
      },
      "id": "does-not-exist",
      "success": false,
      "type": "dashboard"
    }
  ]
}

{
  "error": "Bad Request",
  "message": "Unsupported saved object type(s): unknownType",
  "statusCode": 400
}

Authentication

Query parameters

Header parameters

Request body [{ }]

Responses

Request body