> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Publish a version"
description: "Publish the current draft as a new immutable version."
method: "POST"
endpoint: "/api/v1/projects/:projectId/datasets/:id/versions"
order: 5
group: "Versions"
last_verified: 2026-07-27
---



`POST /api/v1/projects/:projectId/datasets/:id/versions`

Publish the current draft as a new immutable version.


  #### Body parameters
  - `description` _string_ — What changed in this version.
  - `metadata` _object_ — Arbitrary JSON metadata.