Skip to main content
POST
/
v1
/
personas
/
{persona_id}
/
inbound
/
detach
Detach Phone Numbers from Persona
curl --request POST \
  --url https://api.bland.ai/v1/personas/{persona_id}/inbound/detach \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "inbound_numbers": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Support Agent",
    "user_id": "12345678-1234-1234-1234-123456789012",
    "inbound_numbers": [],
    "created_at": "2025-09-23T15:13:36.348Z",
    "updated_at": "2025-09-23T15:20:00.000Z"
  },
  "errors": null
}

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

persona_id
string
required
The unique identifier of the persona to detach numbers from.

Body Parameters

inbound_numbers
string[]
required
Array of E.164 formatted phone numbers to detach from this persona. Only numbers currently attached to this persona will be affected.

Response

data
object
The updated persona object after detaching the specified numbers.
errors
null|array
null on success, or a list of error objects if the request failed.
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Support Agent",
    "user_id": "12345678-1234-1234-1234-123456789012",
    "inbound_numbers": [],
    "created_at": "2025-09-23T15:13:36.348Z",
    "updated_at": "2025-09-23T15:20:00.000Z"
  },
  "errors": null
}