Documents

These read-only endpoints let you browse what’s been indexed — handy for building dashboards or document pickers. All require a bearer token.

List documents in a docset

GET /documents?docSetName={name}

curl "$API_URL/documents?docSetName=company-policies" \
  -H "Authorization: Bearer $API_TOKEN"

Returns an array of documents with fields such as id, fileName, docSetName, source, sourceId, indexingStatus, createdAt, and lastIndexedAt.

List recently indexed documents

GET /documents/recent?limit={n}

limit is optional, clamped to 1–100, and defaults to 20.

curl "$API_URL/documents/recent?limit=10" \
  -H "Authorization: Bearer $API_TOKEN"

List all docsets

GET /documents/docsets

Returns every docset with its source types and document counts.

curl "$API_URL/documents/docsets" \
  -H "Authorization: Bearer $API_TOKEN"

Docset metadata

GET /documents/metadata/{docSetName}

Returns aggregate metadata for a single docset.

curl "$API_URL/documents/metadata/company-policies" \
  -H "Authorization: Bearer $API_TOKEN"

Fetch a single document

GET /documents/{id}

Returns one document, or 404 if the id is unknown.

curl "$API_URL/documents/DOCUMENT_ID" \
  -H "Authorization: Bearer $API_TOKEN"