---
title: "V1 Voice Ephemeral Token"
method: POST
path: "/v1/voice/ephemeral-token"
tags: ["public-api"]
---

# V1 Voice Ephemeral Token

`POST /v1/voice/ephemeral-token`

## Request

- Base URL: `https://api.palisade.run` (the document declares no server; this is the origin it was published from)
- URL: `https://api.palisade.run/v1/voice/ephemeral-token`
- Auth: none declared

Mint a single-use Gemini Live ephemeral token plus voice config.

## Query parameters

- `k` string, nullable

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable

## Request body

- V1VoiceTokenRequest
  - `conversation_history` V1ChatMessage[]
    - `role` string, required: 'user' or 'assistant'
    - `content` string, required
    - `properties` object[], nullable
    - `result_set_id` string, nullable
    - `result_set_property_ids` integer[], nullable
    - `result_set_count` integer, nullable
  - `page_context` object, nullable
  - `conversation_id` string, nullable
  - `navigation_enabled` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/palisade-run/apis/twiddy-chatbot-api.md) - [All operations](https://skmtc.dev/palisade-run/apis/twiddy-chatbot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/palisade-run/apis/twiddy-chatbot-api/revisions/80ab7d8068c0?raw)