Mobilerun Tools/Screenshots API

The Tools/Screenshots API from Mobilerun — 3 operation(s) for tools/screenshots.

GitHub OpenAPI

Operations 4

GET /devices/{deviceId}/screenshots List device screenshots #
POST /devices/{deviceId}/screenshots Capture a device screenshot #
DELETE /devices/{deviceId}/screenshots/{screenshotId} Delete a device screenshot #
GET /devices/{deviceId}/screenshots/{screenshotId}/image Get a device screenshot image #

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-screenshots-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-screenshots-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mobilerun Ai Tools/Screenshots API
  version: v1
  contact:
    name: Droidrun
    email: support@droidrun.ai
  description: 'Operations tagged Tools/Screenshots 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/Screenshots
paths:
  /devices/{deviceId}/screenshots:
    get:
      description: Saved screenshots, newest first. Pass nextCursor as cursor to retrieve the next page.
      operationId: list-device-screenshots
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceScreenshotList'
          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 screenshots
      tags:
      - Tools/Screenshots
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - explode: false
        in: query
        name: cursor
        schema:
          maxLength: 256
          type: string
      - explode: false
        in: query
        name: limit
        schema:
          default: 50
          format: int64
          maximum: 200
          minimum: 1
          type: integer
    post:
      description: Captures the device screen and returns it as a PNG image. Pass save=true to store it as device media.
      operationId: capture-device-screenshot
      responses:
        '200':
          content:
            application/json:
              schema:
                contentEncoding: base64
                type: string
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Screenshot-Id:
              schema:
                description: ID of the saved screenshot; omitted when nothing was saved.
                type: string
            X-Screenshot-Saved:
              schema:
                description: 'Set when save=true: "true" if the screenshot was stored, otherwise "false".'
                type: string
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Capture a device screenshot
      tags:
      - Tools/Screenshots
      x-mint:
        content: 'The response body is the PNG image itself (`Content-Type: image/png`), not a JSON wrapper.


          The accessibility overlay is the on-screen element-highlight layer controlled by the set overlay visibility endpoint. If you''ve enabled it, pass `hideOverlay=true` to capture a clean frame; on devices whose capture path sits below the overlay, the flag has no effect either way.


          Pass `save=true` to also store the captured PNG as device media. If the device has an active recording owned by the device owner, the screenshot is saved into that recording and inherits its retention. Otherwise it is saved standalone for seven days. Without `save=true`, no screenshot is stored.


          `X-Screenshot-Id` contains the saved screenshot ID only when persistence succeeds. The PNG response is unchanged; `X-Screenshot-Saved` is `true` when both the object and its metadata were stored, and `false` if storage limits or a save failure prevented persistence. A failed save does not fail screenshot capture. The device screenshots endpoints list saved screenshots, open their images, and delete individual screenshots. Recording screenshots remain available through the existing list recording screenshots endpoint and are also deleted with the recording.

          '
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: header
        name: X-Device-Display-ID
        schema:
          default: 0
          format: int64
          minimum: 0
          type: integer
      - explode: false
        in: query
        name: hideOverlay
        schema:
          default: false
          type: boolean
      - description: 'Store the screenshot as device media: in the owner''s active recording, or standalone for 7 days. Without save=true nothing is stored. The PNG response is unchanged; X-Screenshot-Saved reports whether it was stored.'
        explode: false
        in: query
        name: save
        schema:
          default: false
          description: 'Store the screenshot as device media: in the owner''s active recording, or standalone for 7 days. Without save=true nothing is stored. The PNG response is unchanged; X-Screenshot-Saved reports whether it was stored.'
          type: boolean
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/screenshots/{screenshotId}:
    delete:
      operationId: delete-device-screenshot
      responses:
        '204':
          description: No Content
        '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: Delete a device screenshot
      tags:
      - Tools/Screenshots
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: screenshotId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/screenshots/{screenshotId}/image:
    get:
      description: Redirects to a presigned PNG URL valid for 15 minutes.
      operationId: get-device-screenshot-image
      responses:
        '302':
          description: Found
          headers:
            Location:
              schema:
                type: string
        '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: Get a device screenshot image
      tags:
      - Tools/Screenshots
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: path
        name: screenshotId
        required: true
        schema:
          type: string
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
components:
  schemas:
    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
    DeviceScreenshot:
      additionalProperties: false
      properties:
        capturedAt:
          format: date-time
          type: string
        deviceId:
          type: string
        expiresAt:
          format: date-time
          type: string
        id:
          type: string
        recordingId:
          type:
          - string
          - 'null'
        sizeBytes:
          format: int64
          type: integer
      required:
      - id
      - deviceId
      - recordingId
      - sizeBytes
      - capturedAt
      - expiresAt
      type: object
    DeviceScreenshotList:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/DeviceScreenshotList.json
          format: uri
          readOnly: true
          type: string
        items:
          items:
            $ref: '#/components/schemas/DeviceScreenshot'
          type:
          - array
          - 'null'
        nextCursor:
          type: string
      required:
      - items
      - nextCursor
      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
  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)