Webhooks

Create webhook endpoint

Requires a workspace Management Token (mt-...), created at Dashboard > API > Management Tokens. Send Authorization: Bearer mt-.... Inference API keys (sk-...) and webhook signing secrets (whsec_...) are not accepted. Only the token workspace is accessible. The full whsec_ signing secret is returned only on creation or rotation. Store it securely; GET/list never return it. Rotation takes effect immediately for new deliveries; already in-flight deliveries can still use the previous secret. Up to 10 endpoints per workspace. Subscriptions cover future terminal async task events; existing tasks are not replayed.

post/v1/management/webhooks

Request

  • Base URL: https://api.tokenlab.sh
  • URL: https://api.tokenlab.sh/v1/management/webhooks
  • Auth: HTTP bearer

Request body

urlstring uri required

Public HTTPS receiver URL. Credentials, query strings, fragments, private or reserved network targets and redirects are rejected.

eventsstring[] required

Supported event subscriptions; duplicates are removed.

descriptionstring

Response

Create webhook endpoint result

idstring required
object'webhook_endpoint' required
urlstring required
eventsstring[] required
is_activeboolean required
descriptionstring nullable required
created_atstring date-time required
updated_atstring date-time required
last_delivered_atstring date-time nullable required
failure_countinteger required
secretstring required

Changes

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