---
title: "Create Speech Task"
method: POST
path: "/api/v1/sessions/{id}/tasks"
---

# Create Speech Task

`POST /api/v1/sessions/{id}/tasks`

## Request

- Base URL: `https://api.avaturn.live`
- URL: `https://api.avaturn.live/api/v1/sessions/{id}/tasks`
- Auth: HTTP bearer

Adds the text to the avatar speech queue.
If the avatar is already speaking, the text fragment is queued to be spoken at a later time.
Nothing is said until you connect or while you're disconnected.

## Path parameters

- `id` string, required: Session ID

## Request body

- BodyAppendTextApiV1SessionsIdTasksPost
  - `text` string, required: Text to say

## Response `200`

Successful Response

- SessionSayResponse
  - `task_id` string, required: Speech task ID

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/avaturn-live/apis/avaturn-live-api.md) - [All operations](https://skmtc.dev/avaturn-live/apis/avaturn-live-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avaturn-live/apis/avaturn-live-api/revisions/e142c11ac753?raw)