Docs

DELETE /webhooks/{id}

Delete an endpoint and its queued deliveries.

Parameters

  • id path · string · required
  • Idempotency-Key header · string · optional — Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request).

Responses

  • 200 — Success
  • 400 — Validation error
  • 401 — Missing API key
  • 403 — Forbidden
  • 404 — Not found
  • 409 — Conflict
  • 429 — Rate limited
  • 500 — Internal server error

Response headers

  • ratelimit-limit — Messages this API key may spend in one 60-second window.
  • ratelimit-remaining — Messages left in the current window.
  • ratelimit-reset — Seconds until the current window resets and the budget refills.

200 body

FieldTypeRequiredNotes
deletedbooleanyes
idstringyes

Errors

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.

PreviousPATCH /webhooks/{id}NextGET /webhooks/{id}/dead-letters