Pular para o conteúdo principal
PATCH
Atualizar usuário de serviço

Permissões

Requer um usuário de serviço ou token de acesso pessoal com a permissão ManageAccountMembership no nível de Enterprise.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

service_user_id
string
obrigatório

ID do usuário de serviço (prefixo: service-user-)

Exemplo:

"service-user-abc123def456"

Corpo

application/json
role_id
string | null

Função a atribuir ao usuário de serviço neste escopo.

preferences
ServiceUserPreferences · object | null

Opções a alterar; campos omitidos mantêm seu valor. As preferências de um usuário de serviço se aplicam a toda a empresa.

Resposta

Resposta bem-sucedida

service_user_id
string
obrigatório
name
string
obrigatório
expires_at
integer | null
obrigatório
deleted_at
integer | null
obrigatório
role_assignments
RoleAssignment · object[]
obrigatório
preferences
ServiceUserPreferences · object
obrigatório

Opções por usuário de serviço; um campo deixado como null usa o valor padrão.