---
title: "Stop a Maestro run"
method: POST
path: "/v1/app-automate/maestro/{project_id}/{run_id}/stop"
tags: ["App-automate Maestro"]
---

# Stop a Maestro run

`POST /v1/app-automate/maestro/{project_id}/{run_id}/stop`

Cancels a running Maestro run before it completes. Already-completed flows are preserved; in-flight flows are marked cancelled. Alias of the cancel endpoint, kept because testingbotctl calls it from its Ctrl-C handler; unlike cancel it always answers 200, so stopping an already-finished run is a no-op rather than a 409.

## Path parameters

- `project_id` integer, required
- `run_id` integer, required

## Response `201`

Stop a Maestro run

- TestingbotEntitiesAck — Testingbot_Entities_Ack model
  - `success` boolean, required — Whether the operation succeeded.
  - `errors` object, required — Validation errors keyed by field name. Only present when `success` is false.
  - `error` string, required — Single human-readable reason, used by the older endpoints in place of `errors`. Only present when `success` is false.

---

[API](https://skmtc.dev/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.dev/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/revisions/235c6ba65e6f/schema)