POST
/
dataset-from-filter-params

This endpoint allows you to create a dataset based on a historical search query. Search filters can include tags, metadata, and other criteria such as time range and scores. This dataset is then stored in a given workspace.

​
Example Code

import requests

response = requests.post(
    "https://api.promptlayer.com/dataset-from-filter-params",
    headers=headers,
    json={
        "name": "Dataset Name",
        "workspace_id": 1,
        "q": "javascript",
        "start_time": "2023-11-17 20:14:31.874642",
        "end_time": "2024-11-18 20:14:31.874642",
        "tags_or": ["prod", "dev"],
        "metadata": [
            {"key": "user_id", "value": "abc123"},
            {"key": "success", "value": "true"}
        ],
        "scores": [
            {"name": "default", "operator": ">", "value": 90}
        ],
        "starred": True,
        "prompt_template": {
            "name": "recipe_template",
            "version_numbers": [50, 51]
        },
        "limit": 500,
    }
)

Headers

​
X-API-KEY
string
required

API key to authorize the operation.

Body

application/json
​
name
string
required

The name of the dataset to be created.

​
workspace_id
integer
required

The ID of the workspace under which the dataset will be stored.

​
end_time
string

The end time for the dataset's time range filter.

​
limit
integer

The maximum number of rows that will be included in the dataset.

​
metadata_and
object[]

A list of metadata key-value pairs to filter by.

​
metadata_or
object[]

A list of metadata key-value pairs to filter by.

​
prompt_template
object

Filters requests by the specified prompt template, defaulting to its latest version if no versions are specified.

​
q
string

The search query for filtering the data.

​
scores
object[]

Score thresholds and conditions for filtering request logs.

​
starred
boolean

Only include favorited requests.

​
start_time
string

The start time for the dataset's time range filter.

​
tags_and
string[]

A list of tags to filter by. This will perform an AND operation.

​
tags_or
string[]

A list of tags to filter by. This will perform an OR operation.

Response

200 - application/json
​
dataset_id
integer
required

The ID of the created dataset.

​
message
string
required
​
success
boolean
required

Was this page helpful?

Get All Prompt TemplatesCreate Evaluation Pipeline