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

​
Query Parameters

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

{
  "id": "550e8400-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 keyword watchlist reversible? No. Deletion is permanent and cannot be undone. Once you delete a keyword 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.