Organization API 与跨团队同步
选择组织 scope，按完整团队集合同步成员，并区分合同窗口费用。
This page has not been translated into English yet. The original Chinese version is shown below.
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 次。