v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Knowledge Bases

Assign knowledge bases to an agent

Sets the full list of shared knowledge bases assigned to an agent (replaces existing assignments). Requires a USER API key.

put/public/v1/agents/{agentId}/knowledge-bases

Path parameters

agentIdstring required
Example:asst_123

Request body

knowledgeBaseIdsinteger[] required

Example request

{
  "knowledgeBaseIds": [
    12,
    13
  ]
}

Response

Updated assignments

idnumber required
knowledgeBaseIdnumber required
assistantIdstring
maxUserProfileIdnumber
assignedAtstring required

Example response

[
  {
    "id": 1,
    "knowledgeBaseId": 1,
    "assistantId": "example",
    "maxUserProfileId": 1,
    "assignedAt": "example",
    "knowledgeBase": {
      "id": 1,
      "name": "example",
      "description": "example",
      "namespace": "example",
      "createdAt": "example",
      "updatedAt": "example"
    }
  }
]