---
title: "create bottle"
method: POST
path: "/cellar/accounts/{accountID}/bottles"
tags: ["bottle"]
---

# create bottle

`POST /cellar/accounts/{accountID}/bottles`

## Request

- Base URL: `http://localhost:8081`
- URL: `http://localhost:8081/cellar/accounts/{accountID}/bottles`
- Auth: none declared

Record new bottle

## Path parameters

- `accountID` integer, required

## Request body

- CreateBottlePayload
  - `color` 'red' | 'white' | 'rose' | 'yellow' | 'sparkling', required
  - `country` string
  - `name` string, required
  - `region` string
  - `review` string
  - `sweetness` integer
  - `varietal` string, required
  - `vineyard` string, required
  - `vintage` integer, required

## Response `201`

Resource created

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2016-09-06** `8088021c4e6c`: 1 info
  - endpoint added
- **2016-07-29** `8f876193ca58`: 1 breaking
  - api path removed without deprecation
- **2016-07-28** `748422eb22fb`: 1 info
  - added the non-success response with the status `400`
- **2016-07-07** `f95e907821c4`: 1 info
  - api tag `bottle` added
- **2016-06-16** `8b23e409bd8f`: 1 info
  - added the non-success response with the status `404`

[Operation history](https://skmtc.dev/goadesign/apis/the-virtual-wine-cellar/changes/cellar/accounts/:accountID/bottles/post.md)

---

[API](https://skmtc.dev/goadesign/apis/the-virtual-wine-cellar.md) - [All operations](https://skmtc.dev/goadesign/apis/the-virtual-wine-cellar/llms.txt) - [OpenAPI document](https://skmtc.dev/goadesign/apis/the-virtual-wine-cellar/revisions/348fc24f05fe?raw)