Disable a webhook
Deactivates the endpoint (is_active: false, disabled_reason: manual). Pending deliveries are
canceled when due (last_error: endpoint_disabled) instead of being sent. Events continue to be
stored while the endpoint is disabled and can be replayed after POST /api/webhooks/{webhookId}/enable.
No body.
Idempotency. Safe to retry.
Access
- Required scope:
full. Human users need the owner or admin role. - Rate limit: General API (120–600 requests/min per workspace, by plan) plus the configuration-mutations limit — 10 requests/min per workspace, shared with other configuration changes. See Rate limits.
- Plan: Requires an active subscription (
active,trialingorpast_due); without one the request is refused with403 BILLING_ERROR(metadata.kind: subscription_required). See Billing and usage.
Authentication
Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the
dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once,
at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.
Operations restricted to admins or owners reject keys without the full scope with 403, and say so in
their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret —
that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds.
See Authentication.
Path parameters
UUID of the outbound webhook endpoint, returned as id by GET /api/webhooks. It must belong to the authenticated workspace; an id from another workspace, an unknown id or a value that is not a UUID answers 404.
Response
An outbound webhook endpoint as returned by the API. The signing secret is never included; it is
returned once by POST /api/webhooks (as an additional secret field) and by rotate-secret.
Custom headers keep their names, but every value is "[configured]". Members below admin (and
API keys without the full scope) see only the origin of url.

