Update customer address

Update an existing address with partial data. Only provided fields will be updated.

Partial Updates: This endpoint supports partial updates - only include fields you want to change. Omitted fields will retain their current values.

Default Flag Behavior:

• Setting is_default_billing: true will unset the flag on all other addresses
• Setting is_default_shipping: true will unset the flag on all other addresses
• Only one address can be default billing and one can be default shipping at a time

Duplicate Prevention: If updating address fields would result in a duplicate of another existing address, the update will be rejected with a DUPLICATE_ADDRESS error. This ensures data integrity and prevents confusion in downstream systems.

Validation Status: When address fields are modified, the validation_status may need to be re-verified through tax calculation services.