> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Order settings

> Configure preparation time and concurrent customer orders.

Order settings control how a location handles incoming orders.

| Action | Endpoint                                           | Permission            |
| ------ | -------------------------------------------------- | --------------------- |
| Read   | `GET /v1/locations/{location_id}/order_settings`   | `orderSettings.read`  |
| Update | `PATCH /v1/locations/{location_id}/order_settings` | `orderSettings.write` |

## Fields

| Field                                | Type    | Meaning                                                         |
| ------------------------------------ | ------- | --------------------------------------------------------------- |
| `average_preparation_time`           | string  | Expected preparation duration in `HH:MM` format.                |
| `enable_multiple_order_per_customer` | boolean | Allow one customer to have multiple open orders simultaneously. |

## Read the current settings

```bash theme={null}
curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz/order_settings \
  -H "x-api-key: $CHATAIGNE_API_KEY"
```

## Update selected fields

`PATCH` preserves omitted fields. This request sets the average preparation time to 25 minutes without changing the multiple-order setting:

```bash theme={null}
curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz/order_settings \
  -X PATCH \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "average_preparation_time": "00:25"
  }'
```

The response contains the complete updated `order_settings` object.

<Note>
  Order settings and the live order-acceptance state are separate. Use [Order acceptance](/location-organization-management/acceptance-settings) to temporarily mark a location busy or paused.
</Note>