Skip to main content
POST
Run an experiment

Authorizations

X-Auth-Token
string
header
required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

slug
string
required

Body

application/json
data
object[]

Rows to evaluate inline, instead of the experiment's saved dataset. Mutually exclusive with dataset_id.

dataset_id
string

A saved dataset to evaluate, instead of the one the experiment is configured with. Mutually exclusive with data.

parameters
object

Constant inputs applied to every row, overriding fields of the same name

row_indices
integer[]

Run only these rows of the dataset, by zero-based index

Required range: x >= 0

Response

Run started

runId
string
required

Identifier to poll this run with

status
string
required
Allowed value: "running"
total
number
required

Number of cells this run will execute

runUrl
string

Link to the run in the LangWatch app