Skip to content
FunCoding

Search

Search docs, Skills and MCP

团队 Admin API

读取成员与调整限额,区分批量部分成功、移除限制和仓库策略。

This page has not been translated into English yet. The original Chinese version is shown below.

Admin API 使用 Team API key 的 Basic auth,key 作用户名、空密码。它管理团队成员、费用、目录组、模型及其他管理设置,不等于创建 Cloud Agent 的个人运行凭据。

读取成员

curl -u YOUR_API_KEY: https://api.cursor.com/teams/members

teamMembers 包含 id、email、name、role、isRemoved。id 是 user_… encoded 字符串,可与 OTel cursor.user.account_id 连接;需要活跃成员时不要忽略 isRemoved。

单人和批量限额

Enterprise 的 POST /teams/user-spend-limit 接收 userEmail 和 spendLimitDollars,金额仅整数美元;0 是零额度,null 才是移除限制。用户须已在团队,限每分钟 250 次。

Preview POST /teams/user-spend-limits 接收 updates 数组,每次 1–100 项,限每分钟 20 次。检查 results 中 updated/unchanged/failed;不存在成员可单项失败,不阻止其他项。无效字段、重复邮箱或超过 100 项返回 400,整批不应用。未获 rollout 的团队可收到 403。

重复成功设置返回 unchanged,不再产生重复审计。实际生效的覆盖关系见用量预算。

移除成员

Enterprise POST /teams/remove-member 使用 userId 或 email,二选一;每分钟 50 次。完成后必须仍有至少一名付费成员和一名管理员(owner/free-owner)。移除团队资格不等于删除整个账号。

仓库 blocklist

GET /settings/repo-blocklists/repos 查看配置;POST /settings/repo-blocklists/repos/upsert 提交 repos 数组,每项含 url 和 patterns。

upsert 替换请求中所列仓库的 patterns,未列出的仓库保持。* 可匹配整个仓库,**/*.secret 匹配子目录文件;DELETE /settings/repo-blocklists/repos/:repoId 移除一项,成功返回 204。

这些是上下文/仓库策略,不代替 OS 文件权限。审计查询见审计日志,目录组和账单组见组管理 API。