---
title: "Create Conversation Token"
method: POST
path: "/auth/conversation_token"
tags: ["auth"]
---

# Create Conversation Token

`POST /auth/conversation_token`

Creates a short-lived conversation token scoped to a specific agent. Conversation tokens are useful for client-side applications that start a conversation with a single agent without exposing your API key.

## Headers

- `Authorization` string, required

## Request body

- CreateConversationTokenRequest
  - `agent_id` string, required — ID of the agent the conversation token is scoped to.
  - `ttl_seconds` integer — Time-to-live for the conversation token in seconds.

## Response `200`

Success response

- AuthCreateConversationTokenResponse200
  - `conversation_token` string, required — The conversation token to use for authentication.
  - `expires_at` string, date-time, required — When the conversation token expires.

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized (authentication missing or invalid)
- `403` — Forbidden (only API keys can create conversation tokens)
- `404` — Agent not found
- `500` — Internal server error

## Changes

- **2026-08-22** `7f8c81a5a990` — 2 warning
  - the `ttl_seconds` request property's max was set to `60.00`
  - the `ttl_seconds` request property's min was set to `30.00`

[Change history](https://skmtc.dev/phonic/apis/api-reference/changes/auth/conversation_token/post.md)

---

[API](https://skmtc.dev/phonic/apis/api-reference.md) · [All operations](https://skmtc.dev/phonic/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phonic/api-reference/revisions/832fc781c60e/schema)