Update an existing watchlist Technical Preview

PUT /api/entity_analytics/watchlists/{id}
Api key auth Basic auth

Spaces method and path for this operation:

put /s/{space_id}/api/entity_analytics/watchlists/{id}

Refer to Spaces for more information.

Path parameters

  • id string Required

    The ID of the watchlist to update

application/json

Body Required

  • description string Required

    Description of the watchlist

  • managed boolean

    Indicates if the watchlist is managed by the system

  • name string Required

    Unique name of the watchlist

  • riskModifier number Required

    Risk score modifier associated with the watchlist

Responses

  • 200 application/json

    Watchlist updated successfully

    Hide response attributes Show response attributes object
    • createdAt string(date-time)

      Timestamp indicating when the watchlist was created

    • description string

      Description of the watchlist

    • id string

      The unique ID of the watchlist

    • managed boolean Required

      Indicates if the watchlist is managed by the system

    • name string Required

      The name of the watchlist

    • riskModifier number Required

      Risk score modifier associated with the watchlist

    • updatedAt string(date-time)

      Timestamp indicating when the watchlist was last updated
PUT /api/entity_analytics/watchlists/{id} 
curl \
 --request PUT 'https://localhost:5601/api/entity_analytics/watchlists/{id}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"name":"High Risk Vendors","managed":false,"description":"High risk vendor watchlist","riskModifier":1.5}'
Request example 
{
  "name": "High Risk Vendors",
  "managed": false,
  "description": "High risk vendor watchlist",
  "riskModifier": 1.5
}
Response examples (200) 
{
  "id": "watchlist-123",
  "name": "High Risk Vendors",
  "managed": false,
  "createdAt": "2026-01-28T12:00:00.000Z",
  "updatedAt": "2026-02-18T12:00:00.000Z",
  "description": "High risk vendor watchlist",
  "riskModifier": 1.5
}