跳转到主要内容
PATCH
更新企业安全 Profile
更新企业所属的安全 Profile。正在运行的会话会沿用其在上次启动或唤醒时解析得到的限制;更改会立即对新会话生效,现有会话则在下次恢复时生效。

权限

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

行为

  • 省略的字段保持不变。
  • 显式传入 null 会清除该 Profile 在 net_policy、mcp_config、slack_channel_access、slack_dm_scope、teams_channel_access、teams_dm_scope 和 teams_group_chat_scope 上的设置。其他字段不接受 null,传入将被拒绝。
  • net_policy: null 表示该 Profile 不对网络做任何设定,而非拒绝所有访问。如需拒绝所有访问,请使用 {"allow": []}。
  • mcp_config.servers 按 slug 列出 MCP 服务器 (可以是 MCP Marketplace 中的 slug,例如 github,也可以是某个安装实例的 slug) 。

授权

Authorization
string
header
必填

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

路径参数

profile_id
string
必填

请求体

application/json

PATCH 语义:省略的字段保持不变;显式传入 null 会清除可为空的字段(net_policy、mcp_config、slack_channel_access、 slack_dm_scope、teams_channel_access、teams_dm_scope、 teams_group_chat_scope),其他字段则不接受 null。

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
可用选项:
recommended,
mandatory
git_access_level
enum<string> | null
可用选项:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
name
string | null
Required string length: 1 - 128
net_policy
SecurityProfileNetPolicy · object | null
remove_github_cli_token
boolean | null
slack_channel_access
SecurityProfileSlackChannelAccess · object | null
slack_dm_scope
enum<string> | null
可用选项:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
可用选项:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
可用选项:
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