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

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ManageSecureModeProfiles no nível da organização. Tokens usados por uma sessão do Devin em execução são rejeitados, para que uma sessão não possa alterar os perfis que a regem.

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. null é rejeitado nos demais campos.
  • net_policy: null significa que o perfil não tem nenhuma definição de rede, e não que todo o tráfego é negado. Para negar tudo, use {"allow": []}.
  • mcp_config.servers lista os 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
org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

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 à organização.

created_at
integer
obrigatório
devin_mcp_read_only
boolean
obrigatório

Quando true, as sessões só podem chamar ferramentas somente de leitura do Devin MCP (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 descendentes; perfis obrigatórios estabelecem um nível mínimo de restrição que as políticas descendentes só podem tornar mais rigoroso.

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
org_id
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 define uma preferência de MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = este perfil não define uma preferência de rede (NÃO significa bloquear tudo).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Restrição que define em quais canais do Slack as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não define uma preferência e aplica-se a configuração do Slack da organização.

slack_dm_scope
enum<string> | null

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

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

Restrição que define em quais canais do Microsoft Teams as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não define uma preferência e aplica-se o Acesso Padrão do Teams da organização.

teams_dm_scope
enum<string> | null

Restrição que define a quem o Devin pode enviar mensagens diretas no Microsoft Teams com este perfil. null = este perfil não define uma preferência e aplica-se o Acesso Padrão do Teams da organização.

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

Restrição que define quais conversas em grupo do Teams o Devin pode ler com este perfil; origin_chat = apenas a conversa em grupo na qual a sessão foi iniciada; null = nenhuma preferência, com a configuração derivada do Acesso Padrão do Teams da organização, assim como nas mensagens diretas.

Opções disponíveis:
disabled,
origin_chat