Skip to main content
POST
Create a brew session

Authorizations

X-API-Key
string
header
required

An API key created from a signed-in session. See Authentication.

Body

application/json
recipe_id
string<uuid>
required

Recipe this session is brewing

name
string | null

Session name, e.g. "Brew: House IPA"

status
enum<string>
default:planning

Current status

Available options:
planning,
brewing,
fermenting,
complete
brew_date
string | null

Brew date (YYYY-MM-DD)

notes
string | null

Session notes

actual_og
number | null

Measured original gravity

actual_fg
number | null

Measured final gravity

fermenting_since
string | null

ISO timestamp when fermentation started

completed_at
string | null

ISO timestamp when the session completed

Response

The created session

id
string<uuid>
read-only

Unique identifier

user_id
string
read-only

Owning account

recipe_id
string<uuid>

Recipe being brewed

name
string | null

Session name

status
enum<string>

Current status

Available options:
planning,
brewing,
fermenting,
complete
brew_date
string | null

Brew date (YYYY-MM-DD)

notes
string | null

Session notes

actual_og
number | null

Measured original gravity

actual_fg
number | null

Measured final gravity

fermenting_since
string | null

When fermentation started

completed_at
string | null

When the session completed

created_at
string<date-time>
read-only

ISO 8601 timestamp

updated_at
string<date-time>
read-only

ISO 8601 timestamp