Webhooks

Set the project's webhook endpoint

Registers (or replaces) the endpoint + the events it should receive (omit events to subscribe to all). The first call for a project returns a signing secret (shown once); a later call that changes the URL or the event list returns secret: null and leaves the existing secret in place, so your signature check keeps working across an edit. Replace it deliberately with POST /v1/webhook/secret. Each delivery is POSTed with an X-Tessio-Event header and an X-Tessio-Signature: t=<unix>,v1=<hex hmac-sha256(secret, "{t}.{body}")> header so you can verify it. Deliveries retry with backoff; GET /v1/age-checks/{id} stays the reliable fallback.

put/v1/webhook

Request

  • Base URL: https://api.tessio.eu
  • URL: https://api.tessio.eu/v1/webhook
  • Auth: HTTP bearer

Request body

urlstring uri required

Absolute https URL to receive events. Any other scheme is refused: http with insecure_url, the rest with invalid_url.

eventsWebhookEventType[]

Event types to receive. Omit (or empty) to subscribe to all.

Response

Endpoint set (secret returned once, only when created)

urlstring uri
eventsWebhookEventType[]
secretstring nullable

Signing secret (whsec_…), shown once, store it to verify X-Tessio-Signature. Present when the call created the endpoint; null when it changed one that already had a secret, because editing the URL or the event list leaves the secret in place so your signature check keeps working. Ask for a replacement with POST /v1/webhook/secret.

Changes

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