Create list item
editCreate list item
editCreates a list item and associates it with the specified list container.
All list items in the same list container must be the same type. For example,
each list item in an ip
list container must define a specific IP address.
Before creating list items, you must create a list container.
Request URL
editPOST <kibana host>:<port>/api/lists/items
Request body
editA JSON object with these fields:
Name | Type | Description | Required |
---|---|---|---|
|
String |
Unique identifier of the list item. |
No, automatically created when it is not provided. |
|
String |
ID of the associated list container. |
Yes |
|
Object |
Placeholder for metadata about the list item. |
No |
|
String |
The value used to evaluate exceptions. For information on how list item exceptions are evaluated, see Create exception item. |
Yes |
Example requests
editAdds an IP address to the internal-ip-excludes
list container:
POST api/lists/items { "id": "internal-ip-1", "list_id": "internal-ip-excludes", "value": "10.0.0.12" }
Adds a host name to the host.name-container
list container:
POST api/lists { "id": "win-prem-19", "list_id": "host.name-container", "value": "liverpool-fc" }
Response code
edit-
200
- Indicates a successful call.
Response payload
edit{ "_version": "WzEsMV0=", "id": "internal-ip-1", "type": "ip", "value": "10.0.0.12", "created_at": "2020-08-11T10:54:46.080Z", "created_by": "elastic", "list_id": "internal-ip-excludes", "tie_breaker_id": "ed3f9d84-cd85-4122-b93d-07d1de4fd8bb", "updated_at": "2020-08-11T10:54:46.080Z", "updated_by": "elastic" }
Base-64 encoded value of |