---
title: "Cancel test run"
method: POST
path: "/api/apps/{app_id}/testing-agent/executions/{execution_id}/cancel"
---

# Cancel test run

`POST /api/apps/{app_id}/testing-agent/executions/{execution_id}/cancel`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/testing-agent/executions/{execution_id}/cancel`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Stops a test run that's still going and closes its browser session. The run ends with `status` set to `cancelled`.

Cancelling a run that already ended changes nothing and returns `already_terminal` set to `true`, so retrying is safe.

This is limited to 300 requests per minute per caller for each app. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. Read-only keys and workspace API keys are refused.</Note>

## Path parameters

- `app_id` string, required: ID of the app.
- `execution_id` string, required: ID of the run to cancel.

## Response `200`

The run is cancelled or had already ended.

- CancelTestRunResult: The result of cancelling a run.
  - `success` boolean, required: Always `true`.
  - `already_terminal` boolean, nullable: `true` when the run had already ended, so nothing changed. Left out when the run was cancelled.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have editor access to this app, the app is blocked, or your API key is read-only or a workspace API key.
- `404`: App or run not found.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-09-29** `d2b7ac8beb0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/testing-agent/executions/:execution_id/cancel/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)