List all ADB-connected physical devices (SIM-ready). Requires USB passthrough to be enabled on the host.

Response:

{
  "devices": [
    { "serial": "RF8N90ABCDE", "status": "device", "model": "SM-S918B", "product": "dm3q", "device": "dm3q" }
  ]
}

Connect a device over Wi-Fi ADB (TCP/IP mode). The device must already be on the same network and have ADB over TCP enabled.

Request Body:

{ "ip": "192.168.1.42" }

Response:

{ "result": "connected to 192.168.1.42:5555" }

List all running Android emulator instances (serials beginning with emulator-).

Response:

{
  "emulators": [
    { "serial": "emulator-5554", "status": "device", "model": "sdk_gphone64_x86_64" }
  ]
}

Apply a device hardware profile to a running emulator — sets screen resolution, DPI, and attempts to spoof build props (ro.product.model, ro.product.brand, ro.product.manufacturer). This is how device selection in the No SIM tab takes effect.

Request Body:

{
  "serial": "emulator-5554",
  "w": 1440,
  "h": 3088,
  "dpi": 500,
  "model": "SM-S918B",
  "brand": "samsung",
  "mfr": "samsung"
}

Response:

{ "ok": true, "size": "1440x3088", "dpi": 500 }

Returns a live PNG screenshot of the device or emulator. The frontend polls this every ~800ms to render the interactive screen stream.

Path Parameter: serial — ADB serial (e.g. emulator-5554 or RF8N90ABCDE)

Response: image/png — raw screenshot bytes. Cache-Control: no-cache.

Error:

{ "error": "screenshot failed" }  // 503 if ADB unreachable

Send touch or keyboard input to a device. Supports four actions.

Path Parameter: serial — ADB serial of the target device.

Request Body — tap:

{ "action": "tap", "x": 540, "y": 1200 }

Request Body — swipe:

{ "action": "swipe", "x1": 540, "y1": 1600, "x2": 540, "y2": 400, "duration": 300 }

Request Body — keyevent:

{ "action": "keyevent", "code": 3 }  // 3=HOME  4=BACK  187=RECENTS

Request Body — text:

{ "action": "text", "text": "Hello world" }

Response:

{ "ok": true }

Start a CLI login flow. Returns a short human-readable user_code for the browser and a long device_code used to poll for the resulting token. Codes expire after 10 minutes.

Response:

{
  "device_code": "a7f3k9...",
  "user_code": "ABCD-1234",
  "verification_uri": "https://justandroid.kaywat.codes/cli-auth",
  "expires_in": 600,
  "interval": 5
}

Poll for authorization status. The CLI calls this every 5 seconds after displaying the user code. Returns 202 while pending, 200 once the user approves.

Pending (202):

{ "status": "pending" }

Approved (200):

{ "status": "authorized", "token": "abc123...", "username": "youruser" }

Called by the browser CLI Auth page after the user enters the code and clicks Approve. Marks the device code as authorized and generates an API token.

Request Body:

{ "user_code": "ABCD-1234", "username": "youruser" }

Response:

{ "ok": true }

Revoke the current API key. Requires Authorization: Bearer TOKEN. Deletes the key from the server permanently.

Response:

{ "ok": true }

Returns current account summary: username, masked API key, enabled platforms, and live device/emulator counts.

Response:

{
  "username": "youruser",
  "api_key": "abc123de…",
  "platforms": ["tiktok", "youtube"],
  "emulators_running": 1,
  "devices_connected": 0
}

Retrieve all configured platform settings for the authenticated account.

Response:

{
  "platforms": {
    "tiktok": {
      "enabled": true,
      "account": "@yourhandle",
      "notifications": ["new_videos", "new_followers"],
      "automations": ["auto_like", "auto_follow"],
      "webhook": "https://hooks.example.com/tiktok"
    }
  }
}

Overwrite all platform configs for the account in a single request.

Request Body:

{
  "platforms": {
    "tiktok": { "enabled": true, "account": "@yourhandle" },
    "youtube": { "enabled": false }
  }
}

Response:

{ "ok": true, "platforms": { ... } }

Update a single platform's config. Only the fields you send are changed — other fields are preserved.

Path Parameter: name — lowercase platform identifier (e.g. tiktok, youtube, twitter)

Request Body (any subset):

{
  "enabled": true,
  "account": "@newhandle",
  "notifications": ["new_videos", "new_followers"],
  "automations": ["auto_like"],
  "webhook": "https://hooks.example.com/tiktok"
}

Response:

{ "ok": true, "platform": { "enabled": true, "account": "@newhandle", ... } }

Remove a platform's configuration entirely from the account.

Response:

{ "ok": true }

Returns bridge service status and process ID. No authentication required.

Response:

{ "status": "ok", "pid": 1234 }