/
PO
poly
/
PolyAI Agents API
Search skmtc…
⌘K
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Subscribe
v1
latest
OpenAPI 3.1.0
2026-07-26
87
120
159.0 KB
Agents
List agents
get
/v1/accounts/{accountId}/agents
Response
List of agents for the current account
object[]
required
accountId
string
required
agentId
string
required
agentName
string
required
createdAt
string
required
updatedAt
string
required
branchCount
number
required
All 87 operations
get
List agents
post
Create agent
delete
Delete agent
post
Duplicate agent
post
Bulk delete cached audio entries
delete
Delete a cached audio entry
get
Download cached audio file
patch
Replace cached audio file
get
List cached audio entries
post
Synthesize audio preview
put
Replace audio file and voice tuning settings
get
Get agent behavior rules
patch
Update agent behavior rules
get
List branches
post
Create branch
delete
Delete branch
post
Merge branch
post
Batch get connectors by ID
patch
Batch update connectors
get
Get a connector by ID
delete
Delete a connector and its phone numbers
patch
Update a connector
get
List all connectors for a project
post
Look up connector by phone number
get
Get active deployment per environment
get
List deployments for an environment
post
Promote a deployment to the next environment
post
Publish the current draft to an environment
post
Rollback to a previous deployment
get
List knowledge base topics
post
Create knowledge base topic
get
Get knowledge base topic
delete
Delete knowledge base topic
patch
Update knowledge base topic
get
Get the status of an outbound call
post
Trigger an outbound call
post
Batch get phone numbers
get
Get a specific phone number
post
Import a single phone number
delete
Delete a single phone number
patch
Reassign a phone number to a different connector
get
List all phone numbers for a project
post
Import phone numbers into a project
delete
Delete phone numbers from a project
get
Get a config page by environment
get
List all config pages
patch
Update config variables for an environment
put
Upsert the JSON Schema for a config page
get
List attributes
post
Create attribute
get
List variants
post
Create variant
delete
Delete attribute
patch
Update attribute
delete
Delete variant
patch
Update variant
get
Get a single voice from the voice library
patch
Update a voice in the voice library
get
List all voices in the account's voice library
post
Register a new voice in the voice library
get
Synthesize a short audio sample of a voice
get
List alert rules
post
Create an alert rule
get
Get an alert rule
delete
Delete an alert rule
patch
Update an alert rule
get
Get active alerts
put
Close an existing chat conversation
post
Create a new chat conversation
post
Send a message to an existing chat conversation
get
Get distribution of the maximum number of concurrent conversations
get
/v1/{account_id}/{project_id}/conversations
get
Get audio recording for a conversation
get
Get a conversation by ID
get
List conversations for a project
post
Create a new debug chat session
post
Send a message to a debug chat session
post
Reserve a DNI (Dynamic Number Insertion) for an incoming call.
post
Bridge ended notification
post
External events webhook (provider → PolyAI)
get
Get handoff state information for a call.
get
List webhook endpoints
post
Create a webhook endpoint
get
Get a webhook endpoint
delete
Delete a webhook endpoint
patch
Update a webhook endpoint
post
Rotate webhook signing secret