Delete object API

edit

Deprecated in 8.7.0.

To be removed in an upcoming version

Remove Kibana saved objects.

Once you delete a saved object, it cannot be recovered.

For the most up-to-date API details, refer to the open API specification.

Request

edit

DELETE <kibana host>:<port>/api/saved_objects/<type>/<id>

DELETE <kibana host>:<port>/s/<space_id>/api/saved_objects/<type>/<id>

Path parameters

edit
space_id
(Optional, string) An identifier for the space. If space_id is not provided in the URL, the default space is used.
type
(Required, string) Valid options include visualization, dashboard, search, index-pattern, config.
id
(Required, string) The object ID that you want to remove.

Query parameters

edit
force

(Optional, boolean) When true, forces an object to be deleted if it exists in multiple namespaces.

Use this if you attempted to delete an object and received an HTTP 400 error with the following message: "Unable to delete saved object that exists in multiple namespaces, use the force option to delete it anyway"

Response code

edit
200
Indicates a successful call.

Example

edit

Delete a data view object with the my-pattern ID:

$ curl -X DELETE api/index_patterns/index-pattern/my-pattern