Mobilerun Flow Actions API
The Flow Actions API from Mobilerun — 2 operation(s) for flow actions.
The Flow Actions API from Mobilerun — 2 operation(s) for flow actions.
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-flow-actions-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 Flow Actions API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Flow Actions 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: Flow Actions
x-group: Workflows
paths:
/flows/{flowId}/actions:
get:
tags:
- Flow Actions
summary: List actions for a flow
operationId: listFlowActions
description: Return the ordered list of actions attached to a flow, including any nested child actions. Returns 404 if the flow does not exist.
responses:
'200':
description: Flow actions
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/FlowAction'
required:
- data
'404':
description: Flow not found
content:
application/json:
schema:
$ref: '#/components/schemas/FlowNotFoundError'
parameters:
- schema:
type: string
format: uuid
required: true
name: flowId
in: path
put:
tags:
- Flow Actions
summary: Replace all actions for a flow
operationId: setFlowActions
description: Replace a flow's entire action list with the supplied set (at least one required). Each action references an `actionId` and a unique `position`, and may include nested `children`, a `nameOverride`, param `overrides`, and a `continueOnError` flag. Returns 404 if the flow does not exist.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetFlowActionsBody'
responses:
'200':
description: Flow actions replaced
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/FlowAction'
required:
- data
'400':
description: Flow action or template reference validation failed
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/FlowActionValidationError'
- $ref: '#/components/schemas/FlowTemplateReferenceInvalidError'
'404':
description: Flow not found
content:
application/json:
schema:
$ref: '#/components/schemas/FlowNotFoundError'
'409':
description: Flow deployment is in progress
content:
application/json:
schema:
type: object
properties:
code:
type: string
enum:
- flow_deploy_in_progress
message:
type: string
required:
- code
- message
parameters:
- schema:
type: string
format: uuid
required: true
name: flowId
in: path
post:
tags:
- Flow Actions
summary: Add an action to a flow
operationId: addFlowAction
description: 'Append a single action to a flow at the given `position`, optionally nesting it under a `parentFlowActionId` or supplying its own `children`. Supports a `nameOverride`, param `overrides`, and `continueOnError`. Returns 404 if the flow does not exist.
Supports an optional `Idempotency-Key` header (1-255 printable ASCII characters). Replays with the same key and an identical body return the original 201; a changed body under the same key returns 422 `idempotency_key_reused`.'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddFlowActionBody'
responses:
'201':
description: Flow action added
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/FlowAction'
required:
- data
'400':
description: Flow action or template reference validation failed
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/FlowActionValidationError'
- $ref: '#/components/schemas/FlowTemplateReferenceInvalidError'
'404':
description: Flow not found
content:
application/json:
schema:
$ref: '#/components/schemas/FlowNotFoundError'
'409':
description: Flow deployment is in progress
content:
application/json:
schema:
type: object
properties:
code:
type: string
enum:
- flow_deploy_in_progress
message:
type: string
required:
- code
- message
parameters:
- schema:
type: string
format: uuid
required: true
name: flowId
in: path
- schema:
type: string
minLength: 1
maxLength: 255
pattern: ^[\x21-\x7E]{1,255}$
description: '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.'
example: b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f
required: false
description: '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.'
name: idempotency-key
in: header
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/flows/{flowId}/actions/{flowActionId}:
delete:
tags:
- Flow Actions
summary: Remove an action from a flow
operationId: removeFlowAction
description: Remove a single action from a flow by its `flowActionId`. Returns 404 if the flow or flow action does not exist.
responses:
'200':
description: Flow action removed
content:
application/json:
schema:
type: object
properties:
message:
type: string
required:
- message
'400':
description: Flow action or template reference validation failed
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/FlowActionValidationError'
- $ref: '#/components/schemas/FlowTemplateReferenceInvalidError'
'404':
description: Flow action not found
content:
application/json:
schema:
$ref: '#/components/schemas/FlowActionNotFoundError'
'409':
description: Flow deployment is in progress
content:
application/json:
schema:
type: object
properties:
code:
type: string
enum:
- flow_deploy_in_progress
message:
type: string
required:
- code
- message
parameters:
- schema:
type: string
format: uuid
required: true
name: flowId
in: path
- schema:
type: string
format: uuid
required: true
name: flowActionId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
FlowActionOverrides:
type:
- object
- 'null'
properties:
params:
type: object
additionalProperties: {}
additionalProperties: false
FlowNotFoundError:
type: object
properties:
code:
type: string
enum:
- flow_not_found
message:
type: string
required:
- code
- message
FlowValidationCode:
type: string
enum:
- delivery_invalid
- step_key_invalid
- upload_params_invalid
- device_free_actions_invalid
- flow_action_invalid
- state_step_duplicate
- state_step_in_loop
- state_key_mixed
- state_input_reserved
- dataset_items_invalid_source
- dataset_in_loop
- dataset_key_duplicate
- dataset_key_invalid
FlowAction:
type: object
properties:
id:
type: string
format: uuid
flowId:
type: string
format: uuid
actionId:
type: string
format: uuid
parentFlowActionId:
type:
- string
- 'null'
format: uuid
position:
type: integer
continueOnError:
type: boolean
nameOverride:
type:
- string
- 'null'
key:
type: string
overrides:
type:
- object
- 'null'
properties:
params:
type: object
additionalProperties: {}
recordingEnabled:
type: boolean
description: Selected for per-step recording under the flow's "selected_steps" recording policy.
createdAt:
type:
- string
- 'null'
format: date-time
required:
- id
- flowId
- actionId
- parentFlowActionId
- position
- continueOnError
- nameOverride
- key
- overrides
- recordingEnabled
- createdAt
AddFlowActionBody:
type: object
properties:
actionId:
type: string
format: uuid
position:
type: integer
minimum: 0
continueOnError:
type: boolean
default: false
nameOverride:
type: string
minLength: 1
maxLength: 256
key:
type: string
pattern: ^[a-z_][a-z0-9_-]{0,63}$
description: Stable identifier used by template resolution v2+ to address this step as {{key.field}}. Omitted keys are derived from the step name whenever a flow is created. For template resolution v3, replacing an existing flow's full action tree requires every step to carry an explicit key — a missing key is rejected there, not derived, so a name change can never silently move a step's key.
overrides:
$ref: '#/components/schemas/FlowActionOverrides'
recordingEnabled:
type: boolean
default: false
parentFlowActionId:
type:
- string
- 'null'
format: uuid
children:
type: array
items:
$ref: '#/components/schemas/FlowChildActionInput'
required:
- actionId
- position
additionalProperties: false
FlowActionInput:
type: object
properties:
actionId:
type: string
format: uuid
position:
type: integer
minimum: 0
continueOnError:
type: boolean
default: false
nameOverride:
type: string
minLength: 1
maxLength: 256
key:
type: string
pattern: ^[a-z_][a-z0-9_-]{0,63}$
description: Stable identifier used by template resolution v2+ to address this step as {{key.field}}. Omitted keys are derived from the step name whenever a flow is created. For template resolution v3, replacing an existing flow's full action tree requires every step to carry an explicit key — a missing key is rejected there, not derived, so a name change can never silently move a step's key.
overrides:
$ref: '#/components/schemas/FlowActionOverrides'
recordingEnabled:
type: boolean
default: false
children:
type: array
items:
$ref: '#/components/schemas/FlowChildActionInput'
required:
- actionId
- position
additionalProperties: false
FlowActionNotFoundError:
type: object
properties:
code:
type: string
enum:
- flow_action_not_found
message:
type: string
required:
- code
- message
FlowActionValidationError:
type: object
properties:
code:
type: string
enum:
- bad_request
message:
type: string
details:
type: array
items:
$ref: '#/components/schemas/FlowValidationDetail'
required:
- code
- message
FlowChildActionInput:
type: object
properties:
actionId:
type: string
format: uuid
position:
type: integer
minimum: 0
continueOnError:
type: boolean
default: false
nameOverride:
type: string
minLength: 1
maxLength: 256
key:
type: string
pattern: ^[a-z_][a-z0-9_-]{0,63}$
description: Stable identifier used by template resolution v2+ to address this step as {{key.field}}. Omitted keys are derived from the step name whenever a flow is created. For template resolution v3, replacing an existing flow's full action tree requires every step to carry an explicit key — a missing key is rejected there, not derived, so a name change can never silently move a step's key.
overrides:
$ref: '#/components/schemas/FlowActionOverrides'
recordingEnabled:
type: boolean
default: false
required:
- actionId
- position
additionalProperties: false
FlowTemplateReferenceInvalidError:
type: object
properties:
code:
type: string
enum:
- template_reference_invalid
message:
type: string
enum:
- Template reference validation failed
details:
type: array
items:
type: object
properties:
field:
type: string
message:
type: string
reference:
type: string
knownSteps:
type: array
items:
type: string
maxItems: 30
required:
- field
- message
required:
- code
- message
- details
SetFlowActionsBody:
type: object
properties:
actions:
type: array
items:
$ref: '#/components/schemas/FlowActionInput'
minItems: 1
required:
- actions
additionalProperties: false
FlowValidationDetail:
type: object
properties:
code:
$ref: '#/components/schemas/FlowValidationCode'
field:
type: string
message:
type: string
actionId:
type: string
required:
- code
- field
- message
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)