跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

Organization API 与跨团队同步

选择组织 scope,按完整团队集合同步成员,并区分合同窗口费用。

Organization API 使用组织级 key 的 Basic auth,不能拿 Team key 调用组织路由,也不能拿 Organization key 当作 /teams/* 的凭据。每把组织 key 恰好选择一个 scope,较宽 scope 可包含较窄能力。

Scope

Scope用途
members:read只读组织成员
members:*成员写入与所有组织组路由
usage:*共享池与使用报表
models:read / models:*读取 / 修改模型策略
auditlogs:read组织审计
admin:*全部组织路由,Grok Bot computer operations 必须使用此项

GET /organizations/members 返回组织角色和 linked-team 角色,page 从 1、pageSize 最大 200。teamId 筛选未关联的团队返回空页。组织 admin 与团队 owner/member 不等同。

来源此处把成员 id 描述为数字,却声称与已改为 user_… 的 Team API id 相同;实现按实际响应保留类型,不作未经核实的数字转换或等值连接。

团队资格同步是替换

POST /organizations/team-memberships/sync 要求 organizationId 与 key 对应组织一致,users 非空且最多 500 项。每项 userId 可数字或字符串,且恰好选择 teamIds 或 destinationTeamId。

teamIds 是用户最终应属于的完整集合,最多 100 个团队;未列出的原团队会移除。destinationTeamId 等同只有一个元素的 teamIds。迁移时要保留旧团队,必须把旧、新团队都列出。

用户须已是组织成员,目标团队都需 linked。HTTP 200 可含逐项 error,检查 results、successCount、errorCount,不把整个批次看作原子事务。

用量与支出

POST /organizations/pooled-usage 返回当前合同周期 limitCents/usedCents/remainingCents 和 per-team 分解;contract 日期可 null,budgetLimitCents 仅在团队有预算时出现。

POST /organizations/filtered-usage-events 默认全池,可用 teamIds 缩小范围,事件带 teamId。pageSize 默认 10,不同于 Team 端点默认 100。日期为双包含的毫秒边界,用 chargedCents 对账。

POST /organizations/daily-usage-data 默认最近 7 天,最长 30 天,pageSize 默认/最大 1000,返回期间具有资格的成员;teamIds 最多 100。POST /organizations/spend 也可按团队分组,pageSize 默认 100、最大 1000。

组织 spendCents 指组织合同窗口的 included pool spend,不能套用 Team /spend 的 on-demand 含义;period 给出范围,且没有 team 版 overallSpendCents 等字段。用量按小时聚合,官方建议每小时最多查询一次,限每分钟 20 次。