Crea o actualiza una retención
PUT/v1/withholdings
Localiza la retención por id, public_id o external_id. Si no la encuentra, la crea con el cuerpo completo y devuelve 201. Si la encuentra, solo aplica competence_month, competence_year, metadata, external_id y custom_metadata: base, rate, amount y withholder_id son inmutables tras el registro y se ignoran en el cuerpo de actualización.
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.