Phone Number Assignment

Assign and manage phone numbers for assistant graphs

Phone numbers can be assigned to assistant graphs to enable multi-assistant orchestration for inbound calls. When a call comes in on an assigned phone number, it’s routed through the graph’s entry node.

List Graph Phone Numbers

Get all phone numbers currently assigned to a specific assistant graph.

graph_id · integer · required

The unique identifier of the graph.

Response

success · boolean

Whether the request was successful.

data · array

Array of phone number objects assigned to the graph.

message · string

Summary message with count of phone numbers.

List Phone Numbers

curl https://api.burki.dev/api/v1/assistant-graphs/1/phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY"

List Phone Numbers Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "phone_number": "[phone]",
      "friendly_name": "Main Support Line",
      "provider": "twilio",
      "is_active": true
    },
    {
      "id": 2,
      "phone_number": "[phone]",
      "friendly_name": "Sales Hotline",
      "provider": "twilio",
      "is_active": true
    }
  ],
  "message": "Found 2 phone numbers assigned to graph 'Customer Service Router'"
}

---

Assign Phone Number to Graph

Assign a phone number to an assistant graph. This enables the graph’s multi-assistant orchestration for calls to this number.

graph_id · integer · required

The unique identifier of the graph.

phone_number_id · integer · required

The unique identifier of the phone number to assign.

Response

success · boolean

Whether the assignment was successful.

message · string

Confirmation message.

data · object

Assignment details.

Show Data properties

graph_id · integer

The graph ID

phone_number_id · integer

The phone number ID

graph_name · string

Name of the graph

Assign Phone Number

curl -X POST https://api.burki.dev/api/v1/assistant-graphs/1/phone-numbers/5/assign \
  -H "Authorization: Bearer YOUR_API_KEY"

Assign Response

{
  "success": true,
  "message": "Phone number successfully assigned to graph 'Customer Service Router'",
  "data": {
    "graph_id": 1,
    "phone_number_id": 5,
    "graph_name": "Customer Service Router"
  }
}

Assigning a phone number to a graph overrides any previous assistant assignment. The phone number can only be assigned to either an individual assistant OR a graph, not both.

---

Unassign Phone Number from Graph

Remove a phone number from an assistant graph. The phone number remains in your organization but is no longer routed through the graph.

graph_id · integer · required

The unique identifier of the graph.

phone_number_id · integer · required

The unique identifier of the phone number to unassign.

Response

success · boolean

Whether the unassignment was successful.

message · string

Confirmation message.

data · object

Unassignment details.

Unassign Phone Number

curl -X POST https://api.burki.dev/api/v1/assistant-graphs/1/phone-numbers/5/unassign \
  -H "Authorization: Bearer YOUR_API_KEY"

Unassign Response

{
  "success": true,
  "message": "Phone number successfully unassigned from graph 'Customer Service Router'",
  "data": {
    "graph_id": 1,
    "phone_number_id": 5,
    "graph_name": "Customer Service Router"
  }
}

---

Assignment Behavior

When Assigning to a Graph

1. Previous Assignment Cleared: If the phone number was assigned to an individual assistant, that assignment is removed
2. Graph Entry Node: Incoming calls are routed to the graph’s entry node
3. Orchestration Enabled: Multi-assistant routing becomes active for this number

When Unassigning from a Graph

1. Routing Disabled: Calls to this number will no longer be handled by the graph
2. Re-assignment Required: The phone number must be assigned to either another graph or an individual assistant to handle calls
3. No Automatic Fallback: Unassigned numbers don’t automatically fall back to any default handler

---

Error Responses

Status Code	Description
400	Phone number assignment failed (e.g., already assigned elsewhere)
401	Unauthorized - Invalid or missing API key
404	Graph or phone number not found in your organization
500	Server error

To see all phone numbers in your organization (not just those assigned to a graph), use the Organization Phone Numbers endpoint.