Skip to main content
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.
Free. This endpoint does not consume credits.
The examples store a deletion receipt. Poll verify_endpoint while it returns 200. Deletion finishes when it returns 404. Respect Retry-After between requests.

Remove one term from a monitored query

A keyword monitor stores one query. The API has no route that deletes a single term. This route deletes the whole monitor. To drop a term, create a new monitor with the revised query. Export the old monitor’s stored events. Then pause or delete the old monitor.

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.
The response includes Location and Retry-After headers. Poll Location after the stated interval.

400 Invalid ID

The provided monitor ID is not a valid format.

401 Unauthenticated

Missing or invalid API key.

404 Not found

No keyword monitor exists with this ID, or it belongs to a different account.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.

Deletion handoff

Use this endpoint when a keyword query should stop permanently. Use Update Keyword Monitor with isActive: 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. You cannot update or resume the deleted ID.

Stored history

Xquik removes stored events and webhook delivery records for this monitor in batches. Export required records before deletion.

Pause instead

Use PATCH /monitors/keywords/{id} with isActive: false to stop future polling, alerts, and hourly billing. The monitor record stays.

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.
Xquik deletes the keyword monitor and its stored events. 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.