Webhooks

Delete a webhook subscription

Delete a subscription. The row is removed, not deactivated: its delivery history goes with it and becomes unreadable, and the signing secret is gone for good. To stop deliveries while keeping the history, PATCH isActive: false instead.

Accepts an Idempotency-Key; a retry with the same key replays the original response instead of answering 404 for the subscription the first attempt already deleted.

delete/webhooks/{webhookId}

Request

  • Base URL: https://inkseal.net/api/v1
  • URL: https://inkseal.net/api/v1/webhooks/{webhookId}
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes this mutation retry-safe. 1 to 255 printable ASCII characters (0x20 to 0x7e), trimmed before use. The key is scoped to the workspace and the credential that sent it. Reusing it with a different method, path, or payload answers 422 idempotency_key_reuse. A completed attempt replays its stored status and body with an Idempotent-Replay: true response header; 5xx, 429, and non-JSON answers leave the key retryable. A concurrent request holding the 90 second lease answers 409 idempotency_in_progress. Records are retained 24 hours.

Response

The subscription is gone.

Example response

{
  "data": {
    "deleted": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.