---
title: "Update a table"
method: PATCH
path: "/v1/tables/{id}"
tags: ["tables"]
---

# Update a table

`PATCH /v1/tables/{id}`

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

## Path parameters

- `id` string, required

## Request body

- UpdateTableRequest
  - `name` string — Updated name
  - `description` string — Updated description
  - `metadata` object — Metadata to merge (key-by-key, not replaced wholesale)
  - `domain_vocab` string[] — Domain-specific vocabulary and terminology used by the LLM reasoning engine to interpret documents in this table.
  - `context` string — Contextual description for LLM reasoning. Provides background about what this table contains and how documents should be interpreted.
  - `instructions` string — Custom directives that guide how the LLM should answer questions or traverse documents within this table.
  - `tags` string[] — Classification tags for grouping and discovery of this table.

## Response `200`

Table updated

- TableResponse
  - `id` string — Unique table ID
  - `name` string — Table name
  - `description` string — Table description
  - `metadata` object — Custom metadata
  - `domain_vocab` string[] — Domain-specific vocabulary for LLM reasoning
  - `context` string — Contextual description for LLM reasoning
  - `instructions` string — Custom LLM query and reasoning directives
  - `tags` string[] — Classification tags for this table
  - `document_count` integer — Number of documents in this table
  - `total_nodes` integer — Total nodes across all documents
  - `created_at` string, date-time — Creation timestamp
  - `updated_at` string, date-time — Last update timestamp

## Other responses

- `404` — Table not found
- `500` — Failed to update table

---

[API](https://skmtc.net/brainfish-ai/apis/reasondb-api.md) · [All operations](https://skmtc.net/brainfish-ai/apis/reasondb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brainfish-ai/reasondb-api/revisions/f8665c1a5239/schema)