Create or update a withholding
PUT/v1/withholdings
Looks the withholding up by id, public_id or external_id. If it is not found, creates it from the full body and returns 201. If it is found, only competence_month, competence_year, metadata, external_id and custom_metadata are applied: base, rate, amount and withholder_id are immutable once recorded and are ignored in the update body.
Request​
Responses​
- 200
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Record updated.
Record created.
Request body failed validation.
Missing or invalid bearer token.
Token is valid but lacks permission for this operation. With code insufficient_scope, details.required carries the one minimal set of scopes that, added to details.granted, would let the request through: the resource scope (billing/{resource}, or billing/all off the catalogue) then the bare verb — e.g. ["billing/customers", "delete"].
Resource not found in the current organization.
Request body failed validation.
Rate limit exceeded.
Unexpected server error.