---
title: "Have the agent call a phone number as a live test"
method: POST
path: "/v1/agents/{id}/test-call"
---

# Have the agent call a phone number as a live test

`POST /v1/agents/{id}/test-call`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/agents/{id}/test-call`
- Auth: HTTP bearer

Calls you back from your own agent - the same price and the same rules as `POST /v1/calls`, no discount and no special rate. An agent on volai's own voice engine calls even WITHOUT an assigned number - from the shared volai line, so the recipient sees volai's number, not yours. Assign an existing agent its own number through `PATCH /v1/numbers/{e164}` (routing `agent`) or the `numberE164` field on the agent (`POST`/`PATCH /v1/agents`), or in the portal's Numbers section.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `to` string, required: Phone number to receive a real, billed test call from the published agent. This does not test an unpublished draft.

## Response `200`

Created test call

- object
  - `id` string, required
  - `status` 'initiated' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'missed' | 'no_answer', required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `402`: Error codes: insufficient_credit (account), subscription_cap_reached (account).
- `403`: Error codes: account_suspended (account), agent_suspended (account).
- `404`: Error codes: agent_not_found (account), agent_no_number (account).
- `409`: Error codes: idempotency_in_progress (busy).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `503`: Error codes: capacity_busy (busy).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)