---
title: "Batch-create bottles (text mode)"
method: POST
path: "/me/bottles:batch"
tags: ["Bottles"]
---

# Batch-create bottles (text mode)

`POST /me/bottles:batch`

## 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/me/bottles:batch`
- Auth: HTTP bearer

Creates up to 100 bottles in one call.  Each bottle is processed
independently — partial success is supported.

**Rate limit**: 10/hour, 50/day.

**Returns**: per-bottle status.  Each entry is `{"status": "created", "id": "..."}` or
`{"status": "error", "error": "..."}`.  Aggregate counts in `created` and `errored`.

## Headers

- `X-API-Key` string, nullable

## Request body

- BatchBottlesRequest
  - `bottles` BottleSpec[], required
    - `cellar_id` string, uuid, required
    - `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 `200`

Successful Response

- object

## 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)