kibana/docs/api/osquery-manager/saved-queries/delete.asciidoc
Kibana Machine 48ee21e3e4
[8.6] [DOCS] Fixes formatting in the Osquery manager APIs (#149871) (#149877)
# Backport

This will backport the following commits from `main` to `8.6`:
- [[DOCS] Fixes formatting in the Osquery manager APIs
(#149871)](https://github.com/elastic/kibana/pull/149871)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Kaarina
Tungseth","email":"kaarina.tungseth@elastic.co"},"sourceCommit":{"committedDate":"2023-01-30T18:41:10Z","message":"[DOCS]
Fixes formatting in the Osquery manager APIs (#149871)\n\n##
Summary\r\n\r\nFixes the formatting of the rogue `Query parameters`
sections.","sha":"be498a5c581e901885ca1f1241e9a64fb2919b98","branchLabelMapping":{"^v8.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v8.4.0","v8.5.0","v8.6.0","v8.7.0"],"number":149871,"url":"https://github.com/elastic/kibana/pull/149871","mergeCommit":{"message":"[DOCS]
Fixes formatting in the Osquery manager APIs (#149871)\n\n##
Summary\r\n\r\nFixes the formatting of the rogue `Query parameters`
sections.","sha":"be498a5c581e901885ca1f1241e9a64fb2919b98"}},"sourceBranch":"main","suggestedTargetBranches":["8.4","8.5","8.6"],"targetPullRequestStates":[{"branch":"8.4","label":"v8.4.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.5","label":"v8.5.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.6","label":"v8.6.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.7.0","labelRegex":"^v8.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/149871","number":149871,"mergeCommit":{"message":"[DOCS]
Fixes formatting in the Osquery manager APIs (#149871)\n\n##
Summary\r\n\r\nFixes the formatting of the rogue `Query parameters`
sections.","sha":"be498a5c581e901885ca1f1241e9a64fb2919b98"}}]}]
BACKPORT-->

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
2023-01-30 14:00:40 -05:00

45 lines
1.2 KiB
Text

[[osquery-manager-saved-queries-api-delete]]
=== Delete saved query API
++++
<titleabbrev>Delete saved query</titleabbrev>
++++
experimental[] Delete saved queries.
WARNING: Once you delete a saved query, _it cannot be recovered_.
[[osquery-manager-saved-queries-api-delete-request]]
==== Request
`DELETE <kibana host>:<port>/api/osquery/saved_queries/<id>`
`DELETE <kibana host>:<port>/s/<space_id>/api/osquery/saved_queries/<id>`
[[osquery-manager-saved-queries-api-delete-path-params]]
==== Path parameters
`space_id`::
(Optional, string) The space identifier. When `space_id` is not provided in the URL, the default space is used.
`id`::
(Required, string) The ID of the saved query you want to delete.
[[osquery-manager-saved-queries-api-delete-response-codes]]
==== Response code
`200`::
Indicates the saved query is deleted. Returns an empty response body.
[[osquery-manager-saved-queries-api-delete-example]]
==== Example
Delete a saved query object with the `42ba9c50-0cc5-11ed-aa1d-2b27890bc90d` ID:
[source,sh]
--------------------------------------------------
$ curl -X DELETE api/osquery/saved_queries/42ba9c50-0cc5-11ed-aa1d-2b27890bc90d
--------------------------------------------------
// KIBANA