---
title: "Create Revision"
method: POST
path: "/api/bitables/{table_id}/revisions"
tags: ["bitables"]
---

# Create Revision

`POST /api/bitables/{table_id}/revisions`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/bitables/{table_id}/revisions`
- Auth: HTTP bearer

## Path parameters

- `table_id` string, uuid, required

## Request body

- SrcSchemasBitableRevisionCreate: Open a new revision off the current HEAD (or any chosen parent). label: short human-readable name; unique per table. Defaults to a timestamp-derived "v<n>" if omitted (server picks). message: optional commit message. set_as_head: when True (default), the new revision becomes the table's HEAD on success. False = create the branch and stay on the previous HEAD (useful for templates). parent_revision_id: branch from a specific revision. Defaults to HEAD.
  - `label` string, nullable
  - `message` string, nullable
  - `set_as_head` boolean
  - `parent_revision_id` string, uuid, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)