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

# Update Persona Number Settings

> Update persona-specific settings for a phone number attached to a persona. Use this to configure per-number pathway overrides while still using the persona's base configuration.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**persona\_id** `string` *required*

The unique identifier of the persona the phone number is attached to.

**phone\_number** `string` *required*

The E.164 formatted phone number to update settings for. This number must currently be attached to the specified persona.

### Body Parameters

**persona\_settings** `object | null` *required*

Persona-specific settings for this phone number. Pass `null` to clear all per-number settings and fall back to the persona's defaults.

**persona\_settings object**

**pathway\_id** `string`

Override the persona's default pathway with a specific pathway for calls/messages on this number.

**pathway\_version** `number`

Specific version of the pathway to use.

**start\_node\_id** `string`

Specific node within the pathway to start from.

### Response

**data** `object`

The updated inbound number record.

**inbound number object**

**id** `number`

Internal ID of the inbound number record.

**phone\_number** `string`

The E.164 formatted phone number.

**persona\_id** `string`

The persona this number is attached to.

**persona\_settings** `object`

The updated persona settings for this number, or `null` if cleared.

**updated\_at** `string`

ISO 8601 timestamp of when the record was last modified.

**errors** `null|array`

`null` on success, or a list of error objects if the request failed.

```json Request (Set pathway override) theme={null}
{
  "persona_settings": {
    "pathway_id": "pathway_abc123",
    "pathway_version": 2,
    "start_node_id": "node_xyz"
  }
}
```

```json Response (Success) theme={null}
{
  "data": {
    "id": 42,
    "phone_number": "+14155551234",
    "persona_id": "12345678-1234-1234-1234-123456789012",
    "persona_settings": {
      "pathway_id": "pathway_abc123",
      "pathway_version": 2,
      "start_node_id": "node_xyz"
    },
    "updated_at": "2025-09-23T16:00:00.000Z"
  },
  "errors": null
}
```

```json Request (Clear settings) theme={null}
{
  "persona_settings": null
}
```

```json Error Response (Number not attached to persona) theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "INBOUND_NOT_FOUND",
      "message": "Inbound number not found or not attached to this persona"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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