Skip to main content
GET
List knowledge base documents
Lists every document attached to an agent’s knowledge base.

Overview

Returns documents oldest first, including ones whose upload has not been completed yet. The response is not paginated — an agent holds at most 10 documents.

Reading the Response

A PENDING document still counts against limit. If total has reached limit and some documents are pending, either complete or delete them to free a slot — abandoned uploads are reclaimed automatically after 24 hours.

Example

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string<uuid>
required

Agent the knowledge base belongs to.

Query Parameters

companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Response

Documents attached to the agent, oldest first

data
object[]
required

Documents attached to the agent, oldest first

total
number
required

Number of documents attached

Example:

3

limit
number
required

Maximum documents one agent may hold

Example:

10