API Reference
Webhooks

List recent deliveries for a subscription

GET
/v1/webhooks/{id}/deliveries

Cursor-paginated, newest first. Optional status filter.

Authorization

bearerAuth
AuthorizationBearer <token>

Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the platform keyring. Carries workspace_id and scopes claims; revoked via the platform deny-list.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

cursor?string
limit?integer
Range1 <= value <= 100
status?string

Value in

  • "pending"
  • "succeeded"
  • "failed"
  • "dead_letter"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/deliveries"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627",      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",      "event_kind": "string",      "event_id": "a7a26ff2-e851-45b6-9634-d595f45458b7",      "status": "pending",      "attempt_count": 0,      "last_status_code": 0,      "last_error": "string",      "last_attempted_at": "2019-08-24T14:15:22Z",      "next_attempt_at": "2019-08-24T14:15:22Z",      "tag": "string",      "created_at": "2019-08-24T14:15:22Z",      "delivered_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}

Fire a synthetic test delivery POST

Enqueues a one-shot delivery against this subscription tagged `tag=test`. Useful from the dashboard "Send test event" button. Optional `event_kind` defaults to `call.completed`; optional `payload` defaults to a canned synthetic envelope.

OpenAPI catalog (YAML) GET

Next Page