Skip to main content
PATCH
Pick the agent that answers

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Path Parameters

phone_number_id
string
required

Body

application/json
agent_id
string | null
Example:

"billing"

Response

OK

One of the org's numbers on Eager. Calls to it are answered by its agent's published version, out loud, with its tools.

object
string
required
Allowed value: "phone_number"
id
string
required
Example:

"pn_3f9a0c1d2e4b5a6978c1d2e3"

number
string
required

E.164.

Example:

"+14155550123"

display
string
required
Example:

"(415) 555-0123"

agent_id
string | null
required

The agent that answers it; null: not answered.

Example:

"billing"

connection_id
string
required
status
enum<string>
required
Available options:
active,
released
created_at
string<date-time>
required
name
string | null

Its friendly name in Twilio.

Example:

"Front desk"

connection_name
string | null