Skip to main content
PUT
Assign or reassign an external trunk to an agent

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json
phone_number
string
required

Identifier for the trunk being reassigned. Together with channel, locates exactly one trunk row. The phone number itself is unchanged by this call.

Example:

"+12345678901"

channel
enum<string>
required

Channel of the trunk being reassigned. To reassign a multi-channel trunk completely, call this once per channel.

Available options:
call,
whatsapp
agent_uuid
string<uuid>
required

UUID of the agent that should own the trunk going forward. Same value as agent_uuid in /api/v1/agents/{uuid} endpoints.

Response

Assigned

success
boolean

Indicates whether the request completed successfully. True for successful responses; false for documented error responses.

message
string

Human-readable response message. Safe to display in logs or simple client notifications; use structured fields for program logic.

data
object

Per-channel snapshot returned by /phone-numbers/{uuid}/channels, /phone-numbers/channels?number=…, and the trunk create/update/assign endpoints. Combines capability (what the carrier supports), state (what's enabled), and binding (which agent is wired up).