Mobilerun Actions API
The Actions API from Mobilerun — 4 operation(s) for actions.
The Actions API from Mobilerun — 4 operation(s) for 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-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 Actions API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged 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: Actions
x-group: Workflows
paths:
/actions:
post:
tags:
- Actions
summary: Create an action
operationId: createAction
description: 'Create a reusable action from a catalog entry (`catalogEntryId`), with an optional `params` object supplying the values for that entry''s service method. Returns 400 if the params are invalid for the chosen catalog entry.
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/CreateActionBody'
responses:
'201':
description: Action created
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Action'
required:
- data
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'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:
- Actions
summary: List actions
operationId: listActions
description: Return a paginated list of actions. Supports filtering by `profile=agent_routine`, `service`, free-text `search`, and ordering by name, createdAt, or updatedAt.
responses:
'200':
description: List actions
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Action'
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:
- agent_routine
description: Restrict reads to the agent routine step surface.
required: false
description: Restrict reads to the agent routine step surface.
name: profile
in: query
- schema:
type: string
enum:
- tasks_api
- devices_api
- agents_api
- webhooks
- integrations_api
- triggers_api
required: false
name: service
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
/actions/services:
get:
tags:
- Actions
summary: List available services
operationId: listServices
description: Return the names of the services that actions can be built against. Use these values to look up each service's allowed methods.
responses:
'200':
description: Available services
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: string
required:
- data
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/actions/services/{service}/methods:
get:
tags:
- Actions
summary: List allowed methods for a service
operationId: listServiceMethods
description: Return the methods allowed for the given service, each with its parameter definitions (name, type, whether required, description, and optional default/example). Returns 404 if the service is unknown.
responses:
'200':
description: Allowed methods
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ServiceMethod'
required:
- data
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
minLength: 1
required: true
name: service
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/actions/{actionId}:
get:
tags:
- Actions
summary: Get an action
operationId: getAction
description: Fetch a single action by its ID, including its configured service, method, and params. Supports `profile=agent_routine`; returns 404 if no action matches or the action is outside that profile.
responses:
'200':
description: Action details
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Action'
required:
- data
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
format: uuid
required: true
name: actionId
in: path
- schema:
type: string
enum:
- agent_routine
description: Restrict reads to the agent routine step surface.
required: false
description: Restrict reads to the agent routine step surface.
name: profile
in: query
patch:
tags:
- Actions
summary: Update an action
operationId: updateAction
description: Partially update an action's name, description, or params; all fields are optional. Returns 404 if the action does not exist.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateActionBody'
responses:
'200':
description: Action updated
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Action'
required:
- data
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
parameters:
- schema:
type: string
format: uuid
required: true
name: actionId
in: path
delete:
tags:
- Actions
summary: Delete an action
operationId: deleteAction
description: Delete an action by its ID. Returns 404 if no action matches.
responses:
'200':
description: Action 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: actionId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
ServiceMethod:
type: object
properties:
method:
type: string
params:
type: array
items:
$ref: '#/components/schemas/ParamDef'
required:
- method
- params
ApiErrorEnvelope:
type: object
properties:
code:
type: string
message:
type: string
details: {}
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
ParamDef:
type: object
properties:
name:
type: string
type:
type: string
enum:
- string
- number
- boolean
- object
- array
- any
required:
type: boolean
description:
type: string
default: {}
example: {}
required:
- name
- type
- required
- description
Action:
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
catalogEntryId:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
service:
type: string
enum:
- tasks_api
- devices_api
- agents_api
- webhooks
- integrations_api
- triggers_api
method:
type: string
params: {}
paramsSchema: {}
createdAt:
type:
- string
- 'null'
format: date-time
updatedAt:
type:
- string
- 'null'
format: date-time
required:
- id
- userId
- ownerId
- createdBy
- catalogEntryId
- name
- description
- service
- method
- createdAt
- updatedAt
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
UpdateActionBody:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 256
description:
type: string
maxLength: 2048
params:
type: object
additionalProperties: {}
CreateActionBody:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 256
description:
type: string
maxLength: 2048
catalogEntryId:
type: string
format: uuid
params:
type: object
additionalProperties: {}
required:
- name
- catalogEntryId
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)