agentIdstringrequired
List all config pages
get
https://api.dev.poly.ai/v1/agents/{agentId}/real-time-configs
Path Parameters
Response
application/json
Response
application/json
Successful response
GetConfigPagesResponse
One config page per environment (sandbox, pre-release, live).
configPagesarray[object]required
A real-time config page for one environment: its JSON Schema
definition plus the current variable values.
Show Child Parameters
get/v1/agents/{agentId}/real-time-configs
Authentication
Path Parameters
application/json
Get a config page by environment
get
https://api.dev.poly.ai/v1/agents/{agentId}/real-time-configs/{clientEnv}
Path Parameters
agentIdstringrequired
clientEnvstringrequired
Response
application/json
Response
application/json
Successful response
GetConfigPageResponse
A single config page for one environment.
clientEnvstringrequired
Environment (sandbox, pre-release, live)
variablesobject
Config key-value pairs
schemaobject
JSON Schema (Draft 7) definition
lastUpdatedstring
ISO 8601 timestamp of last update
get/v1/agents/{agentId}/real-time-configs/{clientEnv}
Authentication
Path Parameters
application/json
Upsert the JSON Schema for a config page
put
https://api.dev.poly.ai/v1/agents/{agentId}/real-time-configs/{clientEnv}/schema
Path Parameters
agentIdstringrequired
clientEnvstringrequired
Body
application/json
Body
application/json
UpdateConfigSchemaBody
The JSON Schema definition to apply to a config page.
schemaobjectrequired
JSON Schema (Draft 7) definition
Response
application/json
Response
application/json
Successful response
GetConfigPageResponse
A single config page for one environment.
clientEnvstringrequired
Environment (sandbox, pre-release, live)
variablesobject
Config key-value pairs
schemaobject
JSON Schema (Draft 7) definition
lastUpdatedstring
ISO 8601 timestamp of last update
put/v1/agents/{agentId}/real-time-configs/{clientEnv}/schema
Authentication
Path Parameters
Body
{
"schema": {}
}
application/json
Update config variables for an environment
patch
https://api.dev.poly.ai/v1/agents/{agentId}/real-time-configs/{clientEnv}/variables
Path Parameters
agentIdstringrequired
clientEnvstringrequired
Body
application/json
Body
application/json
UpdateConfigVariablesBody
Variables to shallow-merge into an environment’s config page.
variablesobjectrequired
Key-value pairs to merge into the existing config
Response
application/json
Response
application/json
Successful response
GetConfigPageResponse
A single config page for one environment.
clientEnvstringrequired
Environment (sandbox, pre-release, live)
variablesobject
Config key-value pairs
schemaobject
JSON Schema (Draft 7) definition
lastUpdatedstring
ISO 8601 timestamp of last update
patch/v1/agents/{agentId}/real-time-configs/{clientEnv}/variables
Authentication
Path Parameters
Body
{
"variables": {}
}
application/json
List all connectors for a project
get
https://api.dev.poly.ai/v1/agents/{agentId}/telephony/connectors
Path Parameters
agentIdstringrequired
Response
application/json
Response
application/json
Successful response
GetConnectorsResponse
Every connector in the project.
connectorsarray[object]required
A connector: the voice, language, variant, and environment bundle
that handles incoming calls. Multiple phone numbers can share one
connector.
Show Child Parameters
get/v1/agents/{agentId}/telephony/connectors
Authentication
Path Parameters
application/json