Webhooks

Disable webhook endpoint

POSThttps://api.firstleeward.com/v0/webhooks/:id/disable

Permanently disable an async webhook endpoint. One-way operation: disabled endpoints cannot be reactivated. Create a new webhook to resume delivery to the same URL. Idempotent: re-disabling an already-disabled webhook is a no-op. REQUEST-mode endpoints are synchronous and rotate-only; they cannot be disabled.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

idstring<uuid>required

Webhook ID

Response

200Webhook endpoint configuration. The signing secret is never included in this response; it is only returned once at create and at rotate-secret time.
idstring<uuid>required

Unique webhook identifier

namestringrequired

Human-readable label

urlstringrequired

HTTPS endpoint that receives signed POSTs

statusstringrequired

Lifecycle status. Disabled webhooks receive no deliveries.

Available options:ACTIVEDISABLED
modestringrequired

Interaction pattern of the endpoint.

Available options:NOTIFICATIONREQUEST
lastUsedAtstring<date-time> | nullrequired

Timestamp of the most recent successful delivery

createdAtstring<date-time>required

ISO 8601 creation timestamp

updatedAtstring<date-time>required

ISO 8601 last update timestamp

404Webhook not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
409A REQUEST-mode webhook is synchronous and rotate-only; it cannot be disabled. Update its URL or secret in place instead.
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired