Monitors
Delete Twitter keyword monitor & stop webhooks
Stop a Twitter keyword monitor and future query checks. Remove stored events in bounded batches. Poll the status URL until deletion finishes. Keep its query.
- 202
- 400
- 401
- 404
- 429
DELETE
Delete Twitter keyword monitor & stop webhooks
Delete a keyword monitor only when its tweet query should stop permanently.
Pause it instead when future monitoring might resume.
The examples store a deletion receipt. Poll
The response includes
The provided monitor ID is not a valid format.
Missing or invalid API key.
No keyword monitor exists with this ID, or it belongs to a different account.
Too many requests. Wait for the
Free - does not consume credits
verify_endpoint while it returns
200. Deletion finishes when it returns 404. Respect Retry-After between
requests.
Remove one keyword without deleting the monitor
Use this route when the monitor should continue with fewer search terms. Confirm both the monitor ID and keyword ID before deletion. Save the keyword text in your approval record. The response identifies the removed keyword. Other keywords and monitor delivery settings remain a separate concern. Use a full monitor deletion only when the entire monitor should stop. Do not delete the monitor to remove one unwanted keyword.Path parameters
string
required
The unique keyword monitor ID.
Headers
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
Response
202 Accepted
string
Returns
deleting while cleanup runs.string
Poll this URL until it returns
404.boolean
Always
true when deletion starts.Location and Retry-After headers. Poll Location
after the stated interval.
400 Invalid ID
401 Unauthenticated
404 Not found
429 Rate limited
Retry-After header before retrying.
Deletion handoff
Use this endpoint when a keyword query should stop permanently. Use Update Keyword Monitor withisActive: false when you only need to pause alerts and keep the monitor
available.
Permanent remove
Delete stops the monitor immediately. Poll
statusUrl until it returns
404. The deleted ID cannot be updated or resumed.Stored history
Stored events and webhook delivery records tied to this keyword monitor are
removed in bounded batches. Export required records before deletion.
Pause instead
Use
PATCH /monitors/keywords/{id} with isActive: false to stop future
polling, alerts, and hourly billing while preserving the monitor record.Verify removal
Call List Keyword Monitors after
deletion. Get Keyword Monitor should
return
404 for the deleted ID.Track new query
Create a new keyword monitor when the X search query changes. Store the new
id, query, eventTypes, isActive, and nextBillingAt.Webhook reuse
Existing webhook endpoints remain configured. Keep their
eventTypes
aligned, then run Test Webhook before
relying on new keyword monitor alerts.The keyword monitor is deleted and its stored events are removed with it. Pause with
isActive: false if you want to stop new checks without deleting the monitor.Related. List Keyword Monitors to verify removal, or Create Keyword Monitor to track a new query.