Pular para o conteúdo principal
PUT
Definir organizações de faturamento dos usuários
Define a organização de faturamento de até 100 usuários em uma única requisição. Somente os usuários enviados são alterados; o restante da empresa não é afetado. Para atualizar um usuário por vez, o endpoint de configurações de usuário, em beta, também aceita billing_org_id.

Sucesso parcial

As atribuições válidas são salvas em conjunto mesmo quando outras linhas da mesma requisição são inválidas, portanto uma resposta 200 pode incluir falhas. Sempre verifique failed: cada entrada identifica o usuário, a organização solicitada e um reason. As organizações de faturamento desses usuários não foram alteradas; corrija as linhas e envie-as novamente. Novos motivos podem ser adicionados com o tempo, portanto trate valores desconhecidos como uma falha, e não como um erro. Uma resposta de erro (4xx ou 5xx) significa que nada da requisição foi salvo. Requisições sem atribuições, com mais de 100 atribuições ou com o mesmo user_id repetido são rejeitadas com 422. Reenviar uma atribuição sobrescreve a organização de faturamento atual do usuário e grava outra entrada no registro de auditoria; por isso, chamadas repetidas são seguras, mas não deixam de ter efeitos.

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com as permissões ManageBilling e ViewOrganizations no nível empresarial. A permissão ManageOrganizations também atende ao requisito de ViewOrganizations, pois já a inclui.

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
obrigatório

Organização de faturamento a definir para cada usuário. Cada usuário só pode aparecer uma vez.

Required array length: 1 - 100 elements

Resposta

Resposta Bem-Sucedida

assigned
UserBillingOrgAssignmentResponse · object[]
obrigatório

Atribuições que foram aplicadas.

failed
UserBillingOrgFailureResponse · object[]
obrigatório

Atribuições que foram ignoradas, com o respectivo motivo. As organizações de faturamento desses usuários não foram alteradas.