First Leeward

Webhooks

Update webhook endpoint

PATCHhttps://api.firstleeward.com/v0/webhooks/:id

Update mutable fields (name, url). To rotate the signing secret, use POST /:id/rotate-secret. To disable, use POST /:id/disable.

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

Body

application/json

namestring

Updated label.

urlstring<uri>

New HTTPS endpoint.

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

400Webhook URL is invalid - must be HTTPS and resolve to a public address
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
404Webhook not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired