Mobilerun Executions API
The Executions API from Mobilerun — 5 operation(s) for executions.
Operations 5
GET
/executions/{executionId}/screenshots/{screenshotId}
Redirect to a freshly signed screenshot URL
#
The Executions API from Mobilerun — 5 operation(s) for executions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-executions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Mobilerun Ai Executions API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Executions across 2 of this provider''s published API definitions: openapi.json, mobilerun-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
security:
- bearerAuth: []
tags:
- name: Executions
x-group: Workflows
paths:
/executions:
get:
tags:
- Executions
summary: List flow executions
operationId: listExecutions
description: Return a paginated history of flow executions. Supports filtering by `flowId`, `triggerId`, `invocationId` (the client/verify key), `status`, and a `from`/`to` time range, plus free-text `search` and ordering by startedAt, finishedAt, or status.
responses:
'200':
description: Execution history
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/FlowExecutionListItem'
pagination:
$ref: '#/components/schemas/Pagination'
required:
- items
- pagination
parameters:
- schema:
type: integer
exclusiveMinimum: 0
default: 1
required: false
name: page
in: query
- schema:
type: integer
exclusiveMinimum: 0
default: 10
required: false
name: pageSize
in: query
- schema:
type: string
format: uuid
required: false
name: flowId
in: query
- schema:
type: string
format: uuid
required: false
name: triggerId
in: query
- schema:
type: string
format: uuid
required: false
name: invocationId
in: query
- schema:
type: string
enum:
- pending
- running
- success
- failed
- cancelled
- skipped
- invalid
required: false
name: status
in: query
- schema:
type:
- string
- 'null'
format: date-time
required: false
name: from
in: query
- schema:
type:
- string
- 'null'
format: date-time
required: false
name: to
in: query
- schema:
type: string
minLength: 1
maxLength: 256
required: false
name: search
in: query
- schema:
type: string
enum:
- startedAt
- finishedAt
- status
default: startedAt
required: false
name: orderBy
in: query
- schema:
type: string
enum:
- asc
- desc
default: desc
required: false
name: orderByDirection
in: query
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/executions/metrics:
get:
tags:
- Executions
summary: Get execution metrics
operationId: getExecutionMetrics
description: Return aggregate execution metrics — total count, counts by status, average duration, and the last execution time. Can be scoped by `flowId`, `triggerId`, and a `from`/`to` time range.
responses:
'200':
description: Execution metrics
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ExecutionMetrics'
required:
- data
parameters:
- schema:
type: string
format: uuid
required: false
name: flowId
in: query
- schema:
type: string
format: uuid
required: false
name: triggerId
in: query
- schema:
type:
- string
- 'null'
format: date-time
required: false
name: from
in: query
- schema:
type:
- string
- 'null'
format: date-time
required: false
name: to
in: query
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/executions/{executionId}:
get:
tags:
- Executions
summary: Get execution details
operationId: getExecution
description: Fetch a single flow execution by its ID, including its status, kind, result or error, and start/finish timestamps. Returns 404 if no execution matches.
responses:
'200':
description: Execution details
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/FlowExecutionDetail'
required:
- data
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
format: uuid
required: true
name: executionId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/executions/{executionId}/screenshots/{screenshotId}:
get:
tags:
- Executions
summary: Redirect to a freshly signed screenshot URL
operationId: getExecutionScreenshot
description: 'Redirects (302) to a freshly signed, time-limited image URL for a screenshot captured during this execution. Owner-gated: 404 if the execution or the screenshot does not belong to the caller.'
responses:
'302':
description: Redirect to the signed screenshot image URL
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
format: uuid
required: true
name: executionId
in: path
- schema:
type: string
format: uuid
required: true
name: screenshotId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/executions/{executionId}/abort:
post:
tags:
- Executions
summary: Abort a running or pending execution
description: 'Stops the execution between steps and marks it cancelled. Idempotent-ish: already-terminal executions return 409.'
operationId: abortExecution
responses:
'200':
description: Execution aborted
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/FlowExecution'
required:
- data
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'409':
description: Conflict
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
format: uuid
required: true
name: executionId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
ExecutionFile:
type: object
properties:
fileId:
type: string
format: uuid
filename:
type: string
mimeType:
type: string
sizeBytes:
type: integer
minimum: 0
required:
- fileId
- filename
- mimeType
- sizeBytes
ApiErrorEnvelope:
type: object
properties:
code:
type: string
message:
type: string
details: {}
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
FlowExecution:
type: object
properties:
id:
type: string
format: uuid
flowId:
type: string
format: uuid
triggerId:
type: string
format: uuid
eventId:
type:
- string
- 'null'
format: uuid
invocationId:
type:
- string
- 'null'
format: uuid
description: Client/verify invocation key this row belongs to. Set on live custom fires (one row per device fan-out) and on verification runs; null for event/schedule live rows.
deviceId:
type:
- string
- 'null'
format: uuid
description: Device this execution targets (the job's deviceId). Null for device-less (event-only) runs.
flowName:
type:
- string
- 'null'
triggerName:
type:
- string
- 'null'
status:
type:
- string
- 'null'
enum:
- pending
- running
- success
- failed
- cancelled
- skipped
- invalid
- null
kind:
type: string
enum:
- live
- dry_run
- verification
result:
description: 'Opaque per-step result blob ({ steps: [...] }). Each step additionally carries a `verdict` field ({ outcome, summary, reason? } | null) when it is an agent.run step that opted into a verdict — null otherwise. Steps of current executions also carry a `status` string (e.g. success/failed/stopped); it is optional and absent on older executions, so clients must not assume its presence.'
error:
type:
- string
- 'null'
recordingId:
type:
- string
- 'null'
format: uuid
description: Device recording id for this execution, set once recording starts. Null when the flow has recording disabled, no device is bound, or the recording failed to start.
recordingDeviceId:
type:
- string
- 'null'
format: uuid
startedAt:
type:
- string
- 'null'
format: date-time
finishedAt:
type:
- string
- 'null'
format: date-time
required:
- id
- flowId
- triggerId
- eventId
- invocationId
- deviceId
- flowName
- triggerName
- status
- kind
- error
- recordingId
- recordingDeviceId
- startedAt
- finishedAt
FlowExecutionListItem:
allOf:
- $ref: '#/components/schemas/FlowExecution'
- type: object
properties:
createdBy:
type:
- string
- 'null'
format: uuid
recordings:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
flowActionId:
type:
- string
- 'null'
format: uuid
stepIndex:
type: integer
parentIndex:
type: integer
iterationIndex:
type: integer
childIndex:
type: integer
attempt:
type: integer
minimum: 0
scope:
type: string
enum:
- flow
- step
status:
type: string
enum:
- starting
- recording
- stopping
- stopped
- failed
recordingId:
type:
- string
- 'null'
format: uuid
recordingDeviceId:
type:
- string
- 'null'
format: uuid
startedAt:
type:
- string
- 'null'
format: date-time
stoppedAt:
type:
- string
- 'null'
format: date-time
lastError:
type:
- string
- 'null'
required:
- id
- flowActionId
- stepIndex
- parentIndex
- iterationIndex
- childIndex
- attempt
- scope
- status
- recordingId
- recordingDeviceId
- startedAt
- stoppedAt
- lastError
description: Durable recording segments ordered by step/loop coordinate and retry attempt. Whole-flow recordings use -1 for every coordinate.
required:
- createdBy
- recordings
FlowExecutionDetail:
allOf:
- $ref: '#/components/schemas/FlowExecution'
- type: object
properties:
createdBy:
type:
- string
- 'null'
format: uuid
agentId:
type:
- string
- 'null'
format: uuid
description: Current agent assignment of the owner-scoped parent flow; null when unassigned.
recordings:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
flowActionId:
type:
- string
- 'null'
format: uuid
stepIndex:
type: integer
parentIndex:
type: integer
iterationIndex:
type: integer
childIndex:
type: integer
attempt:
type: integer
minimum: 0
scope:
type: string
enum:
- flow
- step
status:
type: string
enum:
- starting
- recording
- stopping
- stopped
- failed
recordingId:
type:
- string
- 'null'
format: uuid
recordingDeviceId:
type:
- string
- 'null'
format: uuid
startedAt:
type:
- string
- 'null'
format: date-time
stoppedAt:
type:
- string
- 'null'
format: date-time
lastError:
type:
- string
- 'null'
required:
- id
- flowActionId
- stepIndex
- parentIndex
- iterationIndex
- childIndex
- attempt
- scope
- status
- recordingId
- recordingDeviceId
- startedAt
- stoppedAt
- lastError
description: Durable recording segments ordered by step/loop coordinate and retry attempt. Whole-flow recordings use -1 for every coordinate.
files:
type: array
items:
$ref: '#/components/schemas/ExecutionFile'
description: Files produced by files.upload steps, plus files an agent.run step reported on its terminal response (agent-created output or a workflow upload minted during the turn); derived server-side at read time.
progress:
type:
- object
- 'null'
properties:
total:
type: integer
currentIndex:
type:
- integer
- 'null'
steps:
type: array
items:
type: object
properties:
index:
type: integer
name:
type: string
service:
type: string
method:
type: string
status:
type: string
enum:
- pending
- running
- success
- failed
- skipped
- cancelled
attempt:
type: integer
minimum: 0
description: Zero-based retry attempt of the execution job during which this step last ran (0 = initial attempt). Not a per-step retry counter; may undercount after crash recovery.
startedAt:
type:
- string
- 'null'
format: date-time
finishedAt:
type:
- string
- 'null'
format: date-time
sessionId:
type:
- string
- 'null'
required:
- index
- name
- service
- method
- status
- startedAt
- finishedAt
- sessionId
required:
- total
- currentIndex
- steps
description: Live progress; null for runs started before this feature.
deliveries:
type: array
items:
type: object
properties:
artifact:
type: string
enum:
- recording
- file
- screenshot
stepIndex:
type:
- integer
- 'null'
destination:
type: string
enum:
- mobilerun
- one_drive
- google_drive
folder:
type:
- string
- 'null'
filename:
type: string
status:
type: string
enum:
- waiting
- uploading
- succeeded
- failed
- unknown
- cancelled
errorCode:
type:
- string
- 'null'
webUrl:
type:
- string
- 'null'
startedAt:
type:
- string
- 'null'
format: date-time
finishedAt:
type:
- string
- 'null'
format: date-time
required:
- artifact
- stepIndex
- destination
- folder
- filename
- status
- errorCode
- webUrl
- startedAt
- finishedAt
description: OneDrive/Google Drive delivery lifecycle for this run's recording, file, and screenshot uploads, ordered by startedAt. Empty when the flow has no delivery configured.
screenshots:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
source:
type: string
enum:
- task
- agent
- recording
stepName:
type: string
stepIndex:
type: integer
iterationIndex:
type: integer
seq:
type: integer
capturedAt:
type:
- string
- 'null'
format: date-time
mimeType:
type: string
required:
- id
- source
- stepName
- stepIndex
- iterationIndex
- seq
- capturedAt
- mimeType
description: Screenshots captured by tasks.run/agent.run steps and saved by scripts into the flow screenshots recording (source recording), ordered by seq. Image bytes are never returned here — fetch a fresh signed URL via GET /executions/{id}/screenshots/{screenshotId}.
repair:
type:
- object
- 'null'
properties:
episode:
type: integer
exclusiveMinimum: 0
status:
type: string
enum:
- pending
- running
- canary
- promoting
- repaired
- failed
- escalated
verdict:
type:
- object
- 'null'
properties:
outcome:
type: string
enum:
- ok
- flaky
- broken
summary:
type: string
reason:
type: string
required:
- outcome
- summary
chatSessionId:
type:
- string
- 'null'
format: uuid
episodeId:
type: string
format: uuid
terminal:
type: boolean
required:
- episode
- status
- verdict
- chatSessionId
- episodeId
- terminal
required:
- createdBy
- agentId
- recordings
- files
- progress
- deliveries
- screenshots
- repair
Pagination:
type: object
properties:
hasNext:
type: boolean
hasPrev:
type: boolean
page:
type: integer
minimum: 1
pageSize:
type: integer
minimum: 1
pages:
type: integer
minimum: 0
total:
type: integer
minimum: 0
required:
- hasNext
- hasPrev
- page
- pageSize
- pages
- total
ExecutionMetrics:
type: object
properties:
total:
type: integer
byStatus:
type: object
properties:
pending:
type: integer
running:
type: integer
success:
type: integer
failed:
type: integer
cancelled:
type: integer
skipped:
type: integer
invalid:
type: integer
required:
- pending
- running
- success
- failed
- cancelled
- skipped
- invalid
avgDurationMs:
type:
- number
- 'null'
lastExecutionAt:
type:
- string
- 'null'
format: date-time
required:
- total
- byStatus
- avgDurationMs
- lastExecutionAt
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: Opaque
description: Bearer token via Authorization header
x-refined-from:
- openapi.json
- mobilerun-ai-openapi.json
x-provenance:
method: harvested
publisher: Mobilerun
source: https://api.mobilerun.ai/v1/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)