Topic deleted
Delete knowledge base topic
delete
https://api.dev.poly.ai/v1/agents/{agentId}/branches/{branchId}/knowledge-base/topics/{topicId}
Response
204
Response
204
delete/v1/agents/{agentId}/branches/{branchId}/knowledge-base/topics/{topicId}
Authentication
204
Update knowledge base topic
patch
https://api.dev.poly.ai/v1/agents/{agentId}/branches/{branchId}/knowledge-base/topics/{topicId}
Body
application/json
Body
application/json
UpdateKnowledgeBaseTopicBody
* Additional properties are NOT allowed.
namestring
>= 1 characters
contentstring
actionsstring
exampleQueriesobject
* Additional properties are NOT allowed.
Show Child Parameters
isActiveboolean
Response
Response
Topic updated
patch/v1/agents/{agentId}/branches/{branchId}/knowledge-base/topics/{topicId}
Authentication
Body
{}
List deployments for an environment
get
https://api.dev.poly.ai/v1/agents/{agentId}/deployments
Query Parameters
environmentstringrequired
Environment to list deployments for (sandbox, pre-release, live)
Allowed values:sandboxpre-releaselive
limitinteger
Max number of deployments to return
Path Parameters
agentIdstringrequired
Response
application/json
Response
application/json
Successful response
GetDeploymentsResponse
Deployments for the requested environment, ordered newest first.
deploymentsarray[object]required
A deployment of an agent version to a specific environment, plus
who created it and when.
Show Child Parameters
get/v1/agents/{agentId}/deployments
Authentication
Path Parameters
Query Parameters
application/json
Get active deployment per environment
get
https://api.dev.poly.ai/v1/agents/{agentId}/deployments/active
Path Parameters
agentIdstringrequired
Response
application/json
Response
application/json
Successful response
ActiveDeploymentsResponse
The latest deployment for each environment (sandbox, pre-release,
live). Entries are null when no deployment exists for an environment.
activeDeploymentsobjectrequired
Latest deployment per environment (sandbox, pre-release, live). Value is null if no deployment exists for that environment.
get/v1/agents/{agentId}/deployments/active
Authentication
Path Parameters
application/json
Publish the current draft to an environment
post
https://api.dev.poly.ai/v1/agents/{agentId}/deployments/publish
Path Parameters
agentIdstringrequired
Body
application/json
Body
application/json
PublishDeploymentBody
Metadata attached to a publish action, with an optional target environment.
deploymentMessagestring
Message describing this publish
Default:
environmentstring
Environment to publish to (defaults to sandbox)
Response
application/json
Response
application/json
Successful response
MutationDeploymentResponse
The resulting deployment from a promote / rollback / publish action,
plus any test runs it triggered.
deploymentobjectrequired
A deployment of an agent version to a specific environment, plus
who created it and when.
Show Child Parameters
testRunIdsarray[string]
IDs of test runs triggered by this deployment action
post/v1/agents/{agentId}/deployments/publish
Authentication
Path Parameters
Body
{}
application/json