Mobilerun Tools/Screenshots API
The Tools/Screenshots API from Mobilerun — 3 operation(s) for tools/screenshots.
The Tools/Screenshots API from Mobilerun — 3 operation(s) for tools/screenshots.
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-tools-screenshots-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 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)