---
title: "Start Experiment Run"
method: POST
path: "/api/experiments/{experiment_id}/run"
tags: ["experiments"]
---

# Start Experiment Run

`POST /api/experiments/{experiment_id}/run`

Start a new run of an experiment.

Creates run and result records, then spawns background task to execute prompts.
Returns immediately with run_id for polling.

Args:
    dry_run: If True, tools will capture what WOULD be called without executing

## Path parameters

- `experiment_id` string, required

## Query parameters

- `dry_run` boolean — If true, tools will not be executed (captures intent only)

## Headers

- `authorization` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/usecrow/apis/crow-backend-multi-tenant-saas.md) · [All operations](https://skmtc.dev/usecrow/apis/crow-backend-multi-tenant-saas/llms.txt) · [OpenAPI document](https://skmtc.dev/usecrow/apis/crow-backend-multi-tenant-saas/revisions/66e6366f8ef9?raw)