メインコンテンツへスキップ
PATCH
組織のセキュリティプロファイルを更新
組織が所有するセキュリティプロファイルを更新します。実行中のセッションには、最後の起動時または復帰時に決定された制限が引き続き適用されます。変更内容は、新しいセッションには即時に、既存のセッションには次回の再開時に適用されます。

権限

組織レベルで ManageSecureModeProfiles 権限を持つサービスユーザーまたは個人用アクセストークンが必要です。実行中の Devin セッションが利用するトークンは拒否されるため、セッションが自身に適用されるプロフィールを変更することはできません。

動作

  • 省略したフィールドは変更されません。
  • null を明示的に指定すると、net_policy、mcp_config、slack_channel_access、slack_dm_scope、teams_channel_access、teams_dm_scope、teams_group_chat_scope に対するプロフィールの設定がクリアされます。その他のフィールドに null を指定すると拒否されます。
  • net_policy: null は、プロフィールにネットワーク設定がないことを意味し、すべてを拒否するという意味ではありません。すべてを拒否するには {"allow": []} を利用してください。
  • mcp_config.servers には、MCPサーバーを slug で列挙します (github などの marketplace の slug、またはインストールの slug) 。

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

パスパラメータ

profile_id
string
必須
org_id
string
必須

組織ID(プレフィックス:org-)

例:

"org-abc123def456"

ボディ

application/json

PATCHの動作:省略されたフィールドは変更されません。明示的にnullを指定すると、 nullを許容するフィールド(net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope)はクリアされ、それ以外のフィールドでは拒否されます。

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

レスポンス

成功レスポンス

組織が所有するセキュリティプロファイル。

created_at
integer
必須
devin_mcp_read_only
boolean
必須

true の場合、セッションは読み取り専用の Devin MCP ツールのみを呼び出せます(セッション作成、自動化の管理、その他の書き込み操作は不可)。

enforcement_level
enum<string>
必須

推奨プロファイルは下位階層のバインドで上書きできます。必須プロファイルは制限の最低基準となり、下位階層のポリシーでは制限を厳しくすることしかできません。

利用可能なオプション:
recommended,
mandatory
git_access_level
enum<string>
必須
利用可能なオプション:
read_only,
read_write
name
string
必須
org_id
string
必須
profile_id
string
必須

セキュリティプロファイルの ID。

remove_github_cli_token
boolean
必須

true の場合、セッションのマシンから GitHub CLI トークンが削除され、GitHub API への直接アクセスができなくなります。

updated_at
integer
必須
mcp_config
SecurityProfileMcpConfig · object | null

null = このプロファイルでは MCP の設定は未指定。

net_policy
SecurityProfileNetPolicy · object | null

null = このプロファイルではネットワーク設定は未指定(すべて拒否するという意味ではありません)。

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

このプロファイルの適用対象セッションが読み取りと投稿を行える Slackチャンネルの最大許可範囲。null = このプロファイルでは未指定で、組織の Slack 設定が適用されます。

slack_dm_scope
enum<string> | null

このプロファイルの適用時に、Slack で Devin に DM を送信できるユーザーの最大許可範囲。null = このプロファイルでは未指定で、組織の Slack 設定が適用されます。Enterprise アカウントでは、'workspace' は 'org_members' に制限されます。

利用可能なオプション:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

このプロファイルの適用対象セッションが読み取りと投稿を行える Microsoft Teams チャンネルの最大許可範囲。null = このプロファイルでは未指定で、組織の Teams のデフォルトアクセス設定が適用されます。

teams_dm_scope
enum<string> | null

このプロファイルの適用時に、Devin が Microsoft Teams で DM を送信できる相手の最大許可範囲。null = このプロファイルでは未指定で、組織の Teams のデフォルトアクセス設定が適用されます。

利用可能なオプション:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

このプロファイルの適用時に、Devin が読み取れる Teams グループチャットの最大許可範囲。origin_chat = セッションの開始元のグループチャットのみ。null = 未指定で、DM と同様に、組織の Teams のデフォルトアクセス設定に基づいて決まります。

利用可能なオプション:
disabled,
origin_chat