Create Dataset Version from Request History

POST /api/public/v2/dataset-versions/from-filter-params

cURL

explicitIds

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: <api-key>' \
  --data '
{
  "dataset_group_id": 123,
  "request_log_ids": [
    1001,
    1002,
    1003
  ]
}
'

201

{
  "success": true,
  "message": "Dataset version creation queued",
  "dataset_id": 456,
  "dataset_group_id": 123,
  "version_number": -1
}

Create a dataset version asynchronously from existing request logs. You can populate the version with explicit request log IDs or with structured request-log filters.

Behavior Notes

• If both request_log_ids and filter_group are present, explicit request IDs take precedence.
• The endpoint queues a background job and reuses the draft dataset for the dataset group when one already exists.
• Jobs are capped at 50,000 request logs.
• Filter-based datasets persist their filter parameters so refresh flows can replay the same query later.
• Completion triggers the dataset_version_created_from_filter_params webhook.

Related

• Create from History
• Search Request Logs
• Get Dataset Rows

Authorizations

X-API-KEY · string · header · required

Body

application/json

Dataset version creation payload from request IDs or request-log filters.

dataset_group_id · integer · required

Dataset group that will receive the generated dataset version.

request_log_ids · integer[] | null

Explicit request log IDs to snapshot. When provided, this mode takes precedence over filter_group.

Maximum array length: 50000

filter_group · StructuredFilterGroup · object

Structured request-log filters used to populate the dataset asynchronously.

Show child attributes

q · string | null

Free-text request-log search query applied with filter_group.

sort_by · enum<string> | null

Available options: request_start_time, input_tokens, output_tokens, cost, latency_ms, status

sort_order · enum<string> | null

Available options: asc, desc

variables_to_parse · string[] | null

Request fields or variables to parse into dataset columns.

limit · integer | null

Maximum number of request logs to include. When set, only the first N matching rows (in the current sort order) are added to the dataset version.

Required range: x >= 1

Response

201

application/json

Dataset version creation queued.

success · enum<boolean> · required

Available options: true

dataset_id · integer · required

dataset_group_id · integer · required

version_number · integer · required

Version number of the draft or generated dataset version.

message · string