v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Security Lists API

Delete a value list item

Spaces method and path for this operation:

<div><span class="operation-verb delete">delete</span>&nbsp;<span class="operation-path">/s/{space_id}/api/lists/items</span></div>

Refer to Spaces for more information.

Delete a value list item using its id, or its list_id and value fields.

delete/api/lists/items

Query parameters

idstring nonempty

Value list item's identifier.

Example:54b01cfb-058d-44b9-838c-282be16c91cd

Value list item's identifier. Required if list_id and value are not specified.

list_idstring nonempty

Value list's identifier.

Example:21b01cfb-058d-44b9-838c-282be16c91cd

Value list's identifier. Required if id is not specified.

valuestring
Example:255.255.255.255

The value used to evaluate exceptions. Required if id is not specified.

refresh'true' | 'false' | 'wait_for'

Determines when changes made by the request are made visible to search.

Response

Successful response

OR

Example response

{
  "_version": "WzIsMV0=",
  "@timestamp": "2025-01-08T04:47:34.273Z",
  "created_at": "2025-01-08T04:47:34.273Z",
  "created_by": "elastic",
  "id": "54b01cfb-058d-44b9-838c-282be16c91cd",
  "list_id": "21b01cfb-058d-44b9-838c-282be16c91cd",
  "tie_breaker_id": "f5508188-b1e9-4e6e-9662-d039a7d89899",
  "updated_at": "2025-01-08T04:47:34.273Z",
  "updated_by": "elastic"
}