Mobilerun Triggers API

The Triggers API from Mobilerun — 3 operation(s) for triggers.

GitHub OpenAPI

Operations 6

POST /triggers Create a trigger #
GET /triggers List triggers #
GET /triggers/{triggerId} Get a trigger #
PATCH /triggers/{triggerId} Update a trigger #
DELETE /triggers/{triggerId} Delete a trigger #
POST /triggers/{triggerId}/fire Fire a custom trigger with payload #

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-triggers-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-triggers-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mobilerun Ai Triggers API
  version: v1
  contact:
    name: Droidrun
    email: support@droidrun.ai
  description: 'Operations tagged Triggers 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: Triggers
  x-group: Workflows
paths:
  /triggers:
    post:
      tags:
      - Triggers
      summary: Create a trigger
      operationId: createTrigger
      description: 'Create a trigger with an activation type of `event`, `schedule`, or `custom`. Each type requires its own fields (e.g. `eventType` and optional `conditions` for events, `scheduleRule` and `timezone` for schedules, `customPayloadSchema` for custom or schedule triggers); mismatched fields are rejected. Schedule triggers may store an optional JSON object `payload` (at most 1 MiB); it requires `customPayloadSchema`, is validated against it (422 on mismatch), and is available as `event.payload` on every scheduled, manual, or verification run. When a schema is configured, omitted payload values are validated as an empty object.


        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/CreateTriggerBody'
      responses:
        '201':
          description: Trigger created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Trigger'
                required:
                - data
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - 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
    get:
      tags:
      - Triggers
      summary: List triggers
      operationId: listTriggers
      description: Return a paginated list of triggers. Supports filtering by `activation` and `eventType`, free-text `search`, and ordering by name, createdAt, or updatedAt.
      responses:
        '200':
          description: List triggers
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Trigger'
                  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
          enum:
          - event
          - schedule
          - custom
        required: false
        name: activation
        in: query
      - schema:
          type: string
        required: false
        name: eventType
        in: query
      - schema:
          type: string
          minLength: 1
          maxLength: 256
        required: false
        name: search
        in: query
      - schema:
          type: string
          enum:
          - name
          - createdAt
          - updatedAt
          default: createdAt
        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
  /triggers/{triggerId}:
    get:
      tags:
      - Triggers
      summary: Get a trigger
      operationId: getTrigger
      description: Fetch a single trigger by its ID, including its activation type and type-specific configuration. Returns 404 if no trigger matches.
      responses:
        '200':
          description: Trigger details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Trigger'
                required:
                - data
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: triggerId
        in: path
    patch:
      tags:
      - Triggers
      summary: Update a trigger
      operationId: updateTrigger
      description: Partially update a trigger; all fields are optional. When `activation` is changed, the type-specific field rules are re-validated. Schedule triggers accept stored `payload` values (at most 1 MiB); null clears them. The resulting payload must match customPayloadSchema (422 on mismatch, including schema changes that invalidate stored values). Absent or null values are validated as an empty object when a schema is configured. Changes apply from the next run. Returns 404 if the trigger does not exist.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTriggerBody'
      responses:
        '200':
          description: Trigger updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Trigger'
                required:
                - data
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: triggerId
        in: path
    delete:
      tags:
      - Triggers
      summary: Delete a trigger
      operationId: deleteTrigger
      description: Delete a trigger by its ID. Returns 404 if no trigger matches.
      responses:
        '200':
          description: Trigger deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                - message
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: triggerId
        in: path
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /triggers/{triggerId}/fire:
    post:
      tags:
      - Triggers
      summary: Fire a custom trigger with payload
      operationId: fireCustomTrigger
      description: 'Invoke a custom trigger directly with an arbitrary JSON payload.


        Fan-out: a trigger may be referenced by multiple flows (workflows). Firing it enqueues one execution per enabled, non-deleted flow attached to this trigger, each receiving the same payload. The `enqueuedCount` in the response reports how many were enqueued (0 if no flows are attached, or if all matching flows are gated by a cooldown).


        Payload validation:

        - If the trigger has a `customPayloadSchema`, the payload is validated against it (JSON Schema).

        - If no schema is configured, the payload only needs to be a JSON object — any keys and values are accepted.


        Only triggers with `activation = "custom"` can be fired through this endpoint; event and schedule triggers return 409.


        Supports an optional `Idempotency-Key` header (1-255 printable ASCII characters), which maps to the derived `invocationId` used for fan-out deduplication. The payload is bound to the key on the first accepted fire, before fan-out. A repeat with the same key and an identical payload returns 202 with `Idempotent-Replayed: true` (`deduplicated: true` when flows were skipped; `enqueuedCount` counts only executions enqueued by that call); a changed payload under the same key returns 422 `idempotency_key_reused`.'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FireCustomTriggerBody'
      responses:
        '202':
          description: Custom trigger fired; one execution enqueued per enabled flow attached to this trigger
          content:
            application/json:
              schema:
                type: object
                properties:
                  invocationId:
                    type: string
                    format: uuid
                    description: Unique ID for this fire invocation (derived from the `Idempotency-Key` header when one is sent, otherwise generated).
                  enqueuedCount:
                    type: integer
                    minimum: 0
                    description: Number of flow executions enqueued. May be 0 if no flows are attached to this trigger, if all attached flows are currently in cooldown, or if every attached flow was deduplicated.
                  deduplicated:
                    type: boolean
                    description: True when at least one attached flow was skipped because it already had an execution for this (flow, invocationId). Only ever true when the request carried an `Idempotency-Key`.
                required:
                - invocationId
                - enqueuedCount
                - deduplicated
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '409':
          description: Trigger exists but is not of type "custom"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerNotFireableError'
        '422':
          description: Payload validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayloadValidationError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: triggerId
        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
components:
  schemas:
    CreateTriggerBody:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 256
        description:
          type: string
          maxLength: 2048
        activation:
          type: string
          enum:
          - event
          - schedule
          - custom
        eventType:
          type: string
          maxLength: 256
        conditions:
          type: object
          properties:
            all:
              type: array
              items:
                type: object
            any:
              type: array
              items:
                type: object
        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
        timezone:
          type: string
        customPayloadSchema:
          $ref: '#/components/schemas/CustomPayloadSchema'
        payload:
          type: object
          additionalProperties: {}
          description: Stored input values for schedule triggers (maximum 1 MiB of JSON). Requires customPayloadSchema; available as event.payload on every run.
      required:
      - name
      - activation
    UpdateTriggerBody:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 256
        description:
          type: string
          maxLength: 2048
        activation:
          type: string
          enum:
          - event
          - schedule
          - custom
        eventType:
          type: string
          maxLength: 256
        conditions:
          type:
          - object
          - 'null'
          properties:
            all:
              type: array
              items:
                type: object
            any:
              type: array
              items:
                type: object
        scheduleRule:
          type:
          - object
          - 'null'
          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
        timezone:
          type:
          - string
          - 'null'
        payload:
          type:
          - object
          - 'null'
          additionalProperties: {}
          description: Stored schedule input values (maximum 1 MiB of JSON); null clears them. Requires customPayloadSchema.
        customPayloadSchema:
          type:
          - object
          - 'null'
          description: Optional JSON Schema for validating payloads for custom or schedule triggers
          additionalProperties: true
    ApiErrorEnvelope:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        details: {}
        traceId:
          type: string
        retryAfterSeconds:
          type: number
      required:
      - code
      - message
    CustomPayloadSchema:
      type: object
      description: Optional JSON Schema for validating payloads for custom or schedule triggers
      additionalProperties: true
    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
    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
    TriggerNotFireableError:
      type: object
      properties:
        code:
          type: string
          enum:
          - trigger_not_fireable
        message:
          type: string
        details:
          type: object
          properties:
            activation:
              type: string
          required:
          - activation
      required:
      - code
      - message
      - details
    PayloadValidationError:
      type: object
      properties:
        code:
          type: string
          enum:
          - validation_error
        message:
          type: string
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
            required:
            - field
            - message
      required:
      - code
      - message
      - details
    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
    FireCustomTriggerBody:
      type: object
      properties:
        payload:
          type: object
          description: Arbitrary JSON object forwarded to every flow attached to this trigger. Validated against the trigger's customPayloadSchema when one is configured; otherwise only "must be a JSON object" is enforced.
          additionalProperties: true
      required:
      - payload
  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)