Skip to main content
POST
Assign Agent to Number
See the phone numbers guide for inbound routing and agent assignment concepts.

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer YOUR_API_KEY

Path Parameters

uuid
string<uuid>
required

Body

application/json
agent_uuid
string<uuid>
required

The UUID of the agent to assign

version_id
string<uuid>

When assigning an agent, specifies which agent version to use. If not provided, uses the most recently updated version.

Example:

"456e7890-e89b-12d3-a456-426614174000"

Response

Successful Response

message
string
Last modified on September 3, 2026