Send a call

POST 
/v1/calls

Place one outbound call. Provide exactly one of task (a freeform prompt) or pathway_id (a stored flow from GET /pathways). The call is queued and dialed immediately; poll GET /calls/{id} for its status and results.

Request

Responses

201

400

Invalid request (e.g. neither/both of task/pathway_id, or the pathway has no active version).

401

Missing, invalid, revoked, or expired API key.

403

The key lacks the calls:write scope, or the number has opted out.

404

Unknown pathway_id or from_number_id for this organization.

429

Rate limit exceeded.

502

The voice provider failed to place the call.