---
title: "Talk to the call"
method: POST
path: "/calls/{id}/talk"
tags: ["Call"]
---

# Talk to the call

`POST /calls/{id}/talk`

Initiates a talking action to the call.

## Path parameters

- `id` string, required

## Request body

- object
  - `text` string
  - `language` string
  - `provider` string — TTS provider to use (gcp or aws). If empty, defaults to GCP. If the selected provider fails, the system falls back to the alternative provider with the default voice for the language.
  - `voice_id` string — Provider-specific voice ID. If empty, uses the default voice for the given language. On fallback, the voice_id is reset to the alternative provider's default.

## Response `200`

The result of the talk action.

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `409` — State conflict (ALREADY_EXISTS or FAILED_PRECONDITION).
- `500` — Internal error (INTERNAL).
- `503` — Upstream unavailable (UNAVAILABLE).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)