---
title: "Generate Conversational Token"
method: POST
path: "/v1/conversational/token"
tags: ["v1"]
---

# Generate Conversational Token

`POST /v1/conversational/token`

Generate a token for joining conversational AI voice calls.

This endpoint creates a JWT token that allows users to join a LiveKit room
where they can interact with conversational AI voice agents.

Parameters:
- workflow: The workflow identifier for the AI agent
- draft: Whether to use the draft version of the workflow
- dynamic_variables: Variables to pass to the workflow
- identity: User identity (defaults to 'voice_assistant_user')
- metadata: Additional metadata to include in the token

## Request body

- ConversationalTokenRequest — Request schema for generating a LiveKit token for AI voice calls.
  - `agent_config` AgentConfig
    - `raw` string — Raw agent configuration in YAML format
    - `json` object — Agent configuration as dictionary/JSON format
    - `url` string — URL that points to agent configuration in YAML format
    - `app` AppAgentConfig
      - `app_id` string, required — App ID
      - `path` string — Path to the app
  - `identity` string — User identity (defaults to 'voice_assistant_user')
  - `metadata` object — Additional metadata to include in the token

## Response `200`

Successful Response

- ConversationalTokenResponse — Response schema for LiveKit token generation.
  - `server_url` string, required — LiveKit server URL
  - `room_name` string, required — Room name to join
  - `participant_token` string, required — JWT token for authentication

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/uberduck/apis/uberduck-text-to-speech-api.md) · [All operations](https://skmtc.dev/uberduck/apis/uberduck-text-to-speech-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uberduck/uberduck-text-to-speech-api/revisions/fbf2fc6fd0ae/schema)