Skip to navigation

Update a webhook endpoint

View as Markdown

Changes the address, the event types, the description, or pauses it (enabled: false).

Authentication

AuthorizationBearer

Skaitra API key (skt_…).

OR
AuthorizationBearer

OAuth 2.1 access token issued for the Skaitra resource (/mcp); see /.well-known/oauth-protected-resource.

Path parameters

idstringRequiredformat: "^whe_[a-f0-9]{32}$"

Headers

Idempotency-KeystringOptional<=200 characters

Any unique value; a retry with the same key returns the first result.

Request

This endpoint expects an object.
urlstringOptionalformat: "uri"<=2000 characters

An https:// address.

eventTypeslist of enums or "*"Optional
descriptionstring or nullOptional<=300 characters
enabledbooleanOptional

Response

OK
idstring
urlstring
descriptionstring or null
eventTypeslist of enums or "*"
enabledboolean
createdAtstring
lastSuccessAtstring or null
lastFailureAtstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
428
Precondition Error