Update Phone Flow
update_phone_flowReplaces the business's complete hosted phone flow, including ring members, hours, timeouts, and overflow routing, applying only actual differences.
Instructions
Replace how calls ring on the business's hosted phone system with a full phone flow: { version: 1, hours: { mode: 'always' | 'business_hours', afterHours: 'kai' }, ring: { members: [{ kind: 'cell', phone: E.164, label, requirePressOne } | { kind: 'desk_phone' | 'user', userId, label }], timeoutSeconds: 5-120 }, overflow: 'kai' }. Applied idempotently (only real differences are written); every member passes the forwarding-loop guard; business_hours mode derives the schedule from the business hours already on file. Because it replaces the whole flow, the input is the full flow as get_phone_flow returns it, with changes applied.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"flow": "<flow>"
},
"name": "update_phone_flow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | Yes | The complete phone flow to apply. | |
| business_id | No | Business ID (required when the token can access multiple businesses). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | ||
| error | No | Present when success is false | |
| changes | No | ||
| success | Yes | Whether the tool completed successfully | |
| readback | No |