跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

Organization Groups API

用 g_ 标识管理跨团队群体,处理名称查询、限额与 SCIM 约束。

组织组路由使用 Organization key,所有读取和写入都需 members:* 或 admin:*。members:read 只够列组织成员,不能据名称推断它能读组。

ID 与查询

路径 /organizations/groups,列表对象同时含 id(g_…)和 publicId(grp_…)。凡 :groupId 使用 g_…,不能换成 grp_…、组名、team_group_… 或账单 group_…。

GET 列表可带 URL-encoded name 精确匹配;无结果为 200 与空 groups,不是 404。name 空或省略列全部。page 默认 1、pageSize 默认 50、最多 200,更大值截断到 200。成员列表采用同样分页。

创建与修改

POST /organizations/groups 创建手工组,name 去首尾空白且在组织 active groups 中唯一,成功 201。SCIM 组从 dashboard/IdP 同步建立。

PATCH /:groupId 是部分更新,省略字段不变;name 可改名,monthlySpendingLimitDollars 是 0–2147483647 整数。删除限额用 clearMonthlySpendingLimitDollars:true,不能同次又给额度。

成员和删除

GET /:groupId/members 读取成员;POST /:groupId/members/bulk-add 或 /bulk-remove 提交最多 100 个 user_… ID。

添加忽略组织外用户和已在组成员,删除忽略原本不在组的人,按 addedCount/removedCount 判断实际变化。SCIM 组手工成员变更返回 400,需在 IdP 操作。

DELETE /:groupId 要求组为空且没有 active SCIM mapping;先移除映射与成员,成功 204。各路由每组织每分钟 20 次,429 带 Retry-After:60。组影响团队权限的实际合并规则见组织组。