Pular para o conteúdo principal
PATCH
Atualizar um perfil de segurança da empresa
Atualiza um perfil de segurança pertencente à empresa. As sessões em execução mantêm as restrições resolvidas na última inicialização ou retomada; as alterações são aplicadas imediatamente às novas sessões e às sessões existentes na próxima vez em que forem retomadas.

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ManageAccountSecureModeProfiles no nível empresarial. Disponível apenas para contas empresariais.

Comportamento

  • Campos omitidos permanecem inalterados.
  • Um null explícito remove a definição do perfil para net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope e teams_group_chat_scope. Nos demais campos, null é rejeitado.
  • net_policy: null significa que o perfil não define nenhuma política de rede, e não que todo o tráfego é negado. Para negar todo o tráfego, use {"allow": []}.
  • mcp_config.servers lista servidores MCP por slug (um slug do marketplace, como github, ou o slug de uma instalação).

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

profile_id
string
obrigatório

Corpo

application/json

Semântica de PATCH: campos omitidos permanecem inalterados; um null explícito limpa os campos que aceitam null (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope) e é rejeitado nos demais.

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
Opções disponíveis:
recommended,
mandatory
git_access_level
enum<string> | null
Opções disponíveis:
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
Opções disponíveis:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
Opções disponíveis:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
Opções disponíveis:
disabled,
origin_chat

Resposta

Resposta Bem-Sucedida

Um perfil de segurança pertencente à empresa, compartilhado com todas as organizações da empresa. A empresa proprietária é determinada implicitamente pelo token do solicitante.

created_at
integer
obrigatório
devin_mcp_read_only
boolean
obrigatório

Quando true, as sessões só podem chamar ferramentas MCP do Devin de somente leitura (sem criação de sessões, gerenciamento de automações ou outras operações de gravação).

enforcement_level
enum<string>
obrigatório

perfis recomendados podem ser substituídos por vinculações de níveis inferiores; perfis obrigatórios definem restrições mínimas que as políticas desses níveis só podem tornar mais rigorosas.

Opções disponíveis:
recommended,
mandatory
git_access_level
enum<string>
obrigatório
Opções disponíveis:
read_only,
read_write
name
string
obrigatório
profile_id
string
obrigatório

O ID do perfil de segurança.

remove_github_cli_token
boolean
obrigatório

Quando true, o token da CLI do GitHub é removido da máquina da sessão, impedindo o acesso direto à API do GitHub.

updated_at
integer
obrigatório
mcp_config
SecurityProfileMcpConfig · object | null

null = este perfil não tem nenhuma preferência quanto ao MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = este perfil não tem nenhuma preferência quanto à rede (isso NÃO significa negar tudo).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Restrição dos canais do Slack nos quais as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não tem nenhuma preferência e a configuração do Slack da organização se aplica.

slack_dm_scope
enum<string> | null

Restrição de quem pode enviar mensagens diretas ao Devin no Slack com este perfil. null = este perfil não tem nenhuma preferência e a configuração do Slack da organização se aplica. 'workspace' é restrito a 'org_members' para contas empresariais.

Opções disponíveis:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Restrição dos canais do Microsoft Teams nos quais as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não tem nenhuma preferência e o Acesso Padrão do Teams da organização se aplica.

teams_dm_scope
enum<string> | null

Restrição de quem pode receber mensagens diretas do Devin no Microsoft Teams com este perfil. null = este perfil não tem nenhuma preferência e o Acesso Padrão do Teams da organização se aplica.

Opções disponíveis:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Restrição dos chats em grupo do Teams que o Devin pode ler com este perfil; origin_chat = somente o chat em grupo a partir do qual a sessão foi iniciada; null = nenhuma preferência, com o acesso determinado pelo Acesso Padrão do Teams da organização, assim como nas mensagens diretas.

Opções disponíveis:
disabled,
origin_chat