---
title: "Create Run"
method: POST
path: "/v1/admin/eval/runs"
tags: ["evals"]
---

# Create Run

`POST /v1/admin/eval/runs`

Trigger a new eval run.

Body shapes:
    scenario  {"target": "scenario", "id": <uuid>, "reps"?: int=1}
    probe     {"target": "probe",    "id": <uuid>}
    suite     {"target": "suite",    "id": <uuid>}  -- fans out to children
    harness   {"target": "harness",  "harness_path": "tests/replay/test_X.py"}

Common optional: "force_run": true (bypass the daily cost cap)

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)