Mobilerun Events API

The Events API from Mobilerun — 2 operation(s) for events.

GitHub OpenAPI

Operations 2

POST /events/dry-run Simulate event matching (dry run) #
POST /events/ingest Ingest an event #

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-events-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-events-api-openapi.yml Raw ↑
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)