Vai al contenuto principale
PATCH
Aggiorna un profilo di sicurezza dell'org
Aggiorna un profilo di sicurezza di proprietà di un’organizzazione. Le sessioni in esecuzione mantengono le restrizioni determinate al loro ultimo avvio o risveglio; le modifiche si applicano subito alle nuove sessioni e a quelle esistenti alla loro successiva ripresa.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageSecureModeProfiles a livello di organizzazione. I token usati da una sessione Devin in esecuzione vengono rifiutati, in modo che una sessione non possa modificare i profili che ne regolano il comportamento.

Comportamento

  • I campi omessi restano invariati.
  • Un null esplicito cancella l’impostazione del profilo per net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope e teams_group_chat_scope. Per gli altri campi, null viene rifiutato.
  • net_policy: null significa che il profilo non definisce alcuna impostazione di rete, non che blocca tutto il traffico. Per bloccare tutto, usa {"allow": []}.
  • mcp_config.servers elenca i server MCP tramite slug (uno slug del marketplace come github oppure lo slug di un’installazione).

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

profile_id
string
obbligatorio
org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json

Semantica PATCH: i campi omessi restano invariati; un valore null esplicito cancella i campi che ammettono null (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope) e viene rifiutato per gli altri.

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

Risposta

Risposta riuscita

Un profilo di sicurezza di proprietà dell'organizzazione.

created_at
integer
obbligatorio
devin_mcp_read_only
boolean
obbligatorio

Se true, le sessioni possono chiamare solo strumenti Devin MCP di sola lettura (nessuna creazione di sessioni, gestione di automazioni o altra operazione di scrittura).

enforcement_level
enum<string>
obbligatorio

i profili consigliati possono essere sovrascritti dalle associazioni dei livelli inferiori; i profili obbligatori impongono restrizioni minime che le policy dei livelli inferiori possono solo rendere più rigide.

Opzioni disponibili:
recommended,
mandatory
git_access_level
enum<string>
obbligatorio
Opzioni disponibili:
read_only,
read_write
name
string
obbligatorio
org_id
string
obbligatorio
profile_id
string
obbligatorio

L'ID del profilo di sicurezza.

remove_github_cli_token
boolean
obbligatorio

Se true, il token della GitHub CLI viene rimosso dalla macchina della sessione, impedendo l'accesso diretto all'API di GitHub.

updated_at
integer
obbligatorio
mcp_config
SecurityProfileMcpConfig · object | null

null = questo profilo non esprime alcuna preferenza su MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = questo profilo non esprime alcuna preferenza sulla rete (NON significa bloccare tutto).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Limite ai canali Slack in cui le sessioni regolate da questo profilo possono leggere e pubblicare messaggi. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Slack dell'organizzazione.

slack_dm_scope
enum<string> | null

Limite agli utenti che possono inviare messaggi diretti a Devin su Slack con questo profilo. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Slack dell'organizzazione. 'workspace' viene limitato a 'org_members' per gli account enterprise.

Opzioni disponibili:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Limite ai canali Microsoft Teams in cui le sessioni regolate da questo profilo possono leggere e pubblicare messaggi. null = questo profilo non esprime alcuna preferenza e si applica l'accesso predefinito a Teams dell'organizzazione.

teams_dm_scope
enum<string> | null

Limite ai destinatari a cui Devin può inviare messaggi diretti su Microsoft Teams con questo profilo. null = questo profilo non esprime alcuna preferenza e si applica l'accesso predefinito a Teams dell'organizzazione.

Opzioni disponibili:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Limite alle chat di gruppo di Teams che Devin può leggere con questo profilo; origin_chat = solo la chat di gruppo da cui è stata avviata la sessione; null = nessuna preferenza, l'accesso deriva dall'accesso predefinito a Teams dell'org, come per i messaggi diretti.

Opzioni disponibili:
disabled,
origin_chat