Skip to main content
PATCH
Update a Hop

Authorizations

X-API-Key
string
header
required

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

Path Parameters

id
string<uuid>
required

Hop id

Body

application/json
name
string

Hop variety, e.g. "Citra"

Minimum string length: 1
alpha_acid
number | null

Alpha acid percentage

amount_grams
number

Weight in grams

Required range: x >= 0
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 updated 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