Skip to main content
PATCH
/
phone
/
{phone_agent_id}
Update an AI phone agent
curl --request PATCH \
  --url https://api.open.cx/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": "<any>",
  "use_org_knowledgebase": true,
  "manual_mode": true,
  "custom_llm": "<string>"
}'
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
​
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

​
flow
any
​
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)

​
manual_mode
boolean | null

Whether the AI phone agent should be in manual mode

​
custom_llm
string | null

The custom LLM to use for the AI phone agent

⌘I