Skip to main content
POST
Cancel Check Run

Overview

Marks a PENDING or RUNNING run CANCELLED and stops its scoring work. A cancelled run never produces a final verdict, and cancelling frees the environment so a new run can be started with Start Check Run. Returns 409 CONFLICT when the run is already PASSED, FAILED, ERROR, or CANCELLED. Cancelling never changes an environment pointer. Requires an admin, owner, operator, or prompter role. This endpoint takes no body.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.
string
required
The check run’s unique identifier.

Response

object
The cancelled run, with status set to CANCELLED and completed_at set to the cancellation time.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt