Skip to navigation

Update Location Operating Hours

View as Markdown

Updates a location’s opening hours, pickup hours, pickup windows and special hours. Send only the fields you want to change. A change publishes a LOCATION_OPERATING_HOURS_CHANGED event.


Endpoint

PATCH {{domain}}/stores/{{tenant_id}}/operating-hours

Authentication: Bearer token required via the Authorization header. The caller needs the update-store-operating-hours permission.


Request Payload

PATCH /stores/{{tenant_id}}/operating-hours
{
"opening_hours": [
{ "day": 1, "from": "09:00", "to": "17:00", "buffer_minutes": 10 }
],
"pickup_hours": [
{ "day": 1, "from": "09:00", "to": "15:00" }
],
"special_hours": []
}

Parameters

All fields are optional. Include only the fields you want to change.

FieldTypeDescription
opening_hoursArrayOptional. When the store is open to customers, by day. Same shape as Create a Location.
pickup_hoursArrayOptional. When couriers can collect orders, by day. Same shape as Create a Location.
pickup_windowsArrayOptional. Pickup windows for the location.
special_hoursArrayOptional. Override hours for specific dates, such as public holidays.

Validation rules

  • day must be between 0 (Sunday) and 6 (Saturday).
  • to must not be earlier than from.
  • buffer_minutes must be at least 1.

Response

A successful request returns 200 OK with the updated location.

200 OK
{
"data": { }
}
FieldTypeDescription
dataObjectThe updated location.