Add Items to List
Route
/v2/lists/{list_id}/items
Description
Add new values to an existing policy configuration list. Duplicate values are automatically ignored.
Method
POST
Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | Unique identifier of the list to add items to |
values | array[string] | Yes | Array of values to add to the list |
Path Parameters
- list_id: The unique identifier of the list (provided in the URL path)
Request Example
{
"values": [
".pptm",
".xlsm",
".docm",
".vsdx",
".pub"
]
}
Output
| Field | Type | Description |
|---|---|---|
added_count | integer | Number of new values successfully added |
duplicate_count | integer | Number of values that were already in the list |
total_values | integer | Total number of values in list after addition |
added_values | array[string] | List of values that were actually added |
duplicates | array[string] | List of values that were duplicates |
Rate Limit
- 60 requests per minute per API key
- 5 concurrent requests per endpoint
Example Response
{
"added_count": 3,
"duplicate_count": 2,
"total_values": 21,
"added_values": [
".pptm",
".vsdx",
".pub"
],
"duplicates": [
".xlsm",
".docm"
]
}
Usage Notes
- Maximum 100 values per request
- Duplicate values are automatically filtered out
- List cannot exceed 1000 total values
- Values are case-sensitive
- Empty or whitespace-only values are ignored