# Delete group

Delete one or more profile groups.
- **Preconditions**: at least one id must resolve within the team and the caller must be authorized for it; ids that do not resolve are ignored silently.
- **Effect**: deletes the groups and their member access grants. Browser profiles and Cloud Phones that were in them become ungrouped, so no dangling group reference is left behind. Setting the delete-environments flag additionally moves the profiles you are authorized for **into the recycle bin** — they are not destroyed and Cloud Phones are never affected by that flag.
- **Completion**: synchronous but **not atomic**. The group is deleted first and the follow-up steps can still fail, for example when a profile is running or mid-transfer, leaving the group gone and the profiles unmoved.
- **Retry**: verify with `/envgroup/page` and the profile list before retrying.

Documented business errors: `19064`. See [Error Codes](../Getting%20Started/error-codes.md) for what each code means. Any operation can additionally return the common codes.

Endpoint: POST /api/envgroup/delete
Version: 2026-09-05

## Request fields (application/json):

  - `ids` (array, required)
    Unique ID of the group to be updated

  - `isDeleteAllEnv` (boolean)
    Delete environments in the group? false:Do not delete true:Delete

## Response 200 fields (application/json):

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

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

  - `data` (boolean, required)

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