Skip to main content
Permanently delete a Reddit watchlist and all associated posts and data.
Deleting a watchlist is permanent and cannot be undone. All associated posts and data will be removed.
Plugin requirement. Like all /api-reddit-watchlist methods, delete requires at least one team member to have had the OutX browser extension active within the last 48 hours, otherwise it returns 403 Plugin installation required. Teams with global data sharing enabled are exempt.

​
Query Parameters

​
id
string
required
Watchlist ID to delete
curl -X DELETE \
  "https://api.outx.ai/api-reddit-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
401Missing API Key / Invalid API KeyInvalid or missing API key
403Plugin installation requiredNo team member has had the OutX browser extension active in the last 48 hours. Exempt if global data sharing is enabled.
404Watchlist not found or access deniedWatchlist does not exist, is not a Reddit list, or is not yours

​
Frequently Asked Questions

No. Deletion is permanent and cannot be undone. Once you delete a Reddit watchlist, the watchlist configuration and all associated data are removed. If you want to temporarily stop tracking, use the update endpoint to set disable: true instead.
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.