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.

PATCH /v1/personas/{persona_id}/inbound/{phone_number}/settings

Update Persona Number Settings

cURL

curl --request PATCH \
  --url https://api.bland.ai/v1/personas/{persona_id}/inbound/{phone_number}/settings \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "persona_settings": {
    "pathway_id": "<string>",
    "pathway_version": 123,
    "start_node_id": "<string>"
  }
}
'

Request (Set pathway override)

{
  "persona_settings": {
    "pathway_id": "pathway_abc123",
    "pathway_version": 2,
    "start_node_id": "node_xyz"
  }
}

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.

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

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

Request (Set pathway override)

{
  "persona_settings": {
    "pathway_id": "pathway_abc123",
    "pathway_version": 2,
    "start_node_id": "node_xyz"
  }
}

---

Docs for agents: llms.txt