POST
/
api
/
public
/
v2
/
dataset-versions
/
from-filter-params
Create Dataset Version from Filter Params
curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/dataset-versions/from-filter-params \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "dataset_group_id": 2,
  "variables_to_parse": [
    "<string>"
  ],
  "prompt_id": 123,
  "prompt_version_id": 123,
  "prompt_label_id": 123,
  "workspace_id": 123,
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "scores": {}
}'
{
  "success": true,
  "message": "<string>",
  "dataset_id": 123,
  "dataset_group_id": 123,
  "version_number": 123
}
Create a new dataset version by filtering existing request logs. The dataset is populated asynchronously based on the provided filter parameters.

Authentication

This endpoint requires API key authentication only.

Asynchronous Processing

This endpoint initiates an asynchronous job to process the request logs based on the filter parameters. The actual dataset version creation happens in the background. A draft dataset (version_number = -1) is created immediately.

Webhooks

The following webhook is triggered when the process completes:
  • dataset_version_created_from_filter_params - Sent when the dataset version is successfully created, includes:
    • dataset_id: ID of the created dataset
    • rows_added: Number of rows added to the dataset
    • dataset_version_number: Final version number assigned

Notes

  • If an existing draft dataset exists for the dataset group, it will be updated with new filter params
  • If no matching request logs are found, an empty dataset version is created
  • Failed drafts are automatically cleaned up

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 where the new version will be created

Required range: x >= 1
variables_to_parse
string[]

List of variables to parse from the request logs

prompt_id
integer

Filter by specific prompt ID

prompt_version_id
integer

Filter by specific prompt version ID

prompt_label_id
integer

Filter by specific prompt label ID

workspace_id
integer

Filter by specific workspace ID

start_time
string<date-time>

Filter logs after this timestamp (ISO format)

end_time
string<date-time>

Filter logs before this timestamp (ISO format)

tags
string[]

Filter by specific tags

metadata
object

Filter by metadata key-value pairs

scores
object

Filter by score ranges

Response

Dataset version creation job queued

success
boolean
required
message
string
required
dataset_id
integer
required

ID of the created draft dataset

dataset_group_id
integer
required

ID of the dataset group

version_number
integer
required

Version number of the dataset (-1 for draft)