---
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

---

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