Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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
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.