---
title: "Cancel test run"
method: PUT
path: "/v2/test-runs/{testRunId}/cancel"
tags: ["Test Runs"]
---

# Cancel test run

`PUT /v2/test-runs/{testRunId}/cancel`

## Request

- Base URL: `https://app.aiva.works` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aiva.works/v2/test-runs/{testRunId}/cancel`
- Auth: API key in header `X-API-KEY`

Endpoint for cancellation of a test run.

## Path parameters

- `testRunId` string, guid, required

## Query parameters

- `force` boolean

## Response `202`

Test run cancelled

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Test run not found
- `500`: Server Error

---

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