PayPilot API
Live demoGitHub
HomeGuidesSDKsContext PluginAPI Reference
Voice

Run one voice tool directly

POST
/api/v1/voice/tool

Executes a single tool against the same registry the web agents use. Authenticated with the short-lived voice session token; never anonymous.

Header Parameters

authorization?string|null

Request Body

application/json

Vapi server-tool webhook payload (normalised).

arguments?
call_id?string|null
merchant_id?|
Formatuuid
tool*string
Lengthlength <= 64

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/voice/tool" \  -H "Content-Type: application/json" \  -d '{    "tool": "string"  }'
{  "data": {    "agent_run_id": "c3317f32-e28b-4af1-a584-86ac8c788dd8",    "data": {},    "result": "string"  },  "meta": {},  "success": true}

Push this backend's tools and prompt onto the live Vapi assistant POST

The assistant's tools and system prompt live on Vapi's platform, not in this backend - adding a tool here (e.g. navigate_page) does nothing to the assistant Vapi actually runs until it is pushed there. This does that: it fetches the configured assistant, replaces its system message and tool list with this backend's VOICE_TOOLS and SYSTEM_PROMPT, and leaves its provider, model and voice untouched. Runs automatically at startup; call it again after editing a voice tool without restarting the server.