Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-01-1340148239.5 KB
/datastores/{id}/documents

List Documents

Get list of documents in a given Datastore, including document id, name, and ingestion job status.

Performs cursor-based pagination if the number of documents exceeds the requested limit. The returned cursor can be passed to the next GET /datastores/{datastore_id}/documents call to retrieve the next set of documents.

get/datastores/{datastore_id}/documents

Path parameters

datastore_idstring uuid required

Datastore ID of the datastore to retrieve documents for

Datastore ID of the datastore to retrieve documents for

Query parameters

limitinteger

Maximum number of documents to return

Maximum number of documents to return

cursorstring

Cursor from the previous call to list documents, used to retrieve the next set of results

Cursor from the previous call to list documents, used to retrieve the next set of results

ingestion_job_statusDocumentStatusEnum[]

Filters documents whose ingestion job status matches (one of) the provided status(es).

Filters documents whose ingestion job status matches (one of) the provided status(es).

uploaded_afterstring date-time

Filters documents uploaded at or after specified timestamp.

Filters documents uploaded at or after specified timestamp.

uploaded_beforestring date-time

Filters documents uploaded at or before specified timestamp.

Filters documents uploaded at or before specified timestamp.

document_name_prefixstring

Filters documents with the given prefix.

Filters documents with the given prefix.

Response

Successful Response

total_countinteger

Total number of available documents which would be returned by the request if no limit were specified. Ommitted if job_id was set in the request.

next_cursorstring

Next cursor to continue pagination. Ommitted if there are no more documents after these ones, or if job_id was set in the request.