Update a value list item

Server: https://{kibana_url}

PUT /api/lists/items

Update a value list item using the list item ID. The original list item is replaced, and all unspecified fields are deleted.

info You cannot modify the id value.

Request

Responses

Successful response

application/json

Invalid input data response

application/json

Unsuccessful authentication response

application/json

Not enough privileges response

application/json

List item not found response

application/json

Internal server error response

application/json

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

PUT /api/lists/items
{
  "id": "ip_item",
  "value": "255.255.255.255"
}

curl Shell

curl -X PUT "https://{kibana_url}/api/lists/items" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "ip_item",
  "value": "255.255.255.255"
}'

Response

{
  "_version": "WzIwLDFd",
  "@timestamp": "2025-01-08T05:15:05.159Z",
  "created_at": "2025-01-08T05:15:05.159Z",
  "created_by": "elastic",
  "id": "pd1WRJQBs4HAK3VQeHFI",
  "list_id": "ip_list",
  "tie_breaker_id": "eee41dc7-1666-4876-982f-8b0f7b59eca3",
  "type": "ip",
  "updated_at": "2025-01-08T05:44:14.009Z",
  "updated_by": "elastic",
  "value": "255.255.255.255"
}

{
  "error": "Bad Request",
  "message": "[request body]: id: Expected string, received number",
  "statusCode": 400
}

{
  "error": "Unauthorized",
  "message": "[security_exception\\n\\tRoot causes:\\n\\t\\tsecurity_exception: unable to authenticate user [elastic] for REST request [/_security/_authenticate]]: unable to authenticate user [elastic] for REST request [/_security/_authenticate]",
  "statusCode": 401
}

{
  "error": "Forbidden",
  "message": "API [PATCH /api/lists/items] is unauthorized for user, this action is granted by the Kibana privileges [lists-all]",
  "statusCode": 403
}

{
  "message": "list item id: \\\u0022foo\\\u0022 not found",
  "status_code": 404
}

{
  "message": "Internal Server Error",
  "status_code": 500
}

Request { _version , id , meta , value , }

Responses

Request