Mobilerun Events API
The Events API from Mobilerun — 2 operation(s) for events.
The Events API from Mobilerun — 2 operation(s) for events.
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-events-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 Events API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Events 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: Events
x-group: Workflows
paths:
/events/dry-run:
post:
tags:
- Events
summary: Simulate event matching (dry run)
operationId: dryRunEvent
description: Simulate an event against all configured flows. Returns which flows would match and what actions would run, without storing the event or enqueuing jobs.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IngestEventBody'
responses:
'200':
description: Dry-run result
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/DryRunResult'
required:
- data
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/events/ingest:
post:
tags:
- Events
summary: Ingest an event
operationId: ingestEvent
description: Ingest an event for trigger evaluation. Returns immediately with 202 Accepted.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IngestEventBody'
responses:
'202':
description: Event accepted for processing
content:
application/json:
schema:
type: object
properties:
eventId:
type: string
format: uuid
required:
- eventId
'422':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
details:
type: array
items:
type: object
properties:
field:
type: string
message:
type: string
required:
- field
- message
required:
- error
- details
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
DryRunMatchedFlow:
type: object
properties:
flow:
$ref: '#/components/schemas/Flow'
trigger:
$ref: '#/components/schemas/Trigger'
actions:
type: array
items:
$ref: '#/components/schemas/ResolvedAction'
gates:
$ref: '#/components/schemas/DryRunGates'
wouldFire:
type: boolean
required:
- flow
- trigger
- actions
- gates
- wouldFire
AgentLifecycleStatus:
type: string
enum:
- enabled
- disabled
- archived
ResultDelivery:
type: string
enum:
- none
- message
- wake
ApiErrorEnvelope:
type: object
properties:
code:
type: string
message:
type: string
details: {}
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
RecordingPolicyMode:
type: string
enum:
- 'off'
- flow
- selected_steps
DryRunGates:
type: object
properties:
enabled:
type: boolean
deviceAttached:
type: boolean
deviceIds:
type: array
items:
type: string
format: uuid
blocked:
type: boolean
cooldownActive:
type:
- boolean
- 'null'
required:
- enabled
- deviceAttached
- deviceIds
- blocked
- cooldownActive
ResolvedAction:
type: object
properties:
key:
type: string
name:
type: string
service:
type: string
enum:
- tasks_api
- devices_api
- agents_api
- webhooks
- integrations_api
- triggers_api
method:
type: string
params:
type: object
additionalProperties: {}
continueOnError:
type: boolean
flowActionId:
type: string
format: uuid
recordingEnabled:
type: boolean
children:
type: array
items: {}
description: Nested child actions (loop/branch bodies), each the same shape as a ResolvedAction.
required:
- key
- name
- service
- method
- continueOnError
- flowActionId
- recordingEnabled
DryRunResult:
type: object
properties:
validation:
$ref: '#/components/schemas/DryRunValidation'
matchedFlows:
type: array
items:
$ref: '#/components/schemas/DryRunMatchedFlow'
required:
- validation
- matchedFlows
Flow:
type: object
properties:
id:
type: string
format: uuid
userId:
type: string
format: uuid
deprecated: true
description: 'Deprecated: use ownerId (tenancy) / createdBy (actor).'
ownerId:
type: string
format: uuid
agentId:
type:
- string
- 'null'
format: uuid
createdBy:
type:
- string
- 'null'
format: uuid
name:
type: string
description:
type:
- string
- 'null'
triggerId:
type: string
format: uuid
enabled:
type: boolean
description: Compatibility projection of lifecycleStatus; true only when lifecycleStatus is enabled.
lifecycleStatus:
$ref: '#/components/schemas/AgentLifecycleStatus'
archivedAt:
type:
- string
- 'null'
format: date-time
deviceIds:
type: array
items:
type: string
format: uuid
cooldownSeconds:
type:
- integer
- 'null'
cooldownScope:
type: string
enum:
- flow
- device
notifyWebhookId:
type:
- string
- 'null'
format: uuid
notifyOnSuccess:
type: boolean
notifyOnFailure:
type: boolean
ownerWake:
$ref: '#/components/schemas/OwnerWake'
lastTriggeredAt:
type:
- string
- 'null'
format: date-time
status:
$ref: '#/components/schemas/FlowStatus'
templateResolutionVersion:
type: integer
minimum: 1
maximum: 3
description: Template-resolver semantics this flow runs under. 1 = legacy (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw, a whole-token null stays JSON null). 3 = typed, key-based (steps are addressed as {{steps.<key>...}} instead of by name; trigger.payload is not available). Existing flows stay 1; new flows default to the current version.
consecutiveFailures:
type: integer
minimum: 0
lastFailureCode:
$ref: '#/components/schemas/FlowFailureCode'
lastFailureAt:
type:
- string
- 'null'
format: date-time
blockedAt:
type:
- string
- 'null'
format: date-time
healthMonitoringEnabled:
type: boolean
selfHealingEnabled:
type: boolean
selfHealingMaxAttempts:
type: integer
minimum: 1
maximum: 5
recordingEnabled:
type: boolean
deprecated: true
description: 'Deprecated: use recordingPolicy.mode ("flow" = recordingEnabled=true, "off" = recordingEnabled=false).'
recordingPolicy:
$ref: '#/components/schemas/RecordingPolicy'
delivery:
type:
- object
- 'null'
properties:
destination:
type: string
enum:
- mobilerun
- one_drive
- google_drive
folder:
type: string
minLength: 1
maxLength: 1024
description: Absolute destination folder; not allowed when destination is mobilerun. May contain {{meta.<name>}} (for example {{meta.shortDate}} = YYMMDD, {{meta.fileTime}} = HH-mm, in the trigger timezone) and {{event.payload.<field>}} placeholders, resolved once per run so every artifact of that run lands in the same folder. Each substituted value must be a single safe folder name (no "/", "\", "..", control characters); otherwise delivery fails with invalid_delivery_folder. With a placeholder folder, screenshots are delivered directly into the resolved folder; with a static folder they go into a per-run "<flow>-<timestamp>-<id>-screenshots" subfolder.
recording:
type: object
properties:
filename:
type: string
minLength: 1
maxLength: 255
required:
- filename
additionalProperties: false
screenshots:
type: object
properties: {}
additionalProperties: false
required:
- destination
additionalProperties: false
resultDelivery:
allOf:
- $ref: '#/components/schemas/ResultDelivery'
- description: 'Effective routine result delivery: the stored setting, else message for a chat sink, else none.'
createdAt:
type:
- string
- 'null'
format: date-time
updatedAt:
type:
- string
- 'null'
format: date-time
required:
- id
- userId
- ownerId
- agentId
- createdBy
- name
- description
- triggerId
- enabled
- lifecycleStatus
- archivedAt
- deviceIds
- cooldownSeconds
- cooldownScope
- notifyWebhookId
- notifyOnSuccess
- notifyOnFailure
- ownerWake
- lastTriggeredAt
- status
- templateResolutionVersion
- consecutiveFailures
- lastFailureCode
- lastFailureAt
- blockedAt
- healthMonitoringEnabled
- selfHealingEnabled
- selfHealingMaxAttempts
- recordingEnabled
- recordingPolicy
- delivery
- resultDelivery
- createdAt
- updatedAt
ScheduleRule:
type: object
properties:
type:
type: string
enum:
- once
- cron
- recurring
dateTime:
type: string
description: ISO 8601 datetime (for type=once)
expression:
type: string
description: Cron expression (for type=cron)
rrule:
type: string
description: RRULE string (for type=recurring)
jitter:
type: object
description: Optional per-occurrence random window around the nominal schedule time
properties:
beforeMinutes:
type: integer
minimum: 0
maximum: 1440
default: 0
afterMinutes:
type: integer
minimum: 0
maximum: 1440
default: 0
required:
- type
RecordingPolicy:
type: object
properties:
mode:
$ref: '#/components/schemas/RecordingPolicyMode'
required:
- mode
FlowStatus:
type: string
enum:
- healthy
- failing
- blocked
IngestEventBody:
type: object
properties:
eventType:
type: string
minLength: 1
maxLength: 256
deviceId:
type: string
format: uuid
payload:
type: object
additionalProperties: {}
default: {}
required:
- eventType
OwnerWake:
type: string
enum:
- final
- 'off'
default: final
DryRunValidation:
type: object
properties:
valid:
type: boolean
errors:
type: array
items:
type: object
properties:
field:
type: string
message:
type: string
required:
- field
- message
required:
- valid
FlowFailureCode:
type:
- string
- 'null'
enum:
- device_not_found
- device_unavailable
- permission_denied
- client_error
- transient
- logic
- invalid_config
- null
description: Curated flow failure class. device_unavailable blocks immediately for a terminated device or a device confirmed gone; event deviceState="gone" is triggers-defined for a deleted/not-found device.
Trigger:
type: object
properties:
id:
type: string
format: uuid
userId:
type: string
format: uuid
deprecated: true
description: 'Deprecated: use ownerId (tenancy) / createdBy (actor).'
ownerId:
type: string
format: uuid
createdBy:
type:
- string
- 'null'
format: uuid
name:
type: string
description:
type:
- string
- 'null'
activation:
type: string
enum:
- event
- schedule
- custom
scheduleRule:
$ref: '#/components/schemas/ScheduleRule'
timezone:
type:
- string
- 'null'
nextFireTime:
type:
- string
- 'null'
eventType:
type:
- string
- 'null'
conditions: {}
payload:
type:
- object
- 'null'
additionalProperties: {}
customPayloadSchema:
type:
- object
- 'null'
additionalProperties: {}
createdAt:
type:
- string
- 'null'
format: date-time
updatedAt:
type:
- string
- 'null'
format: date-time
required:
- id
- userId
- ownerId
- createdBy
- name
- description
- activation
- scheduleRule
- timezone
- eventType
- payload
- customPayloadSchema
- createdAt
- updatedAt
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)