v1

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

tables

Update a table

Update table metadata, name, or description. Only provided fields are updated.

patch/v1/tables/{id}

Path parameters

idstring required

Example:tbl_abc123

Table ID

Request body

namestring

Updated name

descriptionstring

Updated description

metadataobject

Metadata to merge (key-by-key, not replaced wholesale)

domain_vocabstring[]

Domain-specific vocabulary and terminology used by the LLM reasoning engine to interpret documents in this table.

contextstring

Contextual description for LLM reasoning. Provides background about what this table contains and how documents should be interpreted.

instructionsstring

Custom directives that guide how the LLM should answer questions or traverse documents within this table.

tagsstring[]

Classification tags for grouping and discovery of this table.

Example request

{
  "name": "Legal Documents",
  "description": "All legal documents",
  "domain_vocab": [
    "contract",
    "indemnification",
    "arbitration"
  ],
  "context": "This table contains legal contracts and agreements for US jurisdictions.",
  "instructions": "Always cite clause numbers when referencing contract terms.",
  "tags": [
    "legal",
    "contracts",
    "us"
  ]
}

Response

Table updated

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