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"
}

Changes

Changed in 2 of the 7 revisions of this API.44

Jul 17, 2026f8665c1a52394See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Jan 30, 20269404aa4fdc224See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history