---
title: "Operate live voice agents: publish, pause, change routing, connect webhook destinations, retry handoffs or call the v..."
method: POST
path: "/api/mcp/tools/execute_voice"
tags: ["tools"]
---

# Operate live voice agents: publish, pause, change routing, connect webhook destinations, retry handoffs or call the v...

`POST /api/mcp/tools/execute_voice`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/execute_voice`
- Auth: HTTP bearer

Operate live voice agents: publish, pause, change routing, connect webhook destinations, retry handoffs or call the verified owner. Can spend money and reach external systems. Requires the user's authorization; a queued/accepted handoff is not customer delivery. Discover exact parameters with get_voice_capabilities first.

## Request body

- object
  - `operation` 'connections.retry' | 'connections.status' | 'phone.call_owner' | 'phone.connect' | 'profiles.control' | 'profiles.publish' | 'service.configure' | 'service.reconcile' | 'webhook.configure' | 'webhook.retry', required
  - `parameters` object

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)