---
title: "Run a Maestro app flow"
method: POST
path: "/v1/app-automate/maestro/{id}/run"
tags: ["App-automate Maestro"]
---

# Run a Maestro app flow

`POST /v1/app-automate/maestro/{id}/run`

Triggers an asynchronous Maestro run on the uploaded project against one or more device capabilities. Returns one run entry per capability.

## Path parameters

- `id` integer, required

## Response `201`

Run a Maestro app flow

- TestingbotEntitiesAppAutomateRunStarted — Testingbot_Entities_AppAutomateRunStarted model
  - `success` boolean, required — Whether the run was accepted.
  - `id` integer, required — Numeric project ID the runs belong to.
  - `runs` object[], required — One entry per device/capability combination the run fanned out to.
  - `errors` string[], required — Capability combinations that were rejected. Present alongside `runs` when only some combinations were valid.
  - `update_server` string, required — Realtime endpoint the runner streams step updates to.
  - `update_key` string, required — Channel key to use against `update_server` for this project.

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/8f493cca8f92/schema)