Skip to main content
PUT
/
phone-numbers
/
{id}
Assign an agent to a DID
curl --request PUT \
  --url https://api.vocobase.com/api/v2/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'
{ "success": true, "data": { "id": "f1a2c3d4-1111-2222-3333-444455556666", "phone_number": "+918065480085", "provider": "VOBIZ", "friendly_name": null, "status": "ACTIVE", "is_default": false, "agent": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Inbound Test Agent" } } }

Documentation Index

Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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.