Mobilerun Triggers API
The Triggers API from Mobilerun — 3 operation(s) for triggers.
The Triggers API from Mobilerun — 3 operation(s) for triggers.
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-triggers-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 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)