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

## Response `200`

Table updated

- TableResponse
  - `id` string — Unique table ID
  - `name` string — Table name
  - `description` string — Table description
  - `metadata` object — Custom metadata
  - `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

## Changes

- **2026-01-30** `9404aa4fdc22` — 8 warning
  - removed the request property `context`
  - removed the request property `domain_vocab`
  - removed the request property `instructions`
  - removed the request property `tags`
  - …4 more

[Change history](https://skmtc.dev/brainfish-ai/apis/reasondb-api/changes/v1/tables/:id/patch.md)

---

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