> ## Documentation Index > Fetch the complete documentation index at: https://docs.mobilerun.ai/llms.txt > Use this file to discover all available pages before exploring further. # Provision a new device > Requests a new device for the authenticated user from the device spec in the request body. Optional query parameters select the device type, target country, billing mode, and a profile to use as the base spec; the response returns the device and its stream token. ## OpenAPI ````yaml /api-reference/phones.yaml post /devices openapi: 3.1.0 info: title: Phones version: v1 servers: - url: https://api.mobilerun.ai description: Droidrun Cloud API security: - bearerAuth: [] paths: /devices: post: tags: - Devices summary: Provision a new device description: >- Requests a new device for the authenticated user from the device spec in the request body. Optional query parameters select the device type, target country, billing mode, and a profile to use as the base spec; the response returns the device and its stream token. operationId: create-device parameters: - explode: false in: query name: deviceType schema: enum: - dedicated_physical_device - dedicated_premium_device - dedicated_ios_device - dedicated_emulated_device - ios_simulator type: string - description: >- ISO 3166-1 alpha-2 country code. If omitted the system picks the country with the most availability. explode: false in: query name: country schema: description: >- ISO 3166-1 alpha-2 country code. If omitted the system picks the country with the most availability. type: string - description: Profile ID to use as device spec explode: false in: query name: profileId schema: description: Profile ID to use as device spec type: string - description: >- 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. explode: false in: query name: billing schema: default: auto description: >- 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. enum: - auto - subscription - minute type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/DeviceSpec' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/DeviceInfo' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Error security: - bearerAuth: [] x-codeSamples: - lang: JavaScript source: |- import Mobilerun from '@mobilerun/sdk'; const client = new Mobilerun({ apiKey: process.env['MOBILERUN_CLOUD_API_KEY'], // This is the default and can be omitted }); const device = await client.devices.create(); console.log(device.id); - lang: Python source: |- import os from mobilerun_sdk import Mobilerun client = Mobilerun( api_key=os.environ.get("MOBILERUN_CLOUD_API_KEY"), # This is the default and can be omitted ) device = client.devices.create() print(device.id) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/stainless-sdks/droidrun-cloud-go\"\n\t\"github.com/stainless-sdks/droidrun-cloud-go/option\"\n\t\"github.com/stainless-sdks/droidrun-cloud-go/shared\"\n)\n\nfunc main() {\n\tclient := mobileruncloud.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tdevice, err := client.Devices.New(context.TODO(), mobileruncloud.DeviceNewParams{\n\t\tDeviceSpec: shared.DeviceSpecParam{},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", device.ID)\n}\n" - lang: CLI source: |- mobilerun-cloud devices create \ --api-key 'My API Key' components: schemas: DeviceSpec: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/DeviceSpec.json format: uri readOnly: true type: string androidVersion: format: int64 type: integer apps: items: type: string type: - array - 'null' carrier: $ref: '#/components/schemas/DeviceCarrier' country: type: string files: items: type: string type: - array - 'null' identifiers: $ref: '#/components/schemas/DeviceIdentifiers' locale: type: string location: $ref: '#/components/schemas/Location' name: type: string proxy: $ref: '#/components/schemas/ProxyConfig1' timezone: type: string type: object DeviceInfo: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/DeviceInfo.json format: uri readOnly: true type: string activeTaskId: type: string assignedAt: format: date-time type: - string - 'null' billingStrategy: type: string createdAt: format: date-time type: string createdBy: type: string id: type: string name: type: string ownerId: type: string providerId: type: string state: type: string stateMessage: type: string streamToken: type: string streamUrl: type: string taskCount: format: int64 type: integer terminatesAt: format: date-time type: - string - 'null' type: type: string updatedAt: format: date-time type: string userId: deprecated: true description: 'Deprecated: use ownerId/createdBy.' type: string required: - id - name - state - stateMessage - streamUrl - type - createdAt - updatedAt - assignedAt - terminatesAt - taskCount - activeTaskId type: object ErrorModel: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/ErrorModel.json format: uri readOnly: true type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object DeviceCarrier: additionalProperties: false properties: GsmOperatorAlpha: type: string GsmOperatorNumeric: format: int64 type: integer GsmSimOperatorAlpha: type: string GsmSimOperatorIsoCountry: type: string GsmSimOperatorNumeric: format: int64 type: integer PersistSysTimezone: type: string required: - GsmOperatorAlpha - GsmOperatorNumeric - GsmSimOperatorAlpha - GsmSimOperatorNumeric - GsmSimOperatorIsoCountry - PersistSysTimezone type: object DeviceIdentifiers: additionalProperties: false properties: BootloaderSerialNumber: type: string IdentifierAndroidID: type: string IdentifierAppSetID: type: string IdentifierBluetoothMAC: type: string IdentifierGAID: type: string IdentifierGSFID: type: string IdentifierICCID: type: string IdentifierIMEI: type: string IdentifierIMSI: type: string IdentifierMEID: type: string IdentifierMediaDRMID: type: string IdentifierPhoneNumber: type: string IdentifierSerial: type: string IdentifierWifiMAC: type: string SerialNumber: type: string required: - IdentifierSerial - IdentifierAndroidID - IdentifierIMEI - IdentifierMEID - IdentifierIMSI - IdentifierICCID - IdentifierPhoneNumber - IdentifierGAID - IdentifierGSFID - IdentifierAppSetID - IdentifierMediaDRMID - IdentifierWifiMAC - IdentifierBluetoothMAC - SerialNumber - BootloaderSerialNumber type: object Location: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/Location.json format: uri readOnly: true type: string latitude: format: double type: number longitude: format: double type: number required: - latitude - longitude type: object ProxyConfig1: additionalProperties: false properties: name: type: string smartIp: type: boolean socks5: $ref: '#/components/schemas/SOCKS5' type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object SOCKS5: additionalProperties: false properties: host: type: string password: type: string port: format: int64 type: integer user: type: string required: - host - port - user - password type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Opaque description: Bearer token via Authorization header ````