Skip to main content
DELETE https://xquik.com/api/v1/webhooks/{id}
Free. This endpoint does not consume credits.
These snippets build a deactivation receipt. Store the webhook ID with its list and delivery-log endpoints. Do not print the raw delete response.

What delete does

DELETE /webhooks/{id} deactivates the endpoint by setting isActive to false. It does not remove the record. The webhook record stays available in List Webhooks. Its previous delivery rows stay available in List Deliveries. The response contains only { "success": true }. It does not return the URL, event types, or signing secret. To receive events again, call Update Webhook with isActive: true. Then run Test Webhook before routing production monitor events to the receiver.

Path parameters

Headers

Response

200 OK

Xquik deactivates the webhook immediately. It may still attempt in-flight deliveries, but it queues no new deliveries.

401 Unauthenticated

{ "error": "unauthenticated", "message": "Missing or invalid API key" } Missing or invalid API key or session cookie.

400 Invalid ID

{ "error": "invalid_id", "message": "Invalid webhook ID format" } The provided webhook ID is not a valid format.

404 Not found

{ "error": "not_found", "message": "Webhook not found" } No webhook 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.

Deactivation handoff

Use this endpoint when a receiver should stop getting future monitor events. The webhook record and delivery history stay for audit or rollback.

Soft deactivate

The endpoint sets isActive to false and returns { "success": true }. It does not return the webhook configuration.

Future deliveries

Inactive webhooks do not receive new monitor deliveries or scheduled retries. In-flight delivery attempts may still finish.

Audit trail

Use List Webhooks to confirm webhooks[].isActive: false. Then use List Deliveries for prior delivery status, attempts, errors, and timestamps.

Delivery audit

Delivery rows for inactive endpoints can show pending, failed, or exhausted. Reactivate the webhook to receive waiting deliveries before their 7 days end. Store streamEventId, status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt.

Event join

Use delivery streamEventId as the {id} for Get Event. Store monitorId, monitorType, type, occurredAt, and data with the deactivation record.

Receiver cleanup

Remove queue, CRM, alerting, or warehouse routing only after the endpoint is inactive. Also wait until you expect no more production events.

Reactivate

To reuse the same webhook, call Update Webhook with isActive: true, then run Test Webhook.

Signing secret

Delete returns no secret. Keep the original Create Webhook secret for audit records or future reactivation.
This endpoint accepts 2 auth methods. Send an API key in the x-api-key header. Or send a session cookie from the dashboard.Related.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }