# 批量操作团队应用

v2.70.0 新增。应用必须属于当前团队。使用 `/cloudphone/team/app/page` 返回的团队应用 ID，不是云手机 ID 或应用市场 ID。
对安装范围内已开机且当前成员有权访问的手机执行 `START`、`STOP`、`RESTART` 或 `UNINSTALL`。`onlyStartedByMe=true` 进一步按最后开机成员筛选。没有可操作目标时报错。即使个别设备调用失败也可能返回 `data=true`，它仅表示批处理循环结束，不保证逐设备成功。卸载保留团队应用和安装范围。不要自动重试。
**所需权限**: `CLOUD_PHONE_APP_BATCH_OPERATE`.
已记录的业务错误码：`33354`, `33423`, `99002`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /cloudphone/team/app/operate
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    团队应用 ID

  - `operation` (string, required)
    操作：启动、停止、重启或卸载
    Enum: "START", "STOP", "RESTART", "UNINSTALL"

  - `onlyStartedByMe` (boolean)
    仅操作最后由当前成员开机的手机；默认 false

## Response 200:

  - `200` (unknown)
    成功。data=true 仅确认批处理循环结束，不保证每台设备操作成功。

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (boolean)

  - `requestId` (string)