Skip to main content
Permanently delete a company watchlist and all associated data.
Deleting a watchlist is permanent and cannot be undone. All associated data will be removed.

​
Query Parameters

​
id
string
required
Watchlist ID to delete
curl -X DELETE \
  "https://api.outx.ai/api-company-watchlist?id=880e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: YOUR_API_KEY"

{
  "id": "880e8400-e29b-41d4-a716-446655440000",
  "deleted": true,
  "message": "Watchlist and all related data deleted successfully"
}

​
Response Fields

​
id
string
ID of the deleted watchlist
​
deleted
boolean
Whether the deletion was successful
​
message
string
Success message

​
Error Responses

Status CodeError MessageDescription
400Missing required parameter: idWatchlist ID is required
401UnauthorizedInvalid or missing API key
403Access deniedTrying to delete watchlist from another team
404Watchlist not foundWatchlist ID doesn’t exist

​
Frequently Asked Questions

Q: Is deleting a company watchlist reversible? No. Deletion is permanent and cannot be undone. Once you delete a company watchlist, the watchlist configuration and all associated data are removed. If you want to temporarily stop tracking, consider using the update endpoint to set disable: true instead.
Q: What happens to the posts that were already collected? All posts associated with the deleted watchlist are permanently removed. If you need to preserve historical data, export or save the posts via the Posts API before deleting the watchlist.