DELETE https://xquik.com/api/v1/webhooks/{id}
Free. This endpoint does not consume credits.
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
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 theRetry-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 }