Place a one-off AI agent call
The single-call primitive: dials one number, composing the agent's
base_prompt with the per-call prompt_template (+ variables),
bypassing broadcast schedule/retry machinery. Billed normally;
occupies a concurrency seat like any broadcast dial. The caller-ID is
the workspace's own dialable number (422 send.no_caller_number if
none). Pass revision to compose against a pinned published
revision instead of the mutable draft.
Authorization
bearerAuth 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
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/send" \ -H "Content-Type: application/json" \ -d '{ "to": "+254712345678", "prompt_template": "Remind {{name}} their appointment is on {{date}}.", "variables": { "name": "Alice", "date": "Tuesday 10am" } }'{ "call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e", "agent_revision": 0, "warnings": [ "string" ]}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}