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

<ApiEndpoint method="POST" endpoint="/api/v1/projects/:projectId/datasets/:id/versions" description="Publish the current draft as a new immutable version.">
  <section>
    #### Body parameters
    <ApiAttribute name="description" type="string" description="What changed in this version." required={false} />
    <ApiAttribute name="metadata" type="object" description="Arbitrary JSON metadata." required={false} />
  </section>
</ApiEndpoint>