跳转到主要内容
POST
创建企业安全 Profile
创建一个归企业所有、并共享给其下所有组织的安全 Profile。各组织均可选用该 Profile,但只有企业管理员可以编辑。如需在 enterprise-wide 范围内应用该 Profile,请使用设置企业默认 Profile。

权限

需要具有企业级 ManageAccountSecureModeProfiles 权限的服务用户或个人访问令牌。仅适用于企业账户。

行为

  • 仅 name 为必填项。Profile 名称在企业内必须唯一。
  • 省略 net_policy 时,Profile 的初始配置是一个仅包含 Git 集成主机的允许列表 (与设置页面的初始配置相同) 。显式设为 null 表示该 Profile 不对网络做任何限定,而非拒绝所有连接。
  • remove_github_cli_token 默认为 true。如需保留该令牌 (false) ,必须设置 git_access_level: read_write;若已设置网络策略,其允许列表还必须包含 api.github.com。
  • git_access_level 默认为 read_write,enforcement_level 默认为 recommended。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

请求体

application/json
name
string
必填
Required string length: 1 - 128
devin_mcp_read_only
boolean
默认值:false
enforcement_level
enum<string>
默认值:recommended
可用选项:
recommended,
mandatory
git_access_level
enum<string>
默认值:read_write
可用选项:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

省略 = 仅包含 Git 集成主机的允许列表(与安全配置用户界面的初始默认值相同);显式设为 null = 此 Profile 不对网络作规定(并不表示全部拒绝)。由于默认允许列表不包含 api.github.com,remove_github_cli_token=false 的请求必须显式提供 net_policy(也可设为 null)。

remove_github_cli_token
boolean
默认值:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

省略或设为 null = 此 Profile 不对 Slack 频道作规定(使用组织的 Slack 设置)。

slack_dm_scope
enum<string> | null

省略或设为 null = 此 Profile 不对 Slack 私信作规定(使用组织的 Slack 设置)。

可用选项:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

省略或设为 null = 此 Profile 不对 Teams 频道作规定(使用组织的 Teams 默认访问设置)。

teams_dm_scope
enum<string> | null

省略或设为 null = 此 Profile 不对 Teams 私信作规定(使用组织的 Teams 默认访问设置)。

可用选项:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

省略或设为 null = 此 Profile 不对 Teams 群聊作规定(与私信一样,由组织的 Teams 默认访问设置派生)。

可用选项:
disabled,
origin_chat

响应

成功响应

归企业所有、与企业中所有组织 共享的安全 Profile。所属企业由调用方的令牌确定。

created_at
integer
必填
devin_mcp_read_only
boolean
必填

为 true 时,会话只能调用只读 Devin MCP 工具(不允许创建会话、管理自动化或执行其他写入操作)。

enforcement_level
enum<string>
必填

推荐的 Profile 可被下级绑定覆盖;强制 Profile 规定了最低限制,下级策略只能在此基础上进一步收紧。

可用选项:
recommended,
mandatory
git_access_level
enum<string>
必填
可用选项:
read_only,
read_write
name
string
必填
profile_id
string
必填

安全 Profile 的 ID。

remove_github_cli_token
boolean
必填

为 true 时,会从会话所在的机器上移除 GitHub CLI 令牌,阻止直接访问 GitHub API。

updated_at
integer
必填
mcp_config
SecurityProfileMcpConfig · object | null

null = 此 Profile 对 MCP 不作规定。

net_policy
SecurityProfileNetPolicy · object | null

null = 此 Profile 对网络不作规定(并不表示全部拒绝)。

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

此 Profile 允许会话读取和发送消息的最大 Slack 频道范围。null = 此 Profile 不作规定,采用组织的 Slack 设置。

slack_dm_scope
enum<string> | null

此 Profile 允许在 Slack 中向 Devin 发送私信的最大人员范围。null = 此 Profile 不作规定,采用组织的 Slack 设置。对于企业账户,'workspace' 会收窄为 'org_members'。

可用选项:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

此 Profile 允许会话读取和发送消息的最大 Microsoft Teams 频道范围。null = 此 Profile 不作规定,采用组织的 Teams 默认访问权限设置。

teams_dm_scope
enum<string> | null

此 Profile 允许 Devin 在 Microsoft Teams 中发送私信的最大收件人范围。null = 此 Profile 不作规定,采用组织的 Teams 默认访问权限设置。

可用选项:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

此 Profile 允许 Devin 读取的最大 Teams 群聊范围;origin_chat = 仅限发起该会话的群聊;null = 不作规定,与私信一样,由组织的 Teams 默认访问权限设置确定。

可用选项:
disabled,
origin_chat