> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/ko/developers/api/reference/locations.md).

# Locations

> Locations where inventory is stored.

A location must exist before it can be referenced by a transaction.

## Location 객체

An inventory storage location. Locations are referenced by every transaction; create one before recording stock movements.

- `id` (integer, minimum 0, maximum 2147483647, 필수): Location id.
- `name` (string, 필수): Location display name. Unique within the team.
- `quantity` (number, 필수): Total on-hand quantity at this location, summed across every item in the team.
- `memo` (string, 필수): Free-text memo for this location. Empty string when not set.

예시

```json
{
  "id": 47041,
  "name": "Warehouse",
  "quantity": 9923,
  "memo": ""
}
```

## 엔드포인트

- [List locations](https://www.boxhero.io/docs/ko/developers/api/reference/locations/list-locations) `GET /v1/locations`
- [Create a location](https://www.boxhero.io/docs/ko/developers/api/reference/locations/create-location) `POST /v1/locations`
- [Get a location](https://www.boxhero.io/docs/ko/developers/api/reference/locations/get-location) `GET /v1/locations/{location_id}`
- [Update a location](https://www.boxhero.io/docs/ko/developers/api/reference/locations/update-location) `PUT /v1/locations/{location_id}`
- [Delete a location](https://www.boxhero.io/docs/ko/developers/api/reference/locations/delete-location) `DELETE /v1/locations/{location_id}`