Mobilerun Actions API

The Actions API from Mobilerun — 4 operation(s) for actions.

GitHub OpenAPI

Operations 7

POST /actions Create an action #
GET /actions List actions #
GET /actions/services List available services #
GET /actions/services/{service}/methods List allowed methods for a service #
GET /actions/{actionId} Get an action #
PATCH /actions/{actionId} Update an action #
DELETE /actions/{actionId} Delete an action #

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