Crear o actualizar empresa
PUT/v1/companies
Recibe el mismo cuerpo del POST, más id y public_id, y deduplica por id, public_id, external_id y las claves naturales del recurso, en ese orden, deteniéndose en la primera que encuentre un registro. Si lo encuentra, lo actualiza y responde 200; si no, lo crea y responde 201. Los campos obligatorios del POST solo se exigen cuando no se encuentra ningún registro, y la actualización es parcial.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Registro actualizado.
Registro creado.
El cuerpo de la solicitud falló en la validación.
Token bearer ausente o inválido.
Token válido, pero sin permiso para esta operación. Con code insufficient_scope, details.required trae el único conjunto mínimo de scopes que, sumados a details.granted, dejaría pasar la solicitud: el scope del recurso (billing/{recurso}, o billing/all fuera del catálogo) y luego el verbo simple — por ejemplo ["billing/customers", "delete"].
Recurso no encontrado en la organización actual.
El cuerpo de la solicitud falló en la validación.
Límite de solicitudes excedido.
Error inesperado en el servidor.