retell_update_phone_number
Modify phone number settings in Retell AI, including agent assignments for inbound and outbound calls, and update the nickname.
Instructions
Update settings for a phone number including assigned agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone_number | Yes | The phone number in E.164 format to update | |
| inbound_agent_id | No | New agent ID for inbound calls (null to remove) | |
| outbound_agent_id | No | New agent ID for outbound calls (null to remove) | |
| nickname | No | New nickname for the phone number |
Implementation Reference
- src/index.ts:1159-1162 (handler)Handler implementation in the executeTool switch statement. Extracts phone_number from args, encodes it, and sends a PATCH request to Retell API endpoint `/update-phone-number/{phone_number}` with remaining update data.
case "retell_update_phone_number": { const { phone_number, ...phoneUpdateData } = args; return retellRequest(`/update-phone-number/${encodeURIComponent(phone_number as string)}`, "PATCH", phoneUpdateData as Record<string, unknown>); } - src/index.ts:362-385 (schema)Tool schema definition including name, description, and inputSchema with properties for phone_number (required), inbound_agent_id, outbound_agent_id, and nickname.
name: "retell_update_phone_number", description: "Update settings for a phone number including assigned agents.", inputSchema: { type: "object", properties: { phone_number: { type: "string", description: "The phone number in E.164 format to update" }, inbound_agent_id: { type: "string", description: "New agent ID for inbound calls (null to remove)" }, outbound_agent_id: { type: "string", description: "New agent ID for outbound calls (null to remove)" }, nickname: { type: "string", description: "New nickname for the phone number" } }, required: ["phone_number"] } - src/index.ts:1283-1285 (registration)Registration of the ListToolsRequestHandler which returns the tools array containing this tool's schema.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });