---
title: "Connect proxy"
method: POST
path: "/devices/{deviceId}/proxy"
tags: ["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.
  - `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

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)