Place a call - through an agent, as a bridge, or a trial call

Place one billed call. Send exactly one of agentId (your agent with an attached number), from (bridge: rings from first, then to), or systemPrompt (trial from a shared demo number). Only the agent variant accepts variables. Ringing timeout is 5-60 seconds for an agent and 5-30 for a trial, default 25. A successful response means placement started; read GET /v1/calls/{id} or wait for a webhook to learn the actual outcome. Trial calls require a verified account and have separate usage limits.

post/v1/calls

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/calls
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional key for one logical request. Its scope is global to this API key, independent of the HTTP method, path, or body: use a new value for every distinct logical action across all endpoints and request bodies, and reuse it only to retry the exact same logical request. Reusing a non-blank key within 24 hours returns the stored response; a concurrent request with the same key returns 409 idempotency_in_progress. A missing or whitespace-only value disables idempotency.

Request body

OR
OR

Response

Created call

idstring required
status'initiated' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'missed' | 'no_answer' required
trialboolean
fromstring

Changes

No recorded changes to this operation across all 1 revision of this API.