---
title: "Generate Appium connection URL"
method: POST
path: "/boxes/{boxId}/android/connect-url/appium"
tags: ["Android"]
---

# Generate Appium connection URL

`POST /boxes/{boxId}/android/connect-url/appium`

Generate a pre-signed proxy URL for Appium server of a running Android box.

## Path parameters

- `boxId` string, required

## Request body

- GenerateAppiumUrl — Generate Appium connection url
  - `expiresIn` string — The Appium connection url will be alive for the given duration Supported time units: ms (milliseconds), s (seconds), m (minutes), h (hours) Example formats: "500ms", "30s", "5m", "1h" Default: 120m

## Response `200`

Appium connection information

- AppiumConnectInfo — Appium connection information
  - `url` string, required — Appium connection URL
  - `udid` string, required — Device UDID for Appium connection
  - `defaultOption` AppiumDefaultOption, required — Ready-to-use WebdriverIO remote options
    - `protocol` string, required — Protocol (http or https)
    - `hostname` string, required — Hostname
    - `port` number, required — Port number
    - `path` string, required — URL pathname
    - `capabilities` AppiumCapabilities, required — Appium capabilities for WebdriverIO
      - `platformName` string, required — Platform name
      - `appium:automationName` string, required — Appium automation name
      - `appium:udid` string, required — Device UDID
      - `appium:deviceName` string, required — Device name
  - `logLevel` 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent', required — Log level for WebdriverIO/Appium client

## Changes

- **2025-10-17** `f72fd6283093` — 1 info
  - added the required property `logLevel` to the response with the `200` status
- **2025-10-15** `8c2ae564f6df` — 1 breaking, 1 info
  - the `defaultOption` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - added `#/components/schemas/AppiumDefaultOption` to the `defaultOption` response property `allOf` list for the response status `200`
- **2025-10-14** `c00f53db8cf5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/babelcloud/apis/gbox-open-api/changes/boxes/:boxId/android/connect-url/appium/post.md)

---

[API](https://skmtc.dev/babelcloud/apis/gbox-open-api.md) · [All operations](https://skmtc.dev/babelcloud/apis/gbox-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/babelcloud/gbox-open-api/revisions/d655577fa915/schema)