Saltar al contenido principal
PUT
Establecer las organizaciones de facturación de los usuarios
Establece la organización de facturación de hasta 100 usuarios en una sola solicitud. Solo se modifican los usuarios que envíes; el resto de la empresa no se ve afectado. Para actualizar los usuarios de uno en uno, el endpoint de configuración de usuario, en beta, también acepta billing_org_id.

Éxito parcial

Las asignaciones válidas se guardan en conjunto aunque otras filas de la misma solicitud no sean válidas, por lo que una respuesta 200 puede incluir fallos. Revisa siempre failed: cada entrada indica el usuario, la organización solicitada y un reason. La organización de facturación de esos usuarios no cambió; corrige las filas y vuelve a enviarlas. Es posible que se agreguen nuevos motivos con el tiempo, así que trata los valores desconocidos como un fallo y no como un error. Una respuesta de error (4xx o 5xx) significa que no se guardó nada de la solicitud. Las solicitudes sin asignaciones, con más de 100 asignaciones o con el mismo user_id repetido se rechazan con 422. Volver a enviar una asignación sobrescribe la organización de facturación actual del usuario y agrega otra entrada al registro de auditoría, por lo que repetir las llamadas es seguro, pero no gratuito.

Permisos

Requiere un usuario de servicio o un token de acceso personal con los permisos ManageBilling y ViewOrganizations a nivel empresarial. ManageOrganizations también cumple el requisito de ViewOrganizations, ya que lo incluye.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Cuerpo

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
requerido

Organización de facturación que se establecerá para cada usuario. Cada usuario solo puede aparecer una vez.

Required array length: 1 - 100 elements

Respuesta

Respuesta satisfactoria

assigned
UserBillingOrgAssignmentResponse · object[]
requerido

Asignaciones aplicadas.

failed
UserBillingOrgFailureResponse · object[]
requerido

Asignaciones omitidas, con sus motivos. Las organizaciones de facturación de estos usuarios no cambiaron.