update
PATCH
/api/v1/accounts/:account_id/locations/:id
Update a location
Updates an existing location. If the address is changed, it will be re-geocoded automatically.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id
|
Must be a Integer | Required |
Parent store ID |
id
|
Must be a Integer | Required |
Location ID |
location
|
Must be a Hash | Required |
Location attributes |
location[name]
|
Must be a String | Optional |
Location name |
location[address]
|
Must be a String | Optional |
Full street address – automatically geocoded to lat/lng |
Error Codes
| Code | Description |
|---|---|
401
|
Unauthorized – invalid or missing API token |
404
|
Location not found |
422
|
Validation failed – check the `errors` object for details |
Returns
Code: 200
The updated location object
| Name | Type | Required | Description |
|---|---|---|---|
id
|
Must be a Integer | Required |
Unique location ID |
account_id
|
Must be a Integer | Required |
Parent store ID |
name
|
Must be a String | Required |
Location name (e.g. ‘Downtown Branch’) |
address
|
Must be a String | Required |
Full street address |
latitude
|
Must be a Float | Required |
Geocoded latitude (auto-derived from address) (nil allowed) |
longitude
|
Must be a Float | Required |
Geocoded longitude (auto-derived from address) (nil allowed) |
created_at
|
Must be a String | Required |
ISO 8601 creation timestamp |
updated_at
|
Must be a String | Required |
ISO 8601 last-update timestamp |