---
title: "Create Draft Dataset Version"
method: POST
path: "/api/public/v2/dataset-versions/create-draft"
tags: ["datasets"]
---

# Create Draft Dataset Version

`POST /api/public/v2/dataset-versions/create-draft`

## Request body

- CreateDraftDatasetVersionRequest
  - `dataset_group_id` integer, required — ID of the dataset group to create a draft version for.
  - `source_dataset_id` integer, nullable — Optional existing dataset version to copy rows from. Must belong to the same dataset group.

## Response `201`

Empty draft created.

- DraftDatasetVersionResponse
  - `success` true, required
  - `message` string, required
  - `draft_dataset_id` integer, required — ID of the draft dataset.

## Other responses

- `202` — Draft created and source rows are being copied asynchronously.
- `401` — Unauthorized - missing or invalid API key.
- `403` — Forbidden - API key does not have access to the requested resource.
- `404` — Not found - requested resource does not exist or is not accessible.
- `409` — A draft version already exists for this dataset group
- `422` — Validation error - request parameters or body are invalid.

---

[API](https://skmtc.dev/promptlayer/apis/promptlayer-api.md) · [All operations](https://skmtc.dev/promptlayer/apis/promptlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/promptlayer/promptlayer-api/revisions/a23093a0a506/schema)