Brew again, new version or copy as new recipe
Start a new brew from an existing one. mode "brew_again" (default): the next batch of the same recipe version, status planned with a new batch number. "new_version": the next version of the recipe (v2, v3, ...) as an idea, to change with update_recipe; version_notes says what changes. "new_recipe": an independent copy under a new name (no version link). It copies the brew as it is now (including earlier update_recipe changes). from accepts a brew (id, batch number) or a recipe (name, recipe id; its newest brew is copied). Pass planned_date to plan the new brew right away. Fails with LIMIT_REACHED when the free plan's brew limit is full. Scope: `brews:write` (or `write`).
Start a new brew from an existing one. mode "brew_again" (default): the next batch of the same recipe version, status planned with a new batch number. "new_version": the next version of the recipe (v2, v3, ...) as an idea, to change with update_recipe; version_notes says what changes. "new_recipe": an independent copy under a new name (no version link). It copies the brew as it is now (including earlier update_recipe changes). from accepts a brew (id, batch number) or a recipe (name, recipe id; its newest brew is copied). Pass planned_date to plan the new brew right away. Fails with LIMIT_REACHED when the free plan's brew limit is full.
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 or recipe to copy: a brew id or batch number (e.g. "#12"), or a recipe name or id (e.g. "Citra Pale Ale"; its newest brew is used).
"brew_again" (default), "new_version" or "new_recipe".
"brew_again" | "new_version" | "new_recipe"Name of the copy. Required for new_recipe unless " (copy)" is fine.
1 <= length <= 200new_version: what changes in this version, e.g. "More late hops, less crystal".
length <= 2000Planned brew day of the new brew (YYYY-MM-DD, e.g. "2026-11-21").
^\d{4}-\d{2}-\d{2}$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/copy_brew" \ -H "Content-Type: application/json" \ -d '{ "from": "string" }'{
"brew": {
"id": "string",
"name": "string",
"batch_number": 0,
"status": "idea",
"recipe_id": "string",
"version": "string",
"planned_date": "string",
"brew_date": "string",
"ready_by_date": "string"
},
"copied_from": {
"id": "string",
"name": "string",
"batch_number": 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": {}
}
}