Skip to main content
POST
/
api
/
public
/
v2
/
dataset-versions
/
create-draft
Create Draft Dataset Version
curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/dataset-versions/create-draft \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "dataset_group_id": 2,
  "source_dataset_id": 2
}
'
{
  "success": true,
  "message": "<string>",
  "draft_dataset_id": 123
}
Create a new draft dataset version for a dataset group. A draft (version_number = -1) is a mutable staging area where you can add rows before publishing.

​
Authentication

This endpoint requires API key authentication only.

​
Workflow

This endpoint is the first step in the dataset version creation workflow:
  1. Create draft — Use this endpoint to create a draft
  2. Add rows — Use Add Request Log to add request logs as rows
  3. Save — Use Save Draft to publish as a new version

​
Source Dataset

Optionally provide source_dataset_id to copy rows from an existing dataset version. The source dataset must belong to the same dataset group. When a source is provided, rows are copied asynchronously in the background (returns 202).

​
Notes

  • Only one draft can exist per dataset group at a time. Returns 409 if a draft already exists.
  • Without source_dataset_id, an empty draft is created (returns 201).

Headers

​
X-API-KEY
string
required

API key for authentication. This endpoint supports API key authentication only.

Body

application/json
​
dataset_group_id
integer
required

ID of the dataset group to create a draft version for

Required range: x >= 1
​
source_dataset_id
integer

Optional. ID of an existing dataset version to copy rows from. Must belong to the same dataset group.

Required range: x >= 1

Response

Empty draft created

​
success
boolean
required
​
message
string
required
​
draft_dataset_id
integer
required

ID of the created draft dataset