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

Example request

{
  "name": "Legal Documents",
  "description": "All legal documents"
}

Response

Table updated

idstring

Unique table ID

namestring

Table name

descriptionstring

Table description

metadataobject

Custom metadata

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",
  "document_count": 15,
  "total_nodes": 234,
  "created_at": "2026-01-27T10:00:00Z",
  "updated_at": "2026-01-27T12:30:00Z"
}