Update supplier (partial update)
PATCH/v1/suppliers/:supplierId
Partially updates a supplier in the authenticated user's organization. All fields are optional. Fields can be updated, cleared (set to null), or left unchanged (not provided).
Update behavior:
- Field not provided = no change to existing value
- Field set to null = clear the field value
- Field set to value = update to new value
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
- 502
- 503
- 504
Supplier updated successfully
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Bad request (e.g., invalid data format, empty update request, missing required fields based on accounting integration)
Unauthorized
Forbidden (e.g., user has no organizations, insufficient scope privileges)
Supplier not found in organization
Conflict - update would create duplicate supplier number or violates accounting integration immutability rules
Unprocessable entity - a referenced entity (expense account, cost carrier, payment term, VAT rate, or team) does not exist or is not active
Rate limit exceeded. Reduce request frequency and retry after the indicated number of seconds.
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Number of seconds to wait before retrying. Only present on 429 Too Many Requests responses.
Internal server error
Bad gateway. An upstream service could not be reached.
Service temporarily unavailable. An upstream service returned a 503 error.
Gateway timeout. An upstream service did not respond in time.