Fill in a BJCP or Lagerbernd scoresheet
Start or fill in a full tasting scoresheet for a brew. BJCP (default): section scores (aroma 0-12, appearance 0-3, flavor 0-20, mouthfeel 0-5, overall 0-10; total out of 50), comments per section and off-flavors. Lagerbernd (sheet: "lagerbernd"): nine-step scales in ratings (total out of 60, German school grade), intensities and notes. Without evaluation_id it creates a new sheet with what you send; with evaluation_id (from list_evaluations) it updates only the fields you send. Returns the total score. For a quick star rating use rate_brew. Needs a plan with evaluations (Pro). Needs the plan feature `bjcp_evaluations`. Scope: `brews:write` (or `write`).
Start or fill in a full tasting scoresheet for a brew. BJCP (default): section scores (aroma 0-12, appearance 0-3, flavor 0-20, mouthfeel 0-5, overall 0-10; total out of 50), comments per section and off-flavors. Lagerbernd (sheet: "lagerbernd"): nine-step scales in ratings (total out of 60, German school grade), intensities and notes. Without evaluation_id it creates a new sheet with what you send; with evaluation_id (from list_evaluations) it updates only the fields you send. Returns the total score. For a quick star rating use rate_brew. Needs a plan with evaluations (Pro).
Needs the plan feature bjcp_evaluations. Scope: brews:write (or write).
API token in format: bfk_. Each operation lists the token scope it requires (the scopes are listed below).
read: Read everything (all areas)write: Create, change and delete everything (all areas)brews:read: List and view brewsbrews:write: Create, update, delete brews and notesinventory:read: List inventory itemsinventory:write: Create, update, delete inventory itemsequipment:read: List equipment profilesequipment:write: Create, update, delete equipment profilesstyles:read: List style profilesstyles:write: Create, update, delete style profilesprofiles:read: List mash, fermentation, and water profilescustom-fields:read: List custom field definitionscustom-fields:write: Create, update, delete custom field definitionsprofiles:write: Create, update, delete mash, fermentation, and water profilescellar:read: View cellar, packaged stock, tap lists, and labelscellar:write: Manage cellar, packaging, stock, tap lists, and labelssettings:read: View preferences, imports, calculators, and your data exportsettings:write: Change preferences and undo importscommunity:read: View community, feedback, tickets, inbox, and account overviewcommunity:write: Post, vote, and reply in community, feedback, and tickets
In: header
Scope: brews:write
Request Body
application/json
The brew: its id, its batch number (e.g. 12 or "#12") or its exact name (e.g. "Citra Pale Ale"). Case does not matter.
Kind of a new scoresheet: "bjcp" (default; 50 points) or "lagerbernd" (60 points, nine-step scales). Ignored with evaluation_id.
"bjcp" | "lagerbernd"Id of the evaluation, from list_evaluations. Updates that sheet instead of starting a new one.
Who tasted, e.g. "Anna". Default: empty (you).
length <= 80Tasting date, YYYY-MM-DD. Default: today for a new sheet.
dateBJCP aroma score, 0-12.
0 <= value <= 12BJCP appearance score, 0-3.
0 <= value <= 3BJCP flavor score, 0-20.
0 <= value <= 20BJCP mouthfeel score, 0-5.
0 <= value <= 5BJCP overall impression score, 0-10.
0 <= value <= 10BJCP aroma comments.
length <= 2000BJCP appearance comments.
length <= 2000BJCP flavor comments.
length <= 2000BJCP mouthfeel comments.
length <= 2000BJCP overall impression comments.
length <= 2000BJCP off-flavors found (replaces the list), e.g. [{"name": "Diacetyl", "intensity": "low"}].
Lagerbernd ratings, position 1-9 per scale. Fit scales (color, clarity, aroma, body, carbonation, maltiness, bitterness, hoppiness): 5 = just right, 1 too little, 9 too much. Quality (head_retention, head_texture, aromas, malt_character, hop_character, yeast_profile, balance, drinkability): 9 = best. Deductions (off_flavors, bitterness_quality): 9 = clean, 1 = severe.
Lagerbernd descriptive intensities (not scored), 1 = low … 9 = high, per scale.
Lagerbernd free-text descriptors, e.g. {"aromas": "bready, floral", "overall": "Clean and crisp"}.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://brewforge.sh/api/v1/actions/save_scoresheet" \ -H "Content-Type: application/json" \ -d '{ "brew": "string" }'{
"brew": {
"id": "string",
"name": "string",
"status": "string",
"batch_number": 0
},
"evaluation": {
"id": "string",
"kind": "rating",
"by": "string",
"date": "string",
"stars": 0,
"score": 0,
"max_score": 0,
"verdict": "string",
"submitted": true,
"comment": "string"
},
"created": true,
"unrated_scales": [
"string"
]
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}