---
title: "Trigger Run"
method: POST
path: "/api/admin/agent-eval/runs"
tags: ["admin"]
---

# Trigger Run

`POST /api/admin/agent-eval/runs`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/admin/agent-eval/runs`
- Auth: none declared

Queue a run and dispatch the drain job to execute it.

202, not 200: the row exists and the work is dispatched, but nothing has run
yet. The client polls ``GET /runs`` for the outcome.

## Request body

- TriggerRunRequest
  - `agent_identity_id` string, required
  - `probe_ids` string[], nullable

## Response `202`

Successful Response

- RunView
  - `id` string, required
  - `target_identity_id` string, required
  - `target_display_name` string, nullable, required
  - `triggered_by_identity_id` string, required
  - `probe_ids` string[], required
  - `status` string, required
  - `error_message` string, nullable, required
  - `agent_cost_usd` number, nullable, required
  - `judge_cost_usd` number, nullable, required
  - `total_cost_usd` number, nullable, required
  - `total_duration_s` number, nullable, required
  - `scenarios_total` integer, nullable, required
  - `scenarios_passed` integer, nullable, required
  - `findings_reproduced` integer, nullable, required
  - `findings_covered` integer, nullable, required
  - `started_at` string, nullable, required
  - `finished_at` string, nullable, required
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

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