# Update Cloud Phone Profile

Update the configuration of one or more Cloud Phones.
- **Preconditions**: the phones must belong to the team. Region, language and coordinate values are validated for each device model, exactly as on create. Moving a phone into a group you are not authorized for is rejected.
- **Effect**: overwrites the phone settings and refreshes the GPS configuration; may create tag bindings. Nothing is charged and concurrency is unaffected.
- **Completion**: synchronous, and idempotent for the same body.

Endpoint: POST /api/cloudphone/edit/batch
Version: 2026-09-05

## Request fields (application/json):

  - `id` (array, required)
    Cloud phone IDs

  - `envName` (string)
    Cloud phone name (≤64 chars)

  - `phoneNumber` (string)
    Customize your phone number. Format requirements:Must begin with a + sign, country code must be 1-3 digits (excluding 86), total length 8-14 digits, and contain only + and numbers.

  - `powerOnBillingStrategy` (integer)
    Non-Monthly cloud phone billing method (0:default, 1:parallel pack only)
    Enum: "0", "1"

  - `proxyId` (string)
    Proxy ID

  - `groupId` (string)
    Environment group ID

  - `groupName` (string)
    Existing group name, or a new group name to create when no matching group exists.

  - `tags` (array)
    Replacement tag names. Blank values are ignored.

  - `envRemark` (string)
    Environment remark (≤1500 chars, line breaks supported)

  - `automaticGeo` (boolean)
    Auto geolocation

  - `automaticLanguage` (boolean)
    Auto language

  - `automaticLocation` (boolean)
    Auto location (timezone & country)

  - `country` (string)
    Country

  - `timezone` (string)
    Timezone

  - `language` (string)
    Language

  - `latitude` (number)
    Latitude

  - `longitude` (number)
    Longitude

  - `enableRoot` (boolean)
    Enable global ROOT

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code:0,Normal Other codes are exceptions.

  - `msg` (string | null, required)
    Error message

  - `requestId` (string, required)
    Operation Request ID