Skip to main content
These endpoints are for the VIP plan only. Other plans get a 403. See Plan access.
An agent answers questions from the knowledge items attached to it. Add items to the workspace’s library first, in the dashboard or with the knowledge endpoints. The item must be in the agent’s workspace.

​
List an agent’s knowledge

GET /v1/agents/{agentId}/knowledge Returns the attached items.
Response

​
Attach knowledge

POST /v1/agents/{agentId}/knowledge
​
string
required
A knowledge item in the agent’s workspace.
We read the item’s content and load it into the agent before we answer, so this can take a while for a large website or file. If the content cannot be read, nothing is attached. Returns 201 with the attached item. If the request times out, list the agent’s knowledge before you try again. The attach may have finished. A 409 means the item is already attached.

​
Detach knowledge

DELETE /v1/agents/{agentId}/knowledge/{knowledgeItemId} The agent stops answering from the item. The item stays in the library. Returns 204.

​
Errors