Mobilerun Tools/Misc API
The Tools/Misc API from Mobilerun — 8 operation(s) for tools/misc.
The Tools/Misc API from Mobilerun — 8 operation(s) for tools/misc.
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-misc-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/Misc API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Tools/Misc 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/Misc
paths:
/devices/{deviceId}/clipboard:
get:
description: Returns the current text content of the device's clipboard. Devices without clipboard support return an unsupported-feature error.
operationId: get-clipboard
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ClipboardBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Get device clipboard
tags:
- Tools/Misc
x-mint:
content: 'Reads the device''s primary clipboard as plain text — whatever was last copied on the device or written through the set-clipboard endpoint.
`text` is an empty string when the clipboard is empty or its current content is not text.
On phones, Android only grants clipboard access to the selected input method: the read requires the Mobilerun keyboard to be selected on the device, and answers `409 DEVICE_CLIPBOARD_KEYBOARD_REQUIRED` until it is.
'
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
post:
description: Replaces the device's clipboard content with the text in the request body; an empty text clears the clipboard. Devices without clipboard support return an unsupported-feature error.
operationId: set-clipboard
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetClipboardArgs'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Set device clipboard
tags:
- Tools/Misc
x-mint:
content: 'Replaces the device''s primary clipboard with the given plain text, exactly as if it had been copied on the device — a paste in any app inserts it.
Sending an empty `text` clears the clipboard.
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/fingerprint:
get:
description: Returns a live snapshot of the device's spoofed identity, including model, display, identifiers, and carrier. Devices without fingerprint support return an unsupported-feature error.
operationId: device-fingerprint
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FingerprintResult'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Device fingerprint snapshot
tags:
- Tools/Misc
x-mint:
content: 'The snapshot reflects what apps running on the device observe.
Sections are collected independently and best-effort: values the device cannot report come back empty instead of failing the request — treat empty fields as "unknown", not as an error.
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/kiosk:
delete:
description: Disables Android lock-task (kiosk) mode on the device, releasing it from the locked app.
operationId: disable-kiosk
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Disable kiosk (lock-task) mode
tags:
- Tools/Misc
x-mint:
content: 'The previously locked app keeps running — the device is unpinned, but the app is not stopped.
Android only: iOS devices return an unsupported-feature error.
'
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
put:
description: Locks the device to the package named in the request body using Android lock-task (kiosk) mode, preventing the user from leaving the app.
operationId: enable-kiosk
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnableKioskArgs'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Enable kiosk (lock-task) mode
tags:
- Tools/Misc
x-mint:
content: 'The app must already be running in the foreground — kiosk mode locks the device to the app''s existing task, and the call fails if the package has no task. Launch it first, e.g. with the start-app endpoint.
Locking is applied once and is not restored automatically; re-enable it after a reboot or reset.
<Note>
Android only. iOS devices return an unsupported-feature error.
</Note>
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/language:
get:
description: Returns the device's current language/locale as a BCP-47 locale string.
operationId: get-language
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/LanguageBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Get device language/locale
tags:
- Tools/Misc
x-mint:
content: 'Most devices report a BCP-47 tag like `de-DE`, but some use an underscore separator (`zh_CN` instead of `zh-CN`) — normalize before comparing.
'
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
post:
description: Sets the device language/locale to the BCP-47 locale in the request body. An optional restart flag applies the change immediately by restarting the Android system framework (open apps are closed) instead of waiting for the next reboot; some devices ignore it.
operationId: set-language
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetLanguageArgs'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Set device language/locale
tags:
- Tools/Misc
x-mint:
content: 'Include a region subtag — use `de-DE` rather than `de` — since some devices reject language-only locales. Script subtags may be dropped: `zh-Hans-CN` is applied as `zh-CN`.
If the device cannot apply the requested locale, the call fails with a verification error instead of silently keeping the old language.
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/location:
delete:
description: Clears any simulated GPS location and restores the device's default location behavior. Devices without geo support return an unsupported-feature error.
operationId: reset-location
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Reset the device location to default
tags:
- Tools/Misc
x-mint:
content: 'On cloud devices this re-points the simulated position at the platform default — New York City (`40.7128, -74.0060`) — it does not disable location simulation.
'
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
get:
description: Returns the device's current simulated GPS location as latitude and longitude. Devices without geo support return an unsupported-feature error.
operationId: get-location
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Get device location
tags:
- Tools/Misc
x-mint:
content: 'If the device cannot report a position yet, the call still succeeds and returns latitude and longitude `0` — treat `0,0` as "not available", not as a real coordinate.
'
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
post:
description: Sets the device's simulated GPS location to the latitude and longitude in the request body. Devices without geo support return an unsupported-feature error.
operationId: set-location
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Set device location
tags:
- Tools/Misc
x-mint:
content: 'Coordinates are decimal degrees; negative latitude is south, negative longitude is west. The new position applies to the running device immediately.
This changes the simulated GPS position only — the device''s IP-based geolocation is determined by its proxy.
<Note>
Connecting a proxy with `smartIp: true` overwrites the position to match the proxy''s exit IP.
</Note>
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/overlay:
get:
description: Returns whether the accessibility overlay is currently visible on the device.
operationId: overlay-visible
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OverlayVisibleBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Check if overlay is visible
tags:
- Tools/Misc
x-mint:
content: 'Reports the state of the visual overlay that the device''s automation service can draw over the screen.
<Note>
Not every device draws an overlay. Devices without one always report `visible: false`.
</Note>
'
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
post:
description: Shows or hides the accessibility overlay on the device based on the visibility flag in the request body.
operationId: set-overlay-visible
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetOverlayVisibleArgs'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Set overlay visibility
tags:
- Tools/Misc
x-mint:
content: 'While visible, the overlay is part of the screen output: screenshots include it unless you pass `hideOverlay=true` to the screenshot endpoint.
<Note>
Devices that don''t draw an overlay fail this call and always report `visible: false` on the read side.
</Note>
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/time:
get:
description: Returns the device's current wall-clock time as an RFC 3339 timestamp.
operationId: device-time
responses:
'200':
content:
application/json:
schema:
type: string
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Device time
tags:
- Tools/Misc
x-mint:
content: 'The timestamp is read live from the device''s own clock, not from the API server.
<Tip>
Don''t infer the device''s timezone from the timestamp''s UTC offset — it isn''t guaranteed to match the device''s setting. Use the get-timezone endpoint for that.
</Tip>
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/devices/{deviceId}/timezone:
get:
description: Returns the device's current timezone identifier. Devices that do not support timezone control return an unsupported-feature error.
operationId: get-timezone
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/TimeZoneBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Get device timezone
tags:
- Tools/Misc
x-mint:
content: 'The identifier is an IANA timezone name, e.g. `Europe/Berlin`.
`timezone` is `null` when the device doesn''t report one — for example when no timezone has been set yet.
'
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
post:
description: Sets the device timezone to the identifier in the request body. Devices that do not support timezone control return an unsupported-feature error.
operationId: set-timezone
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetTimeZoneArgs'
required: true
responses:
'204':
description: No Content
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Set device timezone
tags:
- Tools/Misc
x-mint:
content: 'Provide an IANA timezone identifier, e.g. `Europe/Berlin` or `America/New_York`.
The change applies immediately; no reboot is needed.
'
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
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
FingerprintModel:
additionalProperties: false
properties:
aospVersion:
type: string
brand:
type: string
device:
type: string
hardware:
type: string
manufacturer:
type: string
model:
type: string
type: object
EnableKioskArgs:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/EnableKioskArgs.json
format: uri
readOnly: true
type: string
packageName:
description: Package to lock the device to (Android lock-task mode).
minLength: 1
type: string
required:
- packageName
type: object
FingerprintResult:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/FingerprintResult.json
format: uri
readOnly: true
type: string
carrier:
$ref: '#/components/schemas/DeviceCarrier'
display:
$ref: '#/components/schemas/FingerprintDisplay'
identifiers:
$ref: '#/components/schemas/DeviceIdentifiers'
model:
$ref: '#/components/schemas/FingerprintModel'
required:
- model
- display
- identifiers
- carrier
type: object
TimeZoneBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/TimeZoneBody.json
format: uri
readOnly: true
type: string
timezone:
type:
- string
- 'null'
required:
- timezone
type: object
SetTimeZoneArgs:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/SetTimeZoneArgs.json
format: uri
readOnly: true
type: string
timezone:
type: string
required:
- timezone
type: object
OverlayVisibleBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/OverlayVisibleBody.json
format: uri
readOnly: true
type: string
visible:
type: boolean
required:
- visible
type: object
SetLanguageArgs:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/SetLanguageArgs.json
format: uri
readOnly: true
type: string
locale:
description: 'BCP-47 locale: a 2–3 letter language tag, optionally followed by a 4-letter script and/or a 2-letter region (e.g. en-US, de-DE, ja-JP, zh-Hans-CN).'
pattern: ^[a-z]{2,3}(-[A-Z][a-z]{3})?(-[A-Z]{2})?$
type: string
restart:
description: Restart the Android system framework so the locale change takes full effect immediately; open apps are closed. Without it, the change may not fully apply until the next reboot. Some devices ignore this flag.
type: boolean
required:
- locale
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
SetClipboardArgs:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/SetClipboardArgs.json
format: uri
readOnly: true
type: string
text:
type: string
required:
- text
type: object
ClipboardBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/ClipboardBody.json
format: uri
readOnly: true
type: string
text:
type: string
required:
- text
type: object
DeviceIdentifiers:
additionalProperties: false
properties:
BootloaderSerialNumber:
type: string
IdentifierAndroidID:
type: string
IdentifierAppSetID:
type: string
IdentifierBluetoothMAC:
type: string
IdentifierGAID:
type: string
IdentifierGSFID:
type: string
IdentifierICCID:
type: string
IdentifierIMEI:
type: string
IdentifierIMSI:
type: string
IdentifierMEID:
type: string
IdentifierMediaDRMID:
type: string
IdentifierPhoneNumber:
type: string
IdentifierSerial:
type: string
IdentifierWifiMAC:
type: string
SerialNumber:
type: string
required:
- IdentifierSerial
- IdentifierAndroidID
- IdentifierIMEI
- IdentifierMEID
- IdentifierIMSI
- IdentifierICCID
- IdentifierPhoneNumber
- IdentifierGAID
- IdentifierGSFID
- IdentifierAppSetID
- IdentifierMediaDRMID
- IdentifierWifiMAC
- IdentifierBluetoothMAC
- SerialNumber
- BootloaderSerialNumber
type: object
FingerprintDisplay:
additionalProperties: false
properties:
densityDpi:
format: int64
type: integer
height:
format: int64
type: integer
width:
format: int64
type: integer
type: object
DeviceCarrier:
additionalProperties: false
properties:
GsmOperatorAlpha:
type: string
GsmOperatorNumeric:
format: int64
type: integer
GsmSimOperatorAlpha:
type: string
GsmSimOperatorIsoCountry:
type: string
GsmSimOperatorNumeric:
format: int64
type: integer
PersistSysTimezone:
type: string
required:
- GsmOperatorAlpha
- GsmOperatorNumeric
- GsmSimOperatorAlpha
- GsmSimOperatorNumeric
- GsmSimOperatorIsoCountry
- PersistSysTimezone
type: object
Location:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/Location.json
format: uri
readOnly: true
type: string
latitude:
format: double
type: number
longitude:
format: double
type: number
required:
- latitude
- longitude
type: object
SetOverlayVisibleArgs:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/SetOverlayVisibleArgs.json
format: uri
readOnly: true
type: string
visible:
type: boolean
required:
- visible
type: object
LanguageBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/schemas/LanguageBody.json
format: uri
readOnly: true
type: string
locale:
type: string
required:
- locale
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)