mirror of
https://github.com/elastic/kibana.git
synced 2025-04-24 17:59:23 -04:00
50 lines
1.2 KiB
Text
50 lines
1.2 KiB
Text
[[data-views-api-delete]]
|
|
=== Delete data view API
|
|
++++
|
|
<titleabbrev>Delete data view</titleabbrev>
|
|
++++
|
|
|
|
experimental[] Delete data views.
|
|
|
|
WARNING: Once you delete a data view, _it cannot be recovered_.
|
|
|
|
[NOTE]
|
|
====
|
|
For the most up-to-date API details, refer to the
|
|
{kib-repo}/tree/{branch}/src/plugins/data_views/docs/openapi[open API specification].
|
|
====
|
|
|
|
[[data-views-api-delete-request]]
|
|
==== Request
|
|
|
|
`DELETE <kibana host>:<port>/api/data_views/data_view/<id>`
|
|
|
|
`DELETE <kibana host>:<port>/s/<space_id>/api/data_views/data_view/<id>`
|
|
|
|
|
|
[[data-views-api-delete-path-params]]
|
|
==== Path parameters
|
|
|
|
`space_id`::
|
|
(Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
|
|
|
|
`id`::
|
|
(Required, string) The ID of the data view you want to delete.
|
|
|
|
|
|
[[data-views-api-delete-response-codes]]
|
|
==== Response code
|
|
|
|
`200`::
|
|
Indicates that data view is deleted. Returns an empty response body.
|
|
|
|
|
|
==== Example
|
|
|
|
Delete a data view object with the `my-view` ID:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
$ curl -X DELETE api/data_views/data_view/my-view
|
|
--------------------------------------------------
|
|
// KIBANA
|