Merchant Nexus

Update Nexus Location

<span class="plan-badge plan-badge--pro">Available on Pro and Enterprise Plans</span> Replaces a recorded location. The `location` block is a full replacement, not a patch: every field in it is written, so send the current value for anything you do not want cleared. The address is geocoded again, so an update may change the normalized address even when you send the same string, and a location can be moved to a different state this way. Available to self-managed merchants only; a TaxCloud-connected merchant returns 403.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
locationobjectRequired
The location's new contents. Every field is replaced, so send the current value for anything you do not want to clear.
locationIdstringRequired

Identifier of the location to replace, as returned by /merchant/nexus/create or /merchant/nexus/list. A location that has been deleted returns 404.

merchantIdstringRequired

UUID of the merchant that owns the location. Must be owned by the calling account and must be self-managed.

Response

OK
locationobject
The stored location after the update, with its normalized address.
merchantIdstring
UUID of the merchant the location belongs to.

Errors

400
Merchant Nexus Update Body Bad Request Error
401
Merchant Nexus Update Body Unauthorized Error
403
Merchant Nexus Update Body Forbidden Error
404
Merchant Nexus Update Body Not Found Error
422
Merchant Nexus Update Body Unprocessable Entity Error
429
Merchant Nexus Update Body Too Many Requests Error
500
Merchant Nexus Update Body Internal Server Error
503
Merchant Nexus Update Body Service Unavailable Error