---
title: "Add Bottle"
method: POST
path: "/cellars/{cellar_id}/bottles"
tags: ["bottles"]
---

# Add Bottle

`POST /cellars/{cellar_id}/bottles`

## Request

- Base URL: `https://api.emile.wine` (the document declares no server; this is the origin it was published from)
- URL: `https://api.emile.wine/cellars/{cellar_id}/bottles`
- Auth: HTTP bearer

Create individual bottle rows. quantity=N creates N rows (1 per physical bottle).
Returns a list of created bottles.

## Path parameters

- `cellar_id` string, required

## Headers

- `X-API-Key` string, nullable

## Request body

- BottleCreate
  - `wine_reference_id` string, nullable
  - `vintage` integer, nullable
  - `quantity` integer
  - `location_text` string, nullable
  - `location_photo_url` string, nullable
  - `purchase_price` number, nullable
  - `notes` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/emile/apis/emile-api.md) · [All operations](https://skmtc.dev/emile/apis/emile-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emile/apis/emile-api/revisions/eb2d1d1db972?raw)