Delete Watchlist
Watchlists
Delete Watchlist
Remove a watchlist and all associated data
DELETE
Delete Watchlist
Endpoint
Authentication
Requireswatchlist:delete permission.
Path Parameters
string
required
The unique identifier of the watchlist to delete
Request Example
Response
Error Responses
404 Not Found
Important Notes
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_idto avoid accidental deletion - Log deletions: Maintain audit logs of watchlist deletions for compliance