Skip to main content
PUT
Assign an agent to a DID

Authorizations

Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Path Parameters

id
string<uuid>
required

Phone number ID from GET /phone-numbers.

Body

application/json
agent_id
string<uuid> | null

Agent ID to assign. Use null or an empty string to clear assignment. If inbound_enabled is omitted, assigning an agent enables inbound routing and clearing the agent disables it.

inbound_enabled
boolean

Whether this DID should receive inbound calls for the assigned agent. Set false to keep the row available for outbound caller ID use only.

friendly_name
string | null
Maximum string length: 200
status
enum<string>
Available options:
ACTIVE,
INACTIVE

Response

Phone number updated.

success
boolean
data
object

Imported carrier DID managed through the V2 phone-numbers API.