Mobilerun Executions API

The Executions API from Mobilerun — 5 operation(s) for executions.

GitHub OpenAPI

Operations 5

GET /executions List flow executions #
GET /executions/metrics Get execution metrics #
GET /executions/{executionId} Get execution details #
GET /executions/{executionId}/screenshots/{screenshotId} Redirect to a freshly signed screenshot URL #
POST /executions/{executionId}/abort Abort a running or pending execution #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-executions-api"
All apis
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.

Get an API 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 Specification

mobilerun-ai-executions-api-openapi.yml Raw ↑
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)