API Reference
Webhooks

Fire a synthetic test delivery

POST
/v1/webhooks/{id}/test

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.

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

Header Parameters

Idempotency-Key?string

Optional client-supplied idempotency key. Accepted and logged; the test endpoint inserts a fresh delivery row per call (a new event_id is minted each time).

Lengthlength <= 64

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/test" \  -H "Content-Type: application/json" \  -d '{    "event_kind": "call.completed",    "payload": {      "call_id": "3f1c8a92-5b47-4e10-9d63-2a7e5c8b1f04",      "status": "completed"    }  }'
{  "delivery_id": "9892f438-d31c-4ff2-bc84-146525b292ff"}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}