Skip to main content
GET
List Knowledge Base Documents
Read only List knowledge base documents to verify an upload or inspect the non-deleted files in a knowledge base. Results are paginated and include document IDs, titles, file types, and sizes.

Before you begin

List Knowledge Base Documents Request

Verify the result

Read data.items and data.meta in the 200 response. Pagination metadata includes totalItems, itemsPerPage, totalPages, and currentPage. Match an uploaded document by ID and title. file_size is in KB, with 1024 bytes per KB.

Errors and recovery

401 means the API key is missing or invalid. 404 means the knowledge base ID does not exist in your workspace. Because document listings carry the full text of every file, DialNexa does not confirm that a knowledge base belongs to another workspace, so a valid ID you do not own returns the same 404 as one that was never created. Check the ID against List Knowledge Bases. Use integer page and limit values, and a valid document field for sortBy. sortOrder accepts ASC or DESC. This read is safe to retry.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

knowledge_base_id
string
required

Knowledge base ID.

Example:

"kb_abc123def45678"

page
integer
default:1

Page number.

limit
integer
default:10

Documents per page.

sortBy
string
default:id

Document field to sort by.

sortOrder
enum<string>
default:ASC

Sort direction.

Available options:
ASC,
DESC

Response

Successful response.

success
boolean
required
error
boolean
required
statusCode
integer
required
message
string
required
data
object
required
timestamp
string<date-time>
required