Skip to main content

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

ParameterTypeRequiredDescription
list_idstringYesUnique identifier of the list to add items to
valuesarray[string]YesArray 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

FieldTypeDescription
added_countintegerNumber of new values successfully added
duplicate_countintegerNumber of values that were already in the list
total_valuesintegerTotal number of values in list after addition
added_valuesarray[string]List of values that were actually added
duplicatesarray[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