Flows

Run a bound, deduplicated verification of this flow on exactly one device as a real run.

Unlike a normal trigger firing, verification:

  • runs a flow that is enabled OR disabled (an archived flow returns 404);
  • targets one device (deviceId, or the single bound device);
  • is idempotent per invocationId: a repeat returns the existing run (deduplicated: true, HTTP 200) instead of enqueuing another (HTTP 202);
  • never mutates flow health, lastTriggeredAt, or the repair loop.

Per-activation payload gate:

  • custom: validates the payload against the custom payload schema (422 on failure).
  • event: validates the payload against the event catalog schema and evaluates the trigger conditions; a failing gate returns 409 conditions_not_met with the dry-run report.
  • schedule: the payload is ignored.
post/flows/{flowId}/verify

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/flows/{flowId}/verify
  • Auth
    HTTP bearer

Path parameters

flowIdstring uuid required

Request body

invocationIdstring uuid required

Client-supplied idempotency key. A repeat request for the same (flow, invocationId) returns the existing verification run (deduplicated: true, HTTP 200) instead of enqueuing another.

deviceIdstring uuid

Device to run the verification on. Must be one the flow is bound to. Optional only when the flow is bound to exactly one device (that device is used); otherwise required.

payloadobject

Response

Verification run already existed (deduplicated)

Changes