Sign in

v1

latestOpenAPI 3.0.3MIT OR Apache-2.02026-07-17203670.3 KB
tables

Create a new table

Creates a new table (collection) to organize documents. Documents can be assigned to tables during ingestion or moved later.

post/v1/tables

Request body

namestring required

Human-readable name for the table

descriptionstring

Optional description

metadataobject

Custom metadata (key-value pairs)

Example request

{
  "name": "Legal Contracts",
  "description": "All legal documents and contracts",
  "metadata": {
    "department": "legal",
    "confidential": true
  }
}

Response

Table created successfully

idstring

Unique table ID

namestring

Table name

descriptionstring

Table description

metadataobject

Custom metadata

domain_vocabstring[]

Domain-specific vocabulary for LLM reasoning

contextstring

Contextual description for LLM reasoning

instructionsstring

Custom LLM query and reasoning directives

tagsstring[]

Classification tags for this table

document_countinteger

Number of documents in this table

total_nodesinteger

Total nodes across all documents

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

Example response

{
  "id": "tbl_abc123",
  "name": "Legal Contracts",
  "description": "All legal documents and contracts",
  "domain_vocab": [
    "contract",
    "indemnification",
    "arbitration"
  ],
  "context": "This table contains legal contracts for US jurisdictions.",
  "instructions": "Always cite clause numbers when referencing contract terms.",
  "tags": [
    "legal",
    "contracts",
    "us"
  ],
  "document_count": 15,
  "total_nodes": 234,
  "created_at": "2026-01-27T10:00:00Z",
  "updated_at": "2026-01-27T12:30:00Z"
}