Skip to main content
POST
Start an eval run

Authorizations

Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Body

application/json
prompt_set_id
string<uuid>
required

The prompt set to execute.

Example:

"550e8400-e29b-41d4-a716-446655440000"

description
string | null

Optional human-readable description for the run. Omit or pass null to leave it unset. Max 1024 characters.

Maximum string length: 1024
Example:

"Re-running after switching to gpt-4o for query generation"

run_config
object

Per-run configuration. Optional — omit if no overrides.

Response

Run created and jobs enqueued.

job_count
integer
required

Number of per-prompt agentic jobs created for this run (one per prompt that fanned out successfully). Enqueue onto the work queue happens after creation and is best-effort, so this count reflects jobs created, not necessarily those successfully enqueued.

Example:

12

run
object
required

The newly created run with its initial results.