Sign in

v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Security Entity Analytics API

Create a new watchlist

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/entity_analytics/watchlists</span></div>

Refer to Spaces for more information.

Creates a new entity analytics watchlist with an optional set of entity sources. Watchlists apply a risk score modifier to matched entities.

post/api/entity_analytics/watchlists

Request body

descriptionstring

Description of the watchlist

managedboolean

Indicates if the watchlist is managed by the system

namestring required

Unique name for the watchlist

riskModifiernumber required

Risk score modifier associated with the watchlist

Response

Watchlist created successfully

createdAtstring date-time

Timestamp indicating when the watchlist was created

descriptionstring

Description of the watchlist

entityCountnumber

Number of entities in the watchlist

entitySourceIdsstring[]

List of entity source IDs associated with the watchlist

hasManualEntitiesboolean

Indicates whether the watchlist contains manually assigned entities

idstring

The unique ID of the watchlist

managedboolean required

Indicates if the watchlist is managed by the system

namestring required

The name of the watchlist

riskModifiernumber required

Risk score modifier associated with the watchlist

updatedAtstring date-time

Timestamp indicating when the watchlist was last updated

Example response

{
  "createdAt": "2026-01-28T12:00:00.000Z",
  "description": "High risk vendor watchlist",
  "id": "watchlist-123",
  "managed": false,
  "name": "High Risk Vendors",
  "riskModifier": 1.5,
  "updatedAt": "2026-02-18T12:00:00.000Z"
}