Skip to main content
DELETE
Remove Subject

Endpoint

Authentication

Requires watchlist:update permission.

Path Parameters

string
required
The unique identifier of the watchlist
string
required
The unique identifier of the subject to remove

Request Example

Response

Error Responses

404 Not Found - Watchlist

404 Not Found - Subject

Status Codes

Important Notes

What Happens After RemovalWhen a subject is removed from a watchlist:
  • The subject is immediately excluded from future checks
  • Historical screening data for this subject is preserved
  • No alerts will be sent for this subject
  • The subject can be re-added later if needed

Best Practices

To remove a subject, you need their subject_id. Get it from the Get Watchlist endpoint which returns all subjects with their IDs.
Before removing subjects, export watchlist data for compliance and audit purposes using the Get Watchlist endpoint.
Currently, subjects must be removed one at a time. If you need to remove many subjects, consider deleting and recreating the watchlist or pausing it.

Example Workflow

Get subject IDs, then remove:

Next Steps