Numbers
Release a tenant number
Marks the number released, returns the DID to the available pool,
and emits a number.released event. Idempotent —
re-releasing a released number returns 204 with no event.
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
Format
uuidResponse Body
application/json
curl -X DELETE "https://example.com/v1/numbers/497f6eca-6276-4993-bfeb-53cbbbba6f08"Empty
{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}Get a single tenant number by id GET
Previous Page
Update a tenant number's routing config PUT
Patches `voice_callback_url` and/or `events_url` on a number's routing config. Both fields accept http or https; empty string clears the field; omitted fields are left untouched. The `Idempotency-Key` header is honoured for replay safety.