PUT
Edit a customer address
Company space For: Cashier and seller, Manager · Permission: customer_addresses.update Conditions
  • The label must stay unique among the addresses of this customer.
Part of Manage customers.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customer
string
required

Identifier of the customer (27-character KSUID string).

address
string
required

Identifier of the customer address (27-character KSUID string).

Query Parameters

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none,
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, customer_id, label, address, city, phone_number, latitude, longitude, created_at, updated_at.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .

Body

application/json
label
string
required

Short name of the address. Required when creating, up to 255 characters, and unique among the addresses of the same customer.

Maximum string length: 255
address
string
required

Free-text address, up to 1000 characters. Required when creating.

Maximum string length: 1000
city
string | null

City, up to 255 characters. Optional; null clears it on update.

Maximum string length: 255
phone_number
string | null

Contact phone number for this address, up to 30 characters. Optional; null clears it on update.

Maximum string length: 30
latitude
number | null

Latitude in decimal degrees, between -90 and 90. Optional; null clears it on update.

Required range: -90 <= x <= 90
longitude
number | null

Longitude in decimal degrees, between -180 and 180. Optional; null clears it on update.

Required range: -180 <= x <= 180

Response

Resource (only with response=resource).

id

Identifier of the address (27-character KSUID string).

customer_id

Identifier of the customer the address belongs to (27-character KSUID string).

label

Short name of the address, unique among the addresses of the same customer.

address

Free-text address.

city

City, or null when none was given.

phone_number

Contact phone number for this address, or null when none was given.

latitude

Latitude in decimal degrees, between -90 and 90, with up to 7 decimals. Returned as a decimal string. Null when none was given.

longitude

Longitude in decimal degrees, between -180 and 180, with up to 7 decimals. Returned as a decimal string. Null when none was given.

created_at

Date and time the record was created (ISO 8601, UTC).

updated_at

Date and time the record was last changed (ISO 8601, UTC).