Skip to main content
GET
Get Agent Number Binding

Overview

Returns the agent’s inbound number binding. persona_id is null until the first successful Attach Numbers to Agent call. numbers lists the numbers attached to the agent and the environment each one answers on. An unknown agent ID returns persona_id: null rather than 404.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Response

string
The agent ID from the request path, echoed back.
string | null
ID of the persona that attached numbers route through. Bland creates it on the first attach and keeps it afterwards, so it stays set even after every number is detached. null if numbers have never been attached to this agent.
string | null
ID of the pathway Bland compiles from the agent for its attached numbers. Text conversations that the agent handles on these numbers record this ID as their pathway ID. Like persona_id, it stays set after every number is detached. Setting a migration split above 0 for this agent also creates it, so it can be set while persona_id is null. null until one of these happens.
array
The numbers attached to the agent, newest first. Empty when no number is attached.
boolean
false when your account runs on dedicated infrastructure, where numbers can’t be attached to staging. Attaching to staging also requires an enterprise plan, which this field does not check.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt