Skip to main content
PATCH
/
v1
/
personas
/
{persona_id}
/
inbound
/
{phone_number}
/
settings
Update Persona Number Settings
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>"
  }
}
'
{
  "persona_settings": {
    "pathway_id": "pathway_abc123",
    "pathway_version": 2,
    "start_node_id": "node_xyz"
  }
}

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.

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

​
Response

​
data
object
The updated inbound number record.
​
errors
null|array
null on success, or a list of error objects if the request failed.
{
  "persona_settings": {
    "pathway_id": "pathway_abc123",
    "pathway_version": 2,
    "start_node_id": "node_xyz"
  }
}
Docs for agents: llms.txt