Pular para o conteúdo principal
POST
Criar um perfil de segurança da organização
Cria um perfil de segurança pertencente à organização. Criar um perfil não o aplica a nenhum recurso; para vinculá-lo como padrão, use Definir valores padrão de perfil de segurança da organização.

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

  • Apenas name é obrigatório. Os nomes de perfil devem ser exclusivos dentro da organização.
  • Quando net_policy é omitido, o perfil parte de uma lista de permissões que contém apenas o host da integração com o Git (o mesmo ponto de partida da página de configurações). Um null explícito significa que o perfil não define nenhuma regra de rede, e não que todo o tráfego é negado.
  • O valor padrão de remove_github_cli_token é true. Manter o token (false) exige git_access_level: read_write e, quando uma network policy estiver definida, uma lista de permissões que inclua api.github.com.
  • O valor padrão de git_access_level é read_write, e o de enforcement_level é recommended.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

org_id
string
obrigatório

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

Exemplo:

"org-abc123def456"

Corpo

application/json
name
string
obrigatório
Required string length: 1 - 128
devin_mcp_read_only
boolean
padrão:false
enforcement_level
enum<string>
padrão:recommended
Opções disponíveis:
recommended,
mandatory
git_access_level
enum<string>
padrão:read_write
Opções disponíveis:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Omitido = uma lista de permissões contendo apenas o host da integração com o Git (o mesmo padrão inicial da UI de Perfis de Segurança); null explícito = este perfil não define uma preferência de rede (NÃO significa bloquear tudo). Como a lista de permissões padrão não inclui api.github.com, uma requisição com remove_github_cli_token=false deve fornecer net_policy explicitamente (ou null).

remove_github_cli_token
boolean
padrão:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Omitido ou null = este perfil não define uma preferência para canais do Slack (aplica-se a configuração do Slack da organização).

slack_dm_scope
enum<string> | null

Omitido ou null = este perfil não define uma preferência para mensagens diretas no Slack (aplica-se a configuração do Slack da organização).

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

Omitido ou null = este perfil não define uma preferência para canais do Teams (aplica-se o Acesso Padrão do Teams da organização).

teams_dm_scope
enum<string> | null

Omitido ou null = este perfil não define uma preferência para mensagens diretas no Teams (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

Omitido ou null = este perfil não define uma preferência para conversas em grupo no Teams (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

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