Skip to main content
DELETE
Delete Watchlist

Endpoint

Authentication

Requires watchlist:delete permission.

Path Parameters

string
required
The unique identifier of the watchlist to delete

Request Example

Response

Error Responses

404 Not Found

Important Notes

This action is permanent and cannot be undone.Deleting a watchlist will:
  • Remove the watchlist configuration
  • Delete all subjects from the watchlist
  • Cancel scheduled checks
  • Remove historical screening data
  • Stop all alerts and notifications
Alternative: Pause Instead of DeleteIf you want to temporarily stop monitoring without losing data, consider updating the status to paused instead of deleting.

Status Codes

Best Practices

  • Export data first: Use the Get Watchlist endpoint to retrieve and save watchlist data before deletion
  • Pause instead: For temporary suspension, use status: "paused" to preserve data
  • Verify ID: Double-check the watchlist_id to avoid accidental deletion
  • Log deletions: Maintain audit logs of watchlist deletions for compliance