Pular para o conteúdo principal
PATCH
Atualizar configurações de perfis de segurança da empresa
Atualiza a seleção do security-profile padrão da empresa e retorna as configurações resultantes.

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. null é rejeitado; para limpar o padrão, envie {"default": {"selection": "none"}}.
  • profile_id é obrigatório quando selection é profile e deve ser omitido nos demais casos. Somente perfis pertencentes à empresa podem ser fixados.
  • Um padrão da empresa obrigatório funciona como um nível mínimo: organizações, automações e sessões só podem torná-lo mais restritivo. Consulte imposição obrigatória vs. recomendada.
  • Sessões em execução aplicam a alteração na próxima inicialização ou retomada.

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json

Semântica de PATCH: campos omitidos permanecem inalterados.

default
EnterpriseSecurityProfileDefaultSelection · object | null

Uma configuração padrão com dois estados: none (sem perfil padrão) ou profile (fixar profile_id). Não há inherit no nível empresarial — não existe um nível acima da empresa do qual herdar.

Resposta

Resposta Bem-Sucedida

default
EnterpriseSecurityProfileDefaultState · object
obrigatório

Visualização para leitura da vinculação do padrão da empresa.