Mobilerun Proxies API
The Proxies API from Mobilerun — 2 operation(s) for proxies.
The Proxies API from Mobilerun — 2 operation(s) for proxies.
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-proxies-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 Proxies API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Proxies 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: Proxies
x-group: BYO Proxy
paths:
/proxies:
get:
summary: List proxy configs
description: Returns all proxy configs for the authenticated user. An optional `protocol` query parameter (`socks5` or `wireguard`) filters the results by proxy type.
operationId: listProxies
tags:
- Proxies
responses:
'200':
description: Proxies retrieved successfully
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ProxyConfig'
required:
- data
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
parameters:
- schema:
type: string
enum:
- socks5
- wireguard
required: false
name: protocol
in: query
post:
summary: Create a proxy config
description: 'Creates a proxy config. The body is a discriminated union on `protocol`: `socks5` requires name, host, port, user, and password, while `wireguard` requires name and a config string. Returns the created config with its generated `proxyId`.'
operationId: createProxy
tags:
- Proxies
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateProxyBody'
responses:
'200':
description: Proxy created
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
message:
type: string
data:
$ref: '#/components/schemas/ProxyConfig'
required:
- success
- message
- data
'400':
description: Bad Request — invalid_request, package_exists, create_failed, update_failed, protocol_change_not_allowed (legacy body + additive code/message), or a generic request validation failure
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/CredentialErrorResponse'
- $ref: '#/components/schemas/ApiErrorEnvelope'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/proxies/{proxyId}:
get:
summary: Get a proxy config
description: Fetches a single proxy config by its `proxyId`. The response shape depends on the proxy's `protocol` (socks5 or wireguard). Returns not found if no matching config exists.
operationId: getProxy
tags:
- Proxies
responses:
'200':
description: Proxy fetched successfully
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ProxyConfig'
required:
- data
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'404':
description: Not Found — credential_not_found, proxy_not_found (legacy body + additive code/message)
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
parameters:
- schema:
type: string
format: uuid
required: true
name: proxyId
in: path
put:
summary: Update a proxy config
description: Replaces the proxy config identified by `proxyId` with the provided body. As with creation, the body is a `protocol`-discriminated union of socks5 or wireguard fields. Returns the updated config.
operationId: updateProxy
tags:
- Proxies
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProxyBody'
responses:
'200':
description: Proxy updated
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
message:
type: string
data:
$ref: '#/components/schemas/ProxyConfig'
required:
- success
- message
- data
'400':
description: Bad Request — invalid_request, package_exists, create_failed, update_failed, protocol_change_not_allowed (legacy body + additive code/message), or a generic request validation failure
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/CredentialErrorResponse'
- $ref: '#/components/schemas/ApiErrorEnvelope'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'404':
description: Not Found — credential_not_found, proxy_not_found (legacy body + additive code/message)
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
parameters:
- schema:
type: string
format: uuid
required: true
name: proxyId
in: path
delete:
summary: Delete a proxy config
description: Permanently deletes the proxy config identified by `proxyId` and returns the deleted config. Returns not found if no matching config exists.
operationId: deleteProxy
tags:
- Proxies
responses:
'200':
description: Proxy deleted successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
message:
type: string
data:
$ref: '#/components/schemas/ProxyConfig'
required:
- success
- message
- data
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'404':
description: Not Found — credential_not_found, proxy_not_found (legacy body + additive code/message)
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
parameters:
- schema:
type: string
format: uuid
required: true
name: proxyId
in: path
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
UpdateWireguardProxy:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- wireguard
config:
type: string
minLength: 1
maxLength: 10000
required:
- name
- protocol
- config
CredentialErrorCode:
type: string
enum:
- credential_read_only
- credential_source_unavailable
- credential_source_rate_limited
- onepassword_not_connected
- onepassword_token_invalid
- onepassword_no_vaults
- onepassword_reference_invalid
- invalid_request
- package_exists
- credential_not_found
- proxy_not_found
- create_failed
- update_failed
- protocol_change_not_allowed
ApiErrorEnvelope:
type: object
properties:
code:
type: string
message:
type: string
details: {}
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
InternalServerError:
type: object
properties:
code:
type: string
message:
type: string
traceId:
type: string
required:
- code
- message
ProxyConfig:
oneOf:
- $ref: '#/components/schemas/Socks5ProxyConfig'
- $ref: '#/components/schemas/WireguardProxyConfig'
discriminator:
propertyName: protocol
mapping:
socks5: '#/components/schemas/Socks5ProxyConfig'
wireguard: '#/components/schemas/WireguardProxyConfig'
UpdateProxyBody:
oneOf:
- $ref: '#/components/schemas/UpdateSocks5Proxy'
- $ref: '#/components/schemas/UpdateWireguardProxy'
discriminator:
propertyName: protocol
mapping:
socks5: '#/components/schemas/UpdateSocks5Proxy'
wireguard: '#/components/schemas/UpdateWireguardProxy'
CreateSocks5Proxy:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- socks5
host:
type: string
minLength: 1
port:
type: integer
minimum: 1
maximum: 65535
user:
type: string
minLength: 1
password:
type: string
minLength: 1
required:
- name
- protocol
- host
- port
- user
- password
Socks5ProxyConfig:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- socks5
host:
type: string
minLength: 1
port:
type: integer
minimum: 1
maximum: 65535
user:
type: string
minLength: 1
password:
type: string
minLength: 1
proxyId:
type: string
format: uuid
required:
- name
- protocol
- host
- port
- user
- password
- proxyId
CredentialErrorResponse:
type: object
properties:
code:
$ref: '#/components/schemas/CredentialErrorCode'
message:
type: string
required:
- code
- message
CreateProxyBody:
oneOf:
- $ref: '#/components/schemas/CreateSocks5Proxy'
- $ref: '#/components/schemas/CreateWireguardProxy'
discriminator:
propertyName: protocol
mapping:
socks5: '#/components/schemas/CreateSocks5Proxy'
wireguard: '#/components/schemas/CreateWireguardProxy'
UpdateSocks5Proxy:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- socks5
host:
type: string
minLength: 1
port:
type: integer
minimum: 1
maximum: 65535
user:
type: string
minLength: 1
password:
type: string
minLength: 1
required:
- name
- protocol
- host
- port
- user
- password
WireguardProxyConfig:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- wireguard
config:
type: string
minLength: 1
maxLength: 10000
proxyId:
type: string
format: uuid
required:
- name
- protocol
- config
- proxyId
CreateWireguardProxy:
type: object
properties:
name:
type: string
minLength: 3
maxLength: 50
protocol:
type: string
enum:
- wireguard
config:
type: string
minLength: 1
maxLength: 10000
required:
- name
- protocol
- config
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)