---
title: "Update bookable area order"
method: PUT
path: "/shop/bookable-areas/order"
tags: ["BookableAreas"]
---

# Update bookable area order

`PUT /shop/bookable-areas/order`

Replaces the display order of the site's `BookableArea`s. The
order of `area_ids` in the body is the new order — element 0
becomes `order=0`, element 1 becomes `order=1`, and so on.

Requires the `SETTINGS_MANAGE` permission on the site.

## Request body

- object
  - `area_ids` string[], required — Ordered list of bookable area IDs. Element 0 becomes the first-displayed area.
  - `site_id` string, uuid, required — ID of the site whose area order is being updated. The caller's API key must have access to this site.

## Response `200`

The site's bookable areas in display order. Pair with
`PUT /shop/bookable-areas/order` to power a drag-and-drop UI.

- object
  - `data` BookableAreaSummary[], required — The bookable areas in their current display order.
    - `id` string, mongo-id, required — The ID of the bookable area.
    - `name` string, required — The name of the bookable area.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `422` — The request didn't pass validation

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)