跳转到主要内容
每个 API 端点都受分配给调用该端点的服务用户角色的特定权限管控。每个端点所需的权限都记录在其各自的 API 参考页面上。本页面按权限作用域汇总列出了所有权限。 基础 URL:
  • https://api.devin.ai/v3/organizations/* — 作用域为单个组织的端点
  • https://api.devin.ai/v3/enterprise/* — 需要企业级权限的端点
使用专用部署的 Devin Enterprise 客户应将 api.devin.ai 替换为其自定义 API 域名 (例如 api.your-company.devinenterprise.com) 。有关部署配置的详细信息,请参阅 Enterprise 快速入门
Settings → Service Users 页面中查找您的组织 ID。
某些企业级端点会使用类似 /v3/enterprise/organizations/{org_id}/... 的路径对特定组织执行操作 (例如审计日志和标签) 。 即使其中包含 org_id 参数,这些端点仍然需要 企业级 权限。

Enterprise 权限

组织权限

权限继承

Enterprise 服务用户通过 /v3/enterprise/* 端点进行认证,可以跨所有组织执行操作。它们被分配 Enterprise 级别角色,并会在每个组织中自动继承相应的组织级权限 (例如,ViewAccountSessions 会在所有组织中授予 ViewOrgSessions 权限) 。 组织服务用户的权限范围仅限于单个组织,只能通过 /v3/organizations/{org_id}/* 端点进行认证。它们被分配的是组织级角色。

创建服务用户

通过 Devin 界面创建服务用户:
  1. Enterprise (企业版) 服务用户:Enterprise settings → Service Users
  2. 组织服务用户:Organization settings → Service Users
有关配置说明,请参阅团队快速入门Enterprise (企业版) 快速入门