Skip to main content
POST
/
api
/
test-runs
/
{id}
/
cancel
curl -X POST \
  "https://dash.empirical.run/api/test-runs/456/cancel" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

{
  "message": "Test run cancelled successfully"
}
Cancels a test run that is currently in progress or pending. The test run will transition to the cancelling state and then to cancelled once the operation completes.

​
Request

​
Authorization
string
required
Bearer token for authentication. Format: Bearer <your-api-key>
​
id
number
required
The unique identifier of the test run to cancel.
​
reason
string
Optional reason for cancelling the test run. This will be recorded for auditing purposes.

​
Response

​
message
string
Confirmation message indicating the test run was cancelled.
curl -X POST \
  "https://dash.empirical.run/api/test-runs/456/cancel" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

{
  "message": "Test run cancelled successfully"
}