PATCH
/
phone
/
{phone_agent_id}
curl --request PATCH \
  --url http://localhost:8080/phone/{phone_agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "type": "inbound",
  "language": "<string>",
  "accent": "<string>",
  "handoff_phone_number": "<string>",
  "speed": 1,
  "interruptible": true,
  "actionIds": [
    "<string>"
  ],
  "instructions": [
    "<string>"
  ],
  "data_collection_fields": [
    "<string>"
  ],
  "data_collection_webhook_url": "<string>",
  "voice_id": "<string>",
  "first_message": "<string>",
  "flow": {
    "id": "<string>",
    "type": "root",
    "content": "<string>",
    "connectionType": "true",
    "position": {
      "x": 123,
      "y": 123
    },
    "children": [
      {
        "id": "<string>",
        "type": "root",
        "content": "<string>",
        "connectionType": "true",
        "position": {
          "x": 123,
          "y": 123
        },
        "children": [
          {
            "id": "<string>",
            "type": "root",
            "content": "<string>",
            "connectionType": "true",
            "position": {
              "x": 123,
              "y": 123
            },
            "children": [
              "<any>"
            ]
          }
        ]
      }
    ]
  },
  "use_org_knowledgebase": true
}'
This response has no body data.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
phone_agent_id
string
required

Body

application/json
​
flow
object | null
required
​
name
string
​
type
enum<string>
Available options:
inbound,
outbound
​
language
string | null

The language the AI phone agent should mainly speak in

​
accent
string | null

The accent the AI phone agent should mainly speak in

​
handoff_phone_number
string | null

The phone number of the human agent to hand off the call to

​
speed
number | null
default:1

The speed of the AI phone agent

​
interruptible
boolean

Whether the agent can be interrupted or not

​
actionIds
string[] | null

A list of action ids the AI phone agent has access to. A null value means all actions. An empty list means no actions

​
instructions
string[] | null

A list of instructions

​
data_collection_fields
string[] | null

A list of fields to collect data about

​
data_collection_webhook_url
string | null

The webhook url to send the collected data to

​
voice_id
string | null

The voice id

​
first_message
string | null

The first message the AI phone agent should say

​
use_org_knowledgebase
boolean | null

Whether the AI phone agent should use the organization's knowledgebase (enabling it will increase the latency of the agent)

Was this page helpful?

List AI phone agentsDelete an AI phone agent