Mobilerun Tools/Recordings API

The Tools/Recordings API from Mobilerun — 5 operation(s) for tools/recordings.

GitHub OpenAPI

Operations 8

GET /devices/{deviceId}/recordings List device recordings #
POST /devices/{deviceId}/recordings Start a device recording #
DELETE /devices/{deviceId}/recordings/{recordingId} Delete a device recording #
GET /devices/{deviceId}/recordings/{recordingId} Get a device recording #
POST /devices/{deviceId}/recordings/{recordingId} Stop a device recording #
GET /devices/{deviceId}/recordings/{recordingId}/screenshots List a device recording's saved screenshots #
GET /devices/{deviceId}/recordings/{recordingId}/trajectory Get a device recording trajectory #
GET /devices/{deviceId}/recordings/{recordingId}/video Get a device recording video #

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-tools-recordings-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-tools-recordings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mobilerun Ai Tools/Recordings API
  version: v1
  contact:
    name: Droidrun
    email: support@droidrun.ai
  description: 'Operations tagged Tools/Recordings 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: Tools/Recordings
paths:
  /devices/{deviceId}/recordings:
    get:
      operationId: list-device-recordings
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/RecordingInfo'
                type:
                - array
                - 'null'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: List device recordings
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - explode: false
        in: query
        name: type
        schema:
          type: string
      - explode: false
        in: query
        name: status
        schema:
          type: string
    post:
      operationId: start-device-recording
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartInputBody'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordingInfo'
          description: Created
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Start a device recording
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/recordings/{recordingId}:
    delete:
      operationId: delete-device-recording
      responses:
        '204':
          description: No Content
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Delete a device recording
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    get:
      operationId: get-device-recording
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordingInfo'
          description: OK
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Get a device recording
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    post:
      operationId: stop-device-recording
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordingInfo'
          description: OK
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Stop a device recording
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/recordings/{recordingId}/screenshots:
    get:
      description: Screenshots saved into the recording with `GET /devices/{deviceId}/screenshot?save=true`, oldest first, each with a presigned download URL.
      operationId: list-device-recording-screenshots
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Item'
                type:
                - array
                - 'null'
          description: OK
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '410':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Gone
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: List a device recording's saved screenshots
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/recordings/{recordingId}/trajectory:
    get:
      operationId: get-device-recording-trajectory
      responses:
        '200':
          description: OK
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '410':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Gone
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Get a device recording trajectory
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/recordings/{recordingId}/video:
    get:
      operationId: get-device-recording-video
      responses:
        '302':
          description: Found
          headers:
            Location:
              schema:
                type: string
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '410':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Gone
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Get a device recording video
      tags:
      - Tools/Recordings
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: recordingId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
components:
  schemas:
    DisplayInfo:
      additionalProperties: false
      properties:
        height:
          format: int64
          type: integer
        rotation:
          format: int64
          type: integer
        width:
          format: int64
          type: integer
      required:
      - width
      - height
      - rotation
      type: object
    VideoInfo:
      additionalProperties: false
      properties:
        durationMs:
          format: int64
          type: integer
        format:
          type: string
        limitReason:
          type: string
        limited:
          type: boolean
        sizeBytes:
          format: int64
          type: integer
      required:
      - durationMs
      - sizeBytes
      - format
      type: object
    StartInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/StartInputBody.json
          format: uri
          readOnly: true
          type: string
        name:
          pattern: ^[A-Za-z0-9_.-]{1,64}$
          type: string
        quality:
          description: Capture quality from 1 (lowest) to 10 (full stream quality). Defaults to the device's full quality. Honored only by devices that support adjustable capture quality.
          format: int64
          maximum: 10
          minimum: 1
          type: integer
        retentionDays:
          format: int64
          maximum: 90
          minimum: 1
          type: integer
        types:
          description: 'Artifacts to capture: trajectory (input actions; on some devices only when the device announces trajectory capture), video, and audio (captured into the video artifact, so it requires video; honored only by devices that support audio capture). Defaults to trajectory and video, narrowed to what the device produces.'
          items:
            type: string
          type:
          - array
          - 'null'
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    RecordingInfo:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/RecordingInfo.json
          format: uri
          readOnly: true
          type: string
        actions:
          format: int64
          type: integer
        deviceId:
          type: string
        display:
          $ref: '#/components/schemas/DisplayInfo'
        endedAt:
          format: date-time
          type: string
        error:
          type: string
        expiresAt:
          format: date-time
          type: string
        id:
          type: string
        name:
          type: string
        startedAt:
          format: date-time
          type: string
        status:
          type: string
        types:
          items:
            type: string
          type:
          - array
          - 'null'
        video:
          $ref: '#/components/schemas/VideoInfo'
      required:
      - id
      - deviceId
      - name
      - types
      - status
      - startedAt
      - expiresAt
      - display
      - actions
      type: object
    Item:
      additionalProperties: false
      properties:
        capturedAt:
          format: date-time
          type: string
        id:
          type: string
        sizeBytes:
          format: int64
          type: integer
        url:
          description: Presigned download URL, valid for 15 minutes.
          type: string
      required:
      - id
      - capturedAt
      - sizeBytes
      - url
      type: object
  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)