---
title: "Create draft"
method: POST
path: "/v1/documents/{documentId}/draft"
tags: ["Documents"]
deprecated: true
---

# Create draft

`POST /v1/documents/{documentId}/draft`

> **Deprecated.**

<Warning>
  **Deprecated** — Removal scheduled for **July 31, 2026**. Use the [Documents v2 API](/api/documents-v2/create-document) instead.
</Warning>

<Note>
  This endpoint requires **Editor** permissions or higher on the specified document.
</Note>

Create a [draft](/content/develop/drafts) of the specified document. Drafts are isolated copies of a document - including its workbook and dashboard - that can be modified without impacting the published version.

To create a draft on a [branch](/content/develop/branch-mode), include a `branchId` in the request body. Each branch can have one draft per document.

If a draft already exists for the document (or branch, if specified), the existing draft is returned instead of creating a new one.

## Path parameters

- `documentId` string, required

## Request body

- object
  - `branchId` string, uuid — The UUID of the branch to create the draft on. Required when creating a draft on a branch. To retrieve branch IDs, use the [List models](/api/models/list-models) endpoint with `modelKind=BRANCH`.

## Response `200`

Draft created successfully (or existing draft returned)

- object
  - `identifier` string — Identifier of the new draft. If a draft already exists for the document or branch specified, this will be the identifier of the existing draft.

## Other responses

- `400` — Bad request Possible error messages: - Document is not eligible for publishing workflow
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden Possible error messages: - Permission denied - EDITOR role required
- `404` — Not Found Possible error messages: - `Document with identifier <documentId> not found`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)