---
title: "V1 Voice Tool"
method: POST
path: "/v1/voice/tool"
tags: ["public-api"]
---

# V1 Voice Tool

`POST /v1/voice/tool`

## 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/tool`
- Auth: none declared

Execute a Gemini-requested tool call using the shared chat handlers.

## Query parameters

- `k` string, nullable

## Headers

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

## Request body

- V1VoiceToolRequest
  - `tool_name` string, required: Name of the tool Gemini asked to call
  - `args` object
  - `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
  - `conversation_id` string, nullable
  - `page_context` object, nullable
  - `navigation_enabled` boolean, nullable
  - `user_message` string, nullable: Latest user utterance (used by request_human_agent, etc.)

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