# Profiles

Profiles 相关 API。

 - [POST /api/env/setTags/batch](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/setbrowserprofiletagslocal.md): 覆盖所选资源的标签。需要标签管理权限及目标资源访问权限。按团队内的精确名称匹配标签：不存在则创建，已存在则复用并更新颜色；颜色变化也会影响使用同一标签的其他资源。请求中的标签名称不能重复。`tags` 传空数组仅清空标签关联，保留标签定义与分组。同步完成，`data` 为 null。超时后先查询目标资源及 `/api/envtag/all` 再决定是否重试；接口没有幂等键。 已记录的业务错误码：`
 - [POST /api/env/create/quick](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/createbrowserprofilequicklocal.md): 批量创建 1 到 200 个配置相同的浏览器。 - **前置条件** ：团队套餐必须有足够的剩余浏览器额度，且当日创建配额未用尽。 `isEncrypt=1` 要求团队已配置加密密钥。Firefox 仅在 Windows 与 macOS 上可用。 `groupId` 必须已存在，但改传 `groupName` 会自动创建分组。 - **副作用** ：写入浏览器，消耗套餐额度并递增当日创建计数
 - [POST /api/env/create/advanced](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/createbrowserprofileadvancedlocal.md): 创建一个浏览器，并指定完整的指纹配置。 - **前置条件** ：与快速创建相同的套餐额度与当日配额校验。浏览器名称在团队内必须唯一，坐标必须落在中国大陆以外，且 `advancedSetting.ua` 必须与 `uaVersion` 一致。传入的 `proxyId` 必须已存在于团队中。 - **副作用** ：写入浏览器、其账号凭据（加密存储）和启动后配置；消耗套餐额度与当日创建计数。自定
 - [POST /api/env/update](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/updatebrowserprofilelocal.md): 更新已有的浏览器。只修改请求中出现的字段。 - **前置条件** ：浏览器必须存在于团队中。端到端加密的浏览器不可更新。操作系统与浏览器类型不可更改。运行中的浏览器可以更新。 - **副作用** ：写入浏览器主记录、其扩展设置与 Cookie，并合并高级指纹设置（未被覆盖的已有值保留）。 - **完成信号** ：同步。 - **重试** ：相同请求体可安全重复。注意没有乐观锁：对同一浏览器的并发更
 - [POST /api/env/removeToRecycleBin/batch](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/batchdeletebrowserprofilesusingpost.md): 把一个或多个浏览器移入回收站。 - **前置条件** ：浏览器不能已在回收站中，不能正在运行，也不能处于转移中。请先关闭浏览器。 - **副作用** ：软删除。数据行、指纹和云端缓存都保留，浏览器被标记为已回收并记录时间戳。套餐额度立即释放，但当日创建计数不会退回。 - **完成信号** ：同步。 - **恢复** ：从回收站恢复的能力未在接口层开放——请使用 MoreLogin 客户端或网页控制
 - [POST /api/env/page](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/listbrowserprofilesusingpost.md): 分页列出当前认证成员可见的浏览器。 - **副作用** ：无。只读。可带退避安全重试。 - **筛选** ： `keyword` 匹配浏览器名称、备注、标签名与分组名。 `groupId` 为 `0` 表示未分组。 - **说明** ：普通成员、以及平台代理和动态代理的密码不会返回。
 - [POST /api/env/detail](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/getbrowserprofiledetailsusingpost.md): 返回单个浏览器的完整配置，含高级指纹设置与 Cookie。 - **前置条件** ：浏览器必须存在于团队中，且调用者对它有权限。 - **副作用** ：无。只读。可带退避安全重试。 - **说明** ：账号密码与两步验证密钥只对团队所有者返回，或在该浏览器未配置为隐藏它们时返回。
 - [POST /api/env/lock/query](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/querybrowserlockstatususingpost.md): 查询浏览器当前是否被其他团队成员占用。 - **副作用** ：无。只读。可带退避安全重试。 - **语义** ：返回 `true` 需同时满足——团队启用了安全锁功能、锁存在、且持有者不是调用者本人。锁按成员持有并带过期时间，因此它可能自行失效。
 - [POST /api/env/setGroup/batch](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/setbrowsergroupsbatchlocal.md): 按分组名称把浏览器移入分组。 - **前置条件** ： `envIds` 与 `uniqueIds` 至少提供一个； `groupName` 必填且不超过 50 字符。本接口无法清除浏览器的分组。 - **副作用** ：分组名不存在时会自动创建，这会 **计入团队 1000 个分组的上限** ，达到上限后调用失败。一个浏览器只属于一个分组，因此原分组会被替换。当团队按分组授权时，这里新建的分
 - [POST /api/env/setProxy/batch](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/setbrowserproxiesbatchlocal.md): 为多个浏览器绑定代理。 - **前置条件** ： `envIds` 与 `uniqueIds` 至少提供一个。传入的 `proxyId` 必须已存在于团队中，否则调用被拒绝而不是自动创建。 - **副作用** ：在每个浏览器上写入 `proxyId` 。默认情况下，当 `proxyId` 省略或为 `0` 时，会复用连接信息完全相同的已有代理； **若没有匹配项，则在调用方团队中新建一条
 - [POST /api/env/setRemark/batch](https://guide.morelogin.com/zh/api-reference/browser/local-api/profiles/setbrowserremarksbatchlocal.md): 批量设置浏览器备注。传空字符串表示清除备注。 - **前置条件** ： `envIds` 与 `uniqueIds` 至少提供一个；调用者对每个浏览器都要有权限。 - **副作用** ：只写备注字段。 - **完成信号** ：同步，相同请求体完全幂等。
