---
title: "Launch Admin Test Run"
method: POST
path: "/v1/admin/tests/runs"
tags: ["Public API v1"]
---

# Launch Admin Test Run

`POST /v1/admin/tests/runs`

## Request

- Base URL: `https://api.corvio.ai`
- URL: `https://api.corvio.ai/v1/admin/tests/runs`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, nullable

## Request body

- PublicDeveloperTestLaunchRequest
  - `selection_kind` 'cases' | 'suite', required
  - `case_ids` string[]
  - `suite_id` string, nullable
  - `reason` 'product_changed' | 'fixture_topology_changed' | 'final_acceptance', required
  - `max_concurrency` integer

## Response `202`

Successful Response

- PublicDeveloperTestRunResponse
  - `id` string, uuid, required
  - `object` 'test_run'
  - `workspace_id` string, uuid, required
  - `status` string, required
  - `selection_kind` string, required
  - `selection` object, required
  - `assets` object[], required
  - `environment` string, required
  - `reason` string, required
  - `max_concurrency` integer, required
  - `summary` object, nullable, required
  - `error` object, nullable, required
  - `requested_at` string, date-time, required
  - `started_at` string, date-time, nullable, required
  - `finished_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `links` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/corvio/apis/corvio-developer-api.md) · [All operations](https://skmtc.dev/corvio/apis/corvio-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corvio/apis/corvio-developer-api/revisions/a5a77bb9619c?raw)