Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Bearer token via Authorization header

Query Parameters

deviceType
enum<string>
Available options:
dedicated_physical_device,
dedicated_premium_device,
dedicated_ios_device,
dedicated_emulated_device,
ios_simulator
country
string

ISO 3166-1 alpha-2 country code. If omitted the system picks the country with the most availability.

profileId
string

Profile ID to use as device spec

billing
enum<string>
default:auto

Billing mode. 'auto' uses a subscription slot when available and otherwise bills per minute; 'subscription' requires an available subscription slot; 'minute' bills per minute. Only cloud phone and cloud emulator devices support per-minute billing.

Available options:
auto,
subscription,
minute

Body

application/json
androidVersion
integer<int64>
apps
string[] | null
carrier
object
country
string
files
string[] | null
identifiers
object
locale
string
location
object
name
string
proxy
object
timezone
string

Response

OK

activeTaskId
string
required
assignedAt
string<date-time> | null
required
createdAt
string<date-time>
required
id
string
required
name
string
required
state
string
required
stateMessage
string
required
streamUrl
string
required
taskCount
integer<int64>
required
terminatesAt
string<date-time> | null
required
type
string
required
updatedAt
string<date-time>
required
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DeviceInfo.json"

billingStrategy
string
createdBy
string
ownerId
string
providerId
string
streamToken
string
userId
string
deprecated

Deprecated: use ownerId/createdBy.