---
title: "Launch Eval"
method: POST
path: "/evals/launch/"
tags: ["evaluations"]
---

# Launch Eval

`POST /evals/launch/`

Launch an eval job with detailed validation and workflow integration

## Request body

- EvalRunRequest
  - `workflow_id` string, required
  - `eval_name` string, required
  - `output_variable` string, required
  - `num_samples` integer

## Response `200`

Successful Response

- EvalRunResponse
  - `run_id` string, required
  - `eval_name` string, required
  - `workflow_id` string, required
  - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED', required
  - `start_time` string, date-time, nullable, required
  - `end_time` string, date-time, nullable, required
  - `results` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-03-12** `181efcea9e6e` — 1 info
  - endpoint added
- **2024-11-23** `a2d864f3a8db` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pyspur-dev/apis/pyspur-api/changes/evals/launch/post.md)

---

[API](https://skmtc.dev/pyspur-dev/apis/pyspur-api.md) · [All operations](https://skmtc.dev/pyspur-dev/apis/pyspur-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pyspur-dev/pyspur-api/revisions/adc77484c851/schema)