Create Dataset Version from File

curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/dataset-versions/from-file \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "dataset_group_id": 123,
  "file_name": "support-eval.csv",
  "file_content_base64": "cXVlc3Rpb24sZXhwZWN0ZWRfYW5zd2VyCldoYXQgaXMgUHJvbXB0TGF5ZXI/LEEgcHJvbXB0IG1hbmFnZW1lbnQgcGxhdGZvcm0="
}
'

{
  "success": true,
  "message": "Dataset version creation job queued",
  "dataset_id": 456
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

POST

api

public

dataset-versions

from-file

curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/dataset-versions/from-file \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "dataset_group_id": 123,
  "file_name": "support-eval.csv",
  "file_content_base64": "cXVlc3Rpb24sZXhwZWN0ZWRfYW5zd2VyCldoYXQgaXMgUHJvbXB0TGF5ZXI/LEEgcHJvbXB0IG1hbmFnZW1lbnQgcGxhdGZvcm0="
}
'

{
  "success": true,
  "message": "Dataset version creation job queued",
  "dataset_id": 456
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "success": false,
  "message": "<string>",
  "error": "<string>"
}

Legacy Dataset, Evaluation, and Report endpoints are deprecated for new workflows. Use the Tables API for new dataset import, evaluation, scoring, recalculation, and reporting workflows.

Create a dataset version by submitting a base64-encoded CSV or JSON file. PromptLayer queues the file for asynchronous processing and creates a draft dataset while the job runs.

Behavior Notes

The draft dataset starts with version_number = -1 and receives a real version number after processing succeeds.
The dataset_version_created_by_file webhook event is sent when processing succeeds.
The dataset_version_created_by_file_failed webhook event is sent when processing fails.
Decoded file content must be 100MB or smaller.
Failed drafts are automatically cleaned up.

Authorizations

X-API-KEY

string

header

required

Body

application/json

dataset_group_id

integer

required

ID of the dataset group where the new version will be created.

Required range: x >= 1

file_name

string

required

Name of the CSV or JSON file. Must end with .csv or .json.

Required string length: 1 - 255

file_content_base64

string

required

Base64-encoded file content. Maximum decoded file size is 100MB.

Minimum string length: 1

Response

Dataset version creation job queued.

success

enum<boolean>

required

Available options:

true

message

string

required

dataset_id

integer

required

ID of the draft dataset created for asynchronous processing.

Create Dataset Group Create Dataset Version from Request History

⌘I

Get Started

Core Concepts

Providers

Guides

AI Tools

Reference

Deprecated

Create Dataset Version from File

Behavior Notes

Authorizations

Body

Response

​Behavior Notes

​Related

Authorizations

Body

Response

Behavior Notes

Related