PUT
/
v1
/
locations
/
:id
curl --location --request PUT 'https://api.stateset.com/v1/locations/loc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "contact": {
        "name": "Jane Doe",
        "email": "jane.doe@warehouse.com",
        "phone": "+1-555-987-6543"
    },
    "capabilities": ["storage", "fulfillment", "returns", "pickup"]
}'
{
  "id": "loc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "location",
  "updated_at": "2024-01-20T13:00:00Z",
  "name": "West Coast Distribution Center",
  "code": "WH-WEST-01",
  "contact": {
    "name": "Jane Doe",
    "email": "jane.doe@warehouse.com",
    "phone": "+1-555-987-6543"
  },
  "capabilities": ["storage", "fulfillment", "returns", "pickup"],
  "status": "active"
}
This endpoint updates location details including contact information, operating hours, and capabilities.

Authentication

This endpoint requires a valid API key with locations:write permissions.
Authorization: Bearer YOUR_API_KEY

Path Parameters

id
string
required
The unique identifier of the location

Request Body

name
string
Update location name
contact
object
Update contact information
operating_hours
object
Update operating hours
capabilities
array
Update location capabilities
capacity
object
Update capacity information
is_active
boolean
Update active status
metadata
object
Update custom fields

Response

Returns the updated location object.
curl --location --request PUT 'https://api.stateset.com/v1/locations/loc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "contact": {
        "name": "Jane Doe",
        "email": "jane.doe@warehouse.com",
        "phone": "+1-555-987-6543"
    },
    "capabilities": ["storage", "fulfillment", "returns", "pickup"]
}'
{
  "id": "loc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "location",
  "updated_at": "2024-01-20T13:00:00Z",
  "name": "West Coast Distribution Center",
  "code": "WH-WEST-01",
  "contact": {
    "name": "Jane Doe",
    "email": "jane.doe@warehouse.com",
    "phone": "+1-555-987-6543"
  },
  "capabilities": ["storage", "fulfillment", "returns", "pickup"],
  "status": "active"
}