Skip to main content
Changes state - verify before retry Turns shared outbound on or off for one of the organization’s phone numbers. On: several agents can be linked to dial from it (add_agent_phone_number, direction outbound), its inbound agent is detached, and each inbound call goes to the agent that most recently called the caller from this number and is still linked to it. A caller no linked agent has called is not answered. A default number never answers inbound calls, shared or not. Turning it on also names the number’s outbound agent on any workflow voice call step from it that names none, so the step keeps calling as that agent. Confirm with the user before turning it on, since the inbound agent stops answering. Off is refused while more than one agent dials from it; detach the others first. Refused while an inbound call is live on the number.

Parameters

Complete input schema

Registered output schema

Before you call

  • Connect and initialize the MCP client with OAuth or an API key for the intended workspace.
  • Provide the required parameters: phone_number_id, enabled.
  • If your OAuth grant covers several workspaces, also pass organization_id with the workspace to act in, from List My Organizations.

Example MCP request

Send tools/call after your client completes MCP initialization. Replace placeholder values with IDs and inputs from your workspace. For object and array parameters, follow the nested requirements in the parameter description instead of treating an empty value as complete.
Successful results include structuredContent and a text content block containing the same JSON. Check isError first, then read structuredContent or parse content[0].text. See MCP responses and errors for the full envelope and failure behavior.

Verify the result

Confirm the response is not marked isError. Call List Organization Phone Numbers to read the affected resource. Verify that the intended state is visible before making another change.

Retry safety

This tool changes workspace state. After a timeout, read the affected resource before retrying so you do not create duplicate or conflicting changes.