PaginatedResponse[KnowledgeDocumentRead]

items object[]required

Array [

idIdrequired

RAG document id.

product_id object

Main app product id that owns this knowledge document.

anyOf

• integer
• null

integer

agent_idAgent Idrequired

Agent id whose chatbot can retrieve this knowledge.

directory_idDirectory Idrequired

Owning knowledge directory id. Every persisted knowledge document belongs to exactly one directory.

group_name object

Legacy group name mirror. Normally kept equal to the owning directory name for compatibility.

anyOf

• string
• null

string

titleTitlerequired

Human-readable document title, usually derived from filename or prompt name.

source_typeKnowledgeDocumentSourceTyperequired

Original source format before text extraction.

Possible values: [text, markdown, csv, xls, pdf, xlsx]

retrieval_modeKnowledgeDocumentRetrievalModerequired

How this document is materialized into retrievable units.

Possible values: [whole_document, section_under_heading, top_n_chunks, top_n_rows]

statusKnowledgeDocumentStatusrequired

Ingestion lifecycle status for this document.

Possible values: [pending, ready, failed]

source_path object

Canonical S3 path to the original source artifact.

anyOf

• string
• null

string

source_hash object

Hash of the effective ingested source used to detect changes.

anyOf

• string
• null

string

extracted_text object

Canonical extracted text derived from the original source.

anyOf

• string
• null

string

structure_json objectrequired

Derived structural metadata such as section counts, row counts, or page counts.

property name*any

Derived structural metadata such as section counts, row counts, or page counts.

metadata_json objectrequired

Flexible document metadata for lineage, migration, and future retrieval hints.

property name*any

Flexible document metadata for lineage, migration, and future retrieval hints.

created_atdate-timerequired

When this document row was created in the RAG database.

updated_atdate-timerequired

When this document was last re-ingested or updated.

unit_countUnit Count

Number of currently materialized retrievable units for this document.

Default value: 0

]

pagePagerequired

limitLimitrequired

totalTotalrequired

pagesPagesrequired

PaginatedResponse[KnowledgeDocumentRead]

{
  "items": [
    {
      "id": 0,
      "product_id": 0,
      "agent_id": 0,
      "directory_id": 0,
      "group_name": "string",
      "title": "string",
      "source_type": "text",
      "retrieval_mode": "whole_document",
      "status": "pending",
      "source_path": "string",
      "source_hash": "string",
      "extracted_text": "string",
      "structure_json": {},
      "metadata_json": {},
      "created_at": "2024-07-29T15:51:28.071Z",
      "updated_at": "2024-07-29T15:51:28.071Z",
      "unit_count": 0
    }
  ],
  "page": 0,
  "limit": 0,
  "total": 0,
  "pages": 0
}