Log a fermentation reading
Add a fermentation reading (gravity, temperature, pH, pressure and/or a comment) to a brew, as from a hydrometer or refractometer check. Gravity defaults to SG (send gravity_unit "plato" for °P), temperature to °C. Stored in canonical units (SG, °C, psi); it shows up in the brew's fermentation chart. Several readings at once: send readings: [{gravity, temp, at}, ...] instead of the single fields. To correct a reading, send reading_id (ids come from get_fermentation) with only the fields to change; null clears a field. The final gravity of a finished beer is recorded with record_brew_measurements (fg). Reference the brew by id, batch number or exact name. Scope: `brews:write` (or `write`).
Add a fermentation reading (gravity, temperature, pH, pressure and/or a comment) to a brew, as from a hydrometer or refractometer check. Gravity defaults to SG (send gravity_unit "plato" for °P), temperature to °C. Stored in canonical units (SG, °C, psi); it shows up in the brew's fermentation chart. Several readings at once: send readings: [{gravity, temp, at}, ...] instead of the single fields. To correct a reading, send reading_id (ids come from get_fermentation) with only the fields to change; null clears a field. The final gravity of a finished beer is recorded with record_brew_measurements (fg). Reference the brew by id, batch number or exact name.
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.
Measured gravity, e.g. 1.012 (SG) or 3.1 (with gravity_unit "plato").
Beer temperature, e.g. 19.5 (°C) or 67 (with temp_unit "f").
pH, e.g. 4.3.
Head pressure, e.g. 12 (psi) or 0.8 (with pressure_unit "bar").
Free text, e.g. "krausen dropped".
When it was measured, ISO 8601 with time zone, e.g. 2026-11-11T08:30:00+01:00 (use Z for UTC when the user's zone is unknown). Default: now.
date-timeSeveral readings at once (up to 500), each with gravity/temp/ph/pressure/comment/at. Units apply to all of them.
1 <= items <= 500Id of an existing reading to correct instead of adding a new one.
Unit of the gravity values you send: "sg" (specific gravity, e.g. 1.012; default) or "plato" (°P, e.g. 3.1).
"sg" | "plato"Unit of the temperatures you send: "c" (°C, default) or "f" (°F).
"c" | "f"Unit of pressure: "psi" (default) or "bar".
"psi" | "bar"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/log_fermentation_reading" \ -H "Content-Type: application/json" \ -d '{ "brew": "string" }'{
"brew": {
"id": "string",
"name": "string",
"status": "string"
},
"reading": {
"id": "string",
"at": "string",
"gravity_sg": 0,
"gravity_plato": 0,
"temp_c": 0,
"ph": 0,
"pressure_psi": 0,
"comment": "string"
},
"readings": [
{
"id": "string",
"at": "string",
"gravity_sg": 0,
"gravity_plato": 0,
"temp_c": 0,
"ph": 0,
"pressure_psi": 0,
"comment": "string"
}
],
"readings_count": 0
}{
"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": {}
}
}