Remove Monitor
Stop watching an X/Twitter account and free the plan slot it was using. Removed monitors can be re-added later and will re-baseline from the newest tweet.
/twitter/monitor/removeStop watching an account and free the plan slot it occupied.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer YOUR_API_KEY, the same key used for every other GetXAPI endpoint |
Content-Type | string | Yes | application/json |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
monitor_id | string | Yes | UUID of the monitor to remove |
Notes
- This is the only way to free a plan slot. Pausing keeps the slot.
- Removing does not delete the webhook. It stays registered and can serve other monitors.
- You can re-add the same account later with Add monitor. The response will show
reactivated: true, and it re-baselines from the account's newest tweet at that moment, so nothing from the gap is replayed. - Deliveries already queued or mid-retry when you remove a monitor may still arrive. Your handler should tolerate a delivery for a monitor you just removed.
Removing every monitor attached to a webhook also unblocks deleting that webhook, which otherwise returns 409 WEBHOOK_IN_USE.
Response (200)
{ "status": "removed", "monitor_id": "b7e2c910-4f38-4a5d-9c81-2e6a7f0d3b45" }Rate limit
30 requests per minute.
Limits use a fixed 60-second window and are shared across every API key on your account, so creating extra keys does not raise the ceiling. Every response carries RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset; a 429 adds Retry-After. See rate limits for the full table.
Errors
| Status | Meaning |
|---|---|
400 | monitor_id missing or not a valid UUID |
403 | Monitoring is not enabled for this account |
404 | No monitor with that ID on your account |
429 | Rate limit exceeded. Wait retry_after seconds, then retry |
Example
curl -X POST https://api.getxapi.com/twitter/monitor/remove \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "monitor_id": "b7e2c910-4f38-4a5d-9c81-2e6a7f0d3b45" }'Update MonitorNew
Pause, resume, change detection tier, toggle replies, or repoint a monitor at a different webhook without recreating it. Resuming re-baselines from now on.
Monitor HealthNew
Check your monitoring status: active and paused monitors, pending deliveries, and 24-hour delivered and failed counts, so you can confirm tweets are flowing.