Export a brew (BeerXML, JSON, PDF sheets)
Export one brew. "beerxml" (recipe for other brewing software) and "json" (everything BrewForge stores, incl. measurements and readings) return the file text in content. The printable sheets "recipe_pdf", "brewday_pdf" (brew-day checklist) and "fermentation_pdf" (log sheet) return a download_url that works without login for 15 minutes; give it to the user, don't fetch it yourself unless you need the PDF bytes. Scope: `brews:read` (or `read`).
Export one brew. "beerxml" (recipe for other brewing software) and "json" (everything BrewForge stores, incl. measurements and readings) return the file text in content. The printable sheets "recipe_pdf", "brewday_pdf" (brew-day checklist) and "fermentation_pdf" (log sheet) return a download_url that works without login for 15 minutes; give it to the user, don't fetch it yourself unless you need the PDF bytes.
Scope: brews:read (or read).
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:read
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.
"beerxml", "json", "recipe_pdf", "brewday_pdf" or "fermentation_pdf".
"beerxml" | "json" | "recipe_pdf" | "brewday_pdf" | "fermentation_pdf"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/export_brew" \ -H "Content-Type: application/json" \ -d '{ "brew": "string", "format": "beerxml" }'{
"brew": {
"id": "string",
"name": "string"
},
"format": "beerxml",
"filename": "string",
"content": "string",
"download_url": "string",
"expires_at": "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": {}
}
}