GET /api/v1/:context_id/documents — spectron

Lists Layer 0 knowledge documents

get/api/v1/{context_id}/documents

Path parameters

context_idstring required

Spectron context id

Query parameters

statusstring

Filter by document status

mimeTypestring

Filter by mime type

limitinteger

Max documents to return (default 100, max 500)

cursorstring

Continuation token from the previous page's page.nextCursor

countboolean

Also return page.totalSize (costs a full count of the filtered set)

pageinteger

Deprecated: zero-based page index. Use cursor.

pageSizeinteger

Deprecated: page size. Use limit.

Response

Documents

Changes

Changed in 3 of the 5 revisions of this API.3715

Aug 24, 20269f159871306738See the full diff
- ▲
  the page response's property type/format changed from integer/int32 to object/ for status 200
  response-property-type-changed
- ▲
  removed the required property pageSize from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property total from the response with the 200 status
  response-required-property-removed
- ○
  added the new optional query request parameter count
  new-optional-request-parameter
- ○
  added the new optional query request parameter cursor
  new-optional-request-parameter
- ○
  added the new optional query request parameter limit
  new-optional-request-parameter
- ○
  added the non-success response with the status 503
  response-non-success-status-added
- ○
  added the optional property documents/items/observedAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property page/nextCursor to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property page/totalSize to the response with the 200 status
  response-optional-property-added
- ○
  added the required property page/hasMore to the response with the 200 status
  response-required-property-added
Jun 16, 202652b41ab517b652See the full diff
- ●
  deleted the query request parameter mime_type
  request-parameter-removed
- ●
  deleted the query request parameter page_size
  request-parameter-removed
- ●
  removed the optional property documents/items/chunkCount from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property documents/items/keywordCount from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property documents/items/language from the response with the 200 status
  response-optional-property-removed
- ○
  added the new optional query request parameter mimeType
  new-optional-request-parameter
- ○
  added the new optional query request parameter pageSize
  new-optional-request-parameter
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 8, 2026741d58b9ef8925See the full diff
- ●
  deleted the query request parameter mimeType
  request-parameter-removed
- ●
  deleted the query request parameter pageSize
  request-parameter-removed
- ○
  added the new optional query request parameter mime_type
  new-optional-request-parameter
- ○
  added the new optional query request parameter page_size
  new-optional-request-parameter
- ○
  added the optional property documents/items/chunkCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property documents/items/keywordCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property documents/items/language to the response with the 200 status
  response-optional-property-added
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history