# Skill runs

Source: https://webagent-docs-staging.lookover.ai/api-reference/skill-runs

> Run a skill and read its result.

## GET /v1/skill-runs

List skill runs, newest first

Parameters:
- `limit` (query): integer
- `cursor` (query): string
- `status` (query): ("running" | "passed" | "failed" | "error" | "cancelled" | "denied")[]
- `skill` (query): string

Responses: 200 `ListSkillRunsResponse`, default `ErrorBody`

## GET /v1/skill-runs/{id}

Get a skill run and its result

Parameters:
- `id` (path, required): string

Responses: 200 `SkillRunDetail`, default `ErrorBody`

## GET /v1/skill-runs/{id}/report

The run's HTML report

Parameters:
- `id` (path, required): string

Responses: 302, default `ErrorBody`

## GET /v1/skill-runs/{id}/report.json

The run's test report as JSON (verdict, plain-language summary, failed steps with screenshot links, findings, console errors, failed network calls). `running` while it has not finished. 404 `not_found` for an unknown or another project's run. `GET /v1/skill-runs/{id}/report` is the HTML report

Parameters:
- `id` (path, required): string

Responses: 200 `RunReport`, default `ErrorBody`

## POST /v1/skills/{name}/run

Start a skill run

Parameters:
- `name` (path, required): string
- `Idempotency-Key` (header): string. Retry safely: the same key and body replay the first answer.

Request body (JSON): `RunSkillRequest`

Responses: 202 `SkillRunAccepted`, default `ErrorBody`