Passer au contenu principal
PATCH
Mettre à jour un profil de sécurité de l’Enterprise
Met à jour un profil de sécurité appartenant à l’Enterprise. Les sessions en cours d’exécution conservent les restrictions déterminées lors de leur dernier démarrage ou de leur dernière sortie de veille ; les modifications s’appliquent immédiatement aux nouvelles sessions, et aux sessions existantes à leur prochaine reprise.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant de l’autorisation ManageAccountSecureModeProfiles au niveau Enterprise. Disponible uniquement pour les comptes d’entreprise.

Comportement

  • Les champs omis restent inchangés.
  • Une valeur null explicite efface la position du profil pour net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope et teams_group_chat_scope. La valeur null est rejetée pour les autres champs.
  • net_policy: null signifie que le profil n’a aucune position concernant le réseau, et non que tout est bloqué. Pour tout bloquer, utilisez {"allow": []}.
  • mcp_config.servers répertorie les serveurs MCP par slug (un slug de la place de marché, tel que github, ou le slug d’une installation).

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

profile_id
string
requis

Corps

application/json

Sémantique de PATCH : les champs omis restent inchangés ; la valeur explicite null efface les champs acceptant null (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope) et est rejetée pour les autres.

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
Options disponibles:
recommended,
mandatory
git_access_level
enum<string> | null
Options disponibles:
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
Options disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
Options disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
Options disponibles:
disabled,
origin_chat

Réponse

Réponse réussie

Un profil de sécurité appartenant à une Enterprise, partagé avec toutes les organisations de l’Enterprise. L’Enterprise propriétaire est déterminée implicitement par le token de l’appelant.

created_at
integer
requis
devin_mcp_read_only
boolean
requis

Si la valeur est true, les sessions peuvent uniquement appeler les outils MCP de Devin en lecture seule (aucune création de session, gestion des automatisations ou autre opération d’écriture).

enforcement_level
enum<string>
requis

Les profils recommandés peuvent être remplacés par des associations de niveau inférieur ; les profils obligatoires constituent un socle de restrictions que les politiques de niveau inférieur ne peuvent que renforcer.

Options disponibles:
recommended,
mandatory
git_access_level
enum<string>
requis
Options disponibles:
read_only,
read_write
name
string
requis
profile_id
string
requis

L’ID du profil de sécurité.

remove_github_cli_token
boolean
requis

Si la valeur est true, le token de l’interface en ligne de commande GitHub est supprimé de la machine de la session, ce qui empêche tout accès direct à l’API GitHub.

updated_at
integer
requis
mcp_config
SecurityProfileMcpConfig · object | null

null = ce profil n’a aucune préférence concernant MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = ce profil n’a aucune préférence concernant le réseau (cela ne signifie PAS que tout est interdit).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Périmètre maximal des canaux Slack dans lesquels les sessions régies par ce profil peuvent lire et publier des messages. null = ce profil n’a aucune préférence et le paramètre Slack de l’organisation s’applique.

slack_dm_scope
enum<string> | null

Périmètre maximal des personnes autorisées à envoyer des messages directs à Devin dans Slack avec ce profil. null = ce profil n’a aucune préférence et le paramètre Slack de l’organisation s’applique. 'workspace' est restreint à 'org_members' pour les comptes d’entreprise.

Options disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Périmètre maximal des canaux Microsoft Teams dans lesquels les sessions régies par ce profil peuvent lire et publier des messages. null = ce profil n’a aucune préférence et le paramètre d’accès par défaut à Teams de l’organisation s’applique.

teams_dm_scope
enum<string> | null

Périmètre maximal des personnes auxquelles Devin peut envoyer des messages directs dans Microsoft Teams avec ce profil. null = ce profil n’a aucune préférence et le paramètre d’accès par défaut à Teams de l’organisation s’applique.

Options disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Périmètre maximal des conversations de groupe Teams que Devin peut lire avec ce profil ; origin_chat = uniquement la conversation de groupe depuis laquelle la session a été lancée ; null = aucune préférence, l’accès est déterminé à partir du paramètre d’accès par défaut à Teams de l’organisation, comme pour les messages directs.

Options disponibles:
disabled,
origin_chat