v3 API 当前处于 Beta 测试阶段。随着我们持续改进 API，部分端点可能会发生变化。
https://api.devin.ai/v3beta1/enterprise/*– 需要 Enterprise 级 权限的端点https://api.devin.ai/v3beta1/organizations/*– 作用域限定为单个组织的端点
部分 Enterprise 端点虽然是对特定组织进行操作，但仍然受
Enterprise 级权限保护。它们使用类似
/v3beta1/enterprise/organizations/{org_id}/...
的路径（例如：GET /v3beta1/enterprise/organizations/{org_id}/audit-logs）。
即使路径中包含 org_id 路径参数，它们仍然需要
ManageEnterpriseSettings 等 Enterprise 级权限。权限和 RBAC
/v3beta1/enterprise/* 端点，组织级 权限控制 /v3beta1/organizations/{org_id}/* 端点。具有企业级权限的 Enterprise 服务用户会在所有组织中自动继承相应的组织级权限。
Enterprise 权限
| Permission | 控制内容 |
|---|---|
ReadAccountMeta | 自身（默认授予所有服务用户） |
ManageEnterpriseSettings | 审计日志、组织标签 |
ManageOrganizations | 组织的 CRUD 操作、组织分组数量限制 |
ManageAccountMembership | 角色、Enterprise 用户、Enterprise IdP 分组、Enterprise 服务用户成员资格、Enterprise IdP 分组注册 |
ManageAccountServiceUsers | 服务用户开通与配置（Enterprise 级） |
ManageAccountKnowledge | Knowledge 笔记（Enterprise 级） |
ManageAccountPlaybooks | Playbooks（Enterprise 级） |
ManageGitIntegrations | Git 连接、Git 权限 |
ManageBilling | 计费周期、每日用量明细 |
ViewAccountMetrics | 使用指标（DAU/WAU/MAU、PR 数量、会话、搜索、活跃用户）、队列状态 |
ViewEnterpriseInfraDetails | 虚拟机管理程序 |
ViewAccountSessions | 会话列表和详情（Enterprise 级，只读） |
ManageAccountSessions | 向会话发送消息（Enterprise 级） |
ViewAccountSearches | 搜索（Enterprise 级） |
组织权限
| Permission | Controls |
|---|---|
ManageOrgSecrets | Secrets 的增删改查（组织级，CRUD） |
ManageOrgKnowledge | Knowledge 笔记（组织级） |
ManageOrgPlaybooks | Playbooks（组织级） |
ManageOrgServiceUsers | 服务用户开通（组织级） |
ViewOrgSessions | 会话列表和详情（组织级，只读） |
ManageOrgSessions | 发送消息、终止、归档会话 |
UseDevinSessions | 创建会话 |
ImpersonateOrgSessions | 代表其他用户创建会话（create_as_user_id） |
ViewOrgSearches | 搜索（组织级） |
服务用户作用域
/v3beta1/enterprise/* 端点进行认证，可以跨所有组织执行操作。它们被分配 Enterprise 级别角色，并会在每个组织中自动继承相应的组织级权限（例如，ViewAccountSessions 会在所有组织中授予 ViewOrgSessions 权限）。
组织服务用户的权限范围仅限于单个组织，只能通过 /v3beta1/organizations/{org_id}/* 端点进行认证。它们被分配的是组织级角色。
创建服务用户
- UI：Enterprise Settings → Service Users — 创建企业级或组织级服务用户，分配自定义角色并生成 API token。
- API：
POST /v3beta1/enterprise/service-users或POST /v3beta1/organizations/{org_id}/service-users— 以编程方式创建具有指定角色和 TTL 的服务用户。新用户的权限必须是调用方权限的子集（以防止权限提升）。
Self
审计日志
用量
组织
服务用户
列出 Enterprise 级服务用户
查看 Enterprise 级服务用户
创建 Enterprise 级服务用户
创建 Enterprise 级服务用户
更新 Enterprise 级服务用户
更新 Enterprise 级服务用户
删除 Enterprise 级服务用户
删除 Enterprise 级服务用户
列出组织级服务用户
查看组织级服务用户
创建组织级服务用户
创建组织级服务用户
用户
IdP 组
列出已注册的企业级组
列出在此企业级账户中已注册的 IdP 组
注册企业级组
为此企业级账户注册 IdP 组
移除已注册的企业级组
从此企业级账户中移除已注册的 IdP 组
列出企业级组
查看企业级 IdP 组分配情况
分配企业级组
在企业级别分配 IdP 组角色
列出组织级组
查看组织级 IdP 组分配情况
分配组织级组
在组织级别分配 IdP 组角色
Git 权限
笔记
列出企业级笔记
查看企业级 Knowledge 笔记
创建企业级笔记
创建新的企业级 Knowledge 笔记
列出组织级笔记
查看组织级 Knowledge 笔记
创建组织级笔记
创建新的组织级 Knowledge 笔记
Playbook
列出 Enterprise 级 Playbook
查看 Enterprise 级 Playbook
创建 Enterprise 级 Playbook
创建新的 Enterprise 级 Playbook
列出组织级 Playbook
查看组织级 Playbook
创建组织级 Playbook
创建新的组织级 Playbook
会话
角色与指标
使用示例
查看代码示例
查看 v3 API 的代码示例和常见使用场景