Create List

Route

/v2/lists

Description

Create a new list containing string values for use in Cyberhaven policies and rules. Lists can contain domains, file paths, usernames, or other identifiers used for policy configuration.

Method

POST

Inputs

Parameter	Type	Required	Description
name	string	Yes	Unique name for the list (max 255 characters)
description	string	No	Description of the list's purpose
items	array[string]	No	Initial list items to include

Request Example

{
  "name": "Sensitive Domains",
  "description": "List of domains containing sensitive corporate data",
  "items": [
    "confidential.company.com",
    "internal.acme.com",
    "secure.example.org"
  ]
}

Output

Field	Type	Description
id	string	Unique list identifier
name	string	List name
description	string	List description
type	string	List type (always "unmanaged" for created lists)
size	integer	Number of items in the list
created_at	string	Creation timestamp (ISO 8601)
created_by	string	User who created the list
updated_at	string	Last update timestamp (ISO 8601)
updated_by	string	User who last updated the list

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "id": "list-123",
  "name": "Sensitive Domains",
  "description": "List of domains containing sensitive corporate data",
  "type": "unmanaged",
  "size": 3,
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "admin.user",
  "updated_at": "2024-01-15T10:30:00Z",
  "updated_by": "admin.user"
}