---
title: "Create a new table"
method: POST
path: "/v1/tables"
tags: ["tables"]
---

# Create a new table

`POST /v1/tables`

Creates a new table (collection) to organize documents. Documents can be assigned to tables during ingestion or moved later.

## Request body

- CreateTableRequest
  - `name` string, required — Human-readable name for the table
  - `description` string — Optional description
  - `metadata` object — Custom metadata (key-value pairs)

## Response `201`

Table created successfully

- 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

- `422` — Validation failed
- `500` — Failed to create 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)