Skip to main content
POST
Add a Hop

Authorizations

X-API-Key
string
header
required

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

Path Parameters

recipeId
string<uuid>
required

Recipe to add to

Body

application/json
name
string
required

Hop variety, e.g. "Citra"

Minimum string length: 1
amount_grams
number
required

Weight in grams

Required range: x >= 0
alpha_acid
number | null

Alpha acid percentage

time_minutes
number | null

Addition time in minutes

use
enum<string>
default:boil

When and how the hop is added

Available options:
boil,
dry_hop,
mash,
first_wort,
whirlpool,
aroma
sort_order
integer

Display order

Required range: x >= 0

Response

The created Hop

id
string<uuid>
read-only

Unique identifier

recipe_id
string<uuid>
read-only

Parent recipe

name
string

Hop variety

alpha_acid
number | null

Alpha acid percentage

amount_grams
number

Weight in grams

time_minutes
number | null

Addition time in minutes

use
enum<string>

When and how the hop is added

Available options:
boil,
dry_hop,
mash,
first_wort,
whirlpool,
aroma
sort_order
integer

Display order

created_at
string<date-time>
read-only

ISO 8601 timestamp