---
title: "Run a flow now"
method: POST
path: "/flows/{flowId}/run"
tags: ["Flows"]
---

# Run a flow now

`POST /flows/{flowId}/run`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/flows/{flowId}/run`
- Auth: HTTP bearer

Immediately enqueue one live execution on every device bound to the flow, regardless of whether its trigger is event-based, custom, or scheduled.

Supports an optional `Idempotency-Key` header (1-255 printable ASCII characters). The run identity is derived from the key, so a retry never starts a second run. Replays with the same key and an identical body return the original status and the original `executionIds`; a changed body under the same key returns 422 `idempotency_key_reused`.

## Path parameters

- `flowId` string, uuid, required

## Headers

- `idempotency-key` string: Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.

## Request body

- RunFlowBody
  - `payload` object
  - `captureScreenshots` boolean: Record and keep this run's scripts.run screenshots (device.screenshot(save=True)) even without flow delivery. Used for a one-off proof run.

## Response `202`

Flow executions enqueued

- object
  - `data` object, required
    - `enqueuedCount` integer, required
    - `executionIds` string[], required: Ids of the executions this run created. An idempotent replay returns the ids of the original run.

## Other responses

- `404`: Flow not found
- `409`: Flow is blocked
- `422`: Validation Error

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/flows/:flowId/run/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)