> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Phone Number Shared Outbound

> Use the update_phone_number_shared_outbound MCP tool on the DialNexa remote MCP server.

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

| Name | Type | Required | Description |
| - | - | - | - |
| `phone_number_id` | `string` | Yes | The phone number ID, e.g. phn\_abc123 |
| `enabled` | `boolean` | Yes | true to share the number between agents, false to go back to one outbound agent |

## Complete input schema

```json theme={null}
{
  "type": "object",
  "properties": {
    "phone_number_id": {
      "type": "string",
      "description": "The phone number ID, e.g. phn_abc123"
    },
    "enabled": {
      "type": "boolean",
      "description": "true to share the number between agents, false to go back to one outbound agent"
    }
  },
  "required": [
    "phone_number_id",
    "enabled"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
```

## Registered output schema

```json theme={null}
{
  "type": "object",
  "properties": {
    "id": {
      "description": "The phone number id, prefixed phn_"
    },
    "shared_outbound": {
      "description": "The new setting"
    },
    "outbound_agent_ids": {
      "description": "Every agent that dials from this number (agent_ prefixed)"
    },
    "detached_inbound_agent_id": {
      "description": "The inbound agent detached by turning sharing on, or null"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/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](https://dialnexa.com/docs/mcp-tools/organization/list-my-organizations.md).

## 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.

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_phone_number_shared_outbound",
    "arguments": {
      "phone_number_id": "phn_abc123",
      "enabled": true
    }
  }
}
```

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](https://dialnexa.com/docs/mcp-tools/errors.md) for the full envelope and failure behavior.

## Verify the result

Confirm the response is not marked `isError`. Call [List Organization Phone Numbers](https://dialnexa.com/docs/mcp-tools/phone-numbers/list-organization-phone-numbers.md) 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.

## Related MCP tools

* [Attach Phone Number To Agent](https://dialnexa.com/docs/mcp-tools/phone-numbers/add-agent-phone-number.md): `add_agent_phone_number`
* [List Organization Phone Numbers](https://dialnexa.com/docs/mcp-tools/phone-numbers/list-organization-phone-numbers.md): `list_organization_phone_numbers`
* [Get Organization Phone Number](https://dialnexa.com/docs/mcp-tools/phone-numbers/get-organization-phone-number.md): `get_organization_phone_number`

## Related guides

* [Connect to the DialNexa MCP server](https://dialnexa.com/docs/mcp-tools/overview.md)
* [Phone Numbers MCP tools](https://dialnexa.com/docs/mcp-tools/phone-numbers/overview.md)
* [MCP responses and errors](https://dialnexa.com/docs/mcp-tools/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.