Delete Monitor API

DELETE monitor/{id} soft-deletes a monitor: it stops polling the watched account immediately and removes the monitor from List Monitors results, but keeps its delivery history intact. The endpoint takes no parameters beyond the monitor id in the path, costs 0, and returns a JSON object with deleted (boolean) and id (string) confirming which monitor was removed.

curl -X DELETE "https://example.com/monitor/{id}"

{  "deleted": true,  "id": "b6f2c1a4-9e3d-4c11-8a2f-7d5e6c9b0a11"}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

When to use

Call this when you want to permanently stop watching an X account and clean it out of your active monitor list, for example when a campaign ends or a tracked account is no longer relevant. It is the only Monitoring endpoint that removes a monitor from polling and from List Monitors output, unlike a read call (List Monitors) or a config change (Update Monitor), which leave the monitor active.

Notes

• Replace {id} with the monitor's id.
• 404 not_found if the id does not exist or belongs to a different API key.
• Irreversible: there is no undelete. Create a new monitor for the same handle if you want to resume watching it later.

Related endpoints

• Create Monitor: Watch an X account for new posts and push them to your webhook(s).
• List Monitors: List every monitor on your account.

FAQ

Can I recover a monitor after deleting it?

No restore endpoint is described for this resource. Once deleted, the monitor stops appearing in List Monitors and stops polling; to watch the same account again you would create a new monitor rather than reactivate the old one.

Does deleting a monitor also delete its delivery history?

No. The delete is soft: it stops polling and removes the monitor from List Monitors, but the description states delivery history is retained. Past deliveries tied to that monitor id remain available even though the monitor itself is gone.

What does a successful call return, and does it cost anything?

The endpoint costs 0 and takes no parameters beyond the id in the path. On success it returns deleted (a boolean, true on success) and id (the string id of the monitor that was removed), which you can use to confirm the correct monitor was deleted.