---
title: "Connect proxy"
method: POST
path: "/devices/{deviceId}/proxy"
tags: ["Tools/Proxy"]
---

# Connect proxy

`POST /devices/{deviceId}/proxy`

Routes the device's traffic through a SOCKS5 proxy supplied in the request body, replacing any existing connection. A smartIp option can be used to select an IP automatically; the legacy flat host/port/user/password fields remain supported.

## Path parameters

- `deviceId` string, required

## Headers

- `X-Device-Display-ID` integer

## Request body

- ConnectProxyBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `connect` Ref
    - `country` string — ISO 3166-1 alpha-2 country code; provisions (or reuses) a rotating residential Mobilerun Connect proxy for the device.
    - `id` string, uuid — Existing Mobilerun Connect proxy id; its credentials are fetched server-side.
  - `host` string, hostname
  - `name` string — Proxy name
  - `password` string
  - `port` integer
  - `smartIp` boolean
  - `socks5` ConnectSOCKS5Config
    - `host` string, hostname, required
    - `password` string
    - `port` integer, required
    - `user` string
  - `user` string

## Response `204`

No Content

## Other responses

- `default` — Error

## Changes

- **2026-08-01** `cd80ab1b29b0` — 1 info
  - endpoint added
- **2026-08-01** `3183ec3153d1` — 1 breaking
  - api path removed without deprecation
- **2026-07-24** `618bd1cc1aed` — 1 info
  - added the new optional request property `connect`
- **2026-07-07** `d5d1e5ee8188` — 2 info
  - api tag `Tools/Proxy` added
  - api tag `Tools` removed
- **2026-06-29** `3cb3612f45e0` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/devices/:deviceId/proxy/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/fc388ab21a20/schema)