# Brewgravity

> Recipe planner, brew day planner, and fermentation log for homebrewers.

- [Brewgravity](https://brewgravity.com/docs/index.md): Plan recipes, run brew days, and track fermentation.
- [Quickstart](https://brewgravity.com/docs/quickstart.md): From signing in to pitching yeast, in about ten minutes.
- [Core concepts](https://brewgravity.com/docs/concepts.md): The four things Brewgravity stores, and how they relate.
- [Recipes](https://brewgravity.com/docs/guides/recipes.md): Building and editing a recipe, and what the numbers mean.
- [Brew sessions](https://brewgravity.com/docs/guides/brew-sessions.md): Turning a recipe into a brew day you can actually work through.
- [Fermentation](https://brewgravity.com/docs/guides/fermentation.md): Logging readings and reading the curve.
- [Inventory](https://brewgravity.com/docs/guides/inventory.md): Knowing what you actually have before you plan what to brew.
- [AI assistant](https://brewgravity.com/docs/guides/ai-assistant.md): A brewing assistant that reads your actual recipes and proposes changes you approve.
- [Settings and account](https://brewgravity.com/docs/guides/settings.md): Units, display name, and how sign-in works.
- [Import overview](https://brewgravity.com/docs/import/overview.md): Bringing recipes into Brewgravity from other brewing software.
- [Importing from Brewer's Friend](https://brewgravity.com/docs/import/brewers-friend.md): Moving your recipe library over from Brewer's Friend, in bulk or one at a time.
- [Importing from other tools](https://brewgravity.com/docs/import/other-tools.md): Brewfather, BeerSmith, Brewtarget, and anything else that speaks BeerXML.
- [Exporting](https://brewgravity.com/docs/import/exporting.md): Getting your recipes back out, in a format something else can read.
- [Import troubleshooting](https://brewgravity.com/docs/import/troubleshooting.md): What the import errors mean and how to get past them.
- [API introduction](https://brewgravity.com/docs/api-reference/introduction.md): A small REST API over your recipes, brew sessions, fermentation logs, and inventory.
- [Authentication](https://brewgravity.com/docs/api-reference/authentication.md): API keys for scripts, session cookies for the app.
- [Errors and limits](https://brewgravity.com/docs/api-reference/errors.md): Status codes, error shapes, and what is rate limited.
- [MCP server](https://brewgravity.com/docs/api-reference/mcp.md): Give Claude — or any MCP client — direct access to your brewing data.
- [Get the current account](https://brewgravity.com/docs/api-reference/identity/get-the-current-account.md): Returns the account the credential belongs to. The quickest way to check that an API key works.
- [Health check](https://brewgravity.com/docs/api-reference/identity/health-check.md): Unauthenticated liveness probe.
- [List recipes](https://brewgravity.com/docs/api-reference/recipes/list-recipes.md): Every recipe on your account, most recently updated first. Ingredients are not included — fetch a single recipe for those.
- [Create a recipe](https://brewgravity.com/docs/api-reference/recipes/create-a-recipe.md): Creates an empty recipe. Add fermentables, hops, yeast, and mash steps with the endpoints below.
- [Get a recipe](https://brewgravity.com/docs/api-reference/recipes/get-a-recipe.md): The recipe with all of its ingredients and mash steps.
- [Delete a recipe](https://brewgravity.com/docs/api-reference/recipes/delete-a-recipe.md): Deletes the recipe, every ingredient belonging to it, and — by cascade — every brew session made from it, along with those sessions' checklists and fermentation logs.
- [Update a recipe](https://brewgravity.com/docs/api-reference/recipes/update-a-recipe.md): Partial update — send only the fields you are changing.
- [Get recipe stats](https://brewgravity.com/docs/api-reference/recipes/get-recipe-stats.md): OG, FG, ABV, IBU, SRM, attenuation, calories, and BU:GU, recalculated from the recipe's current ingredients. Nothing is cached.
- [Add a Fermentable](https://brewgravity.com/docs/api-reference/fermentables/add-a-fermentable.md): Appends a Fermentable to the recipe. Recipe stats change immediately.
- [Delete a Fermentable](https://brewgravity.com/docs/api-reference/fermentables/delete-a-fermentable.md): Removes the Fermentable from its recipe.
- [Update a Fermentable](https://brewgravity.com/docs/api-reference/fermentables/update-a-fermentable.md): Partial update — send only the fields you are changing.
- [Add a Hop](https://brewgravity.com/docs/api-reference/hops/add-a-hop.md): Appends a Hop to the recipe. Recipe stats change immediately.
- [Delete a Hop](https://brewgravity.com/docs/api-reference/hops/delete-a-hop.md): Removes the Hop from its recipe.
- [Update a Hop](https://brewgravity.com/docs/api-reference/hops/update-a-hop.md): Partial update — send only the fields you are changing.
- [Add a Yeast](https://brewgravity.com/docs/api-reference/yeasts/add-a-yeast.md): Appends a Yeast to the recipe. Recipe stats change immediately.
- [Delete a Yeast](https://brewgravity.com/docs/api-reference/yeasts/delete-a-yeast.md): Removes the Yeast from its recipe.
- [Update a Yeast](https://brewgravity.com/docs/api-reference/yeasts/update-a-yeast.md): Partial update — send only the fields you are changing.
- [Add a other ingredient](https://brewgravity.com/docs/api-reference/other-ingredients/add-a-other-ingredient.md): Appends a other ingredient to the recipe. Recipe stats change immediately.
- [Delete a other ingredient](https://brewgravity.com/docs/api-reference/other-ingredients/delete-a-other-ingredient.md): Removes the other ingredient from its recipe.
- [Update a other ingredient](https://brewgravity.com/docs/api-reference/other-ingredients/update-a-other-ingredient.md): Partial update — send only the fields you are changing.
- [Add a mash step](https://brewgravity.com/docs/api-reference/mash-steps/add-a-mash-step.md): Appends a mash step to the recipe. Recipe stats change immediately.
- [Delete a mash step](https://brewgravity.com/docs/api-reference/mash-steps/delete-a-mash-step.md): Removes the mash step from its recipe.
- [Update a mash step](https://brewgravity.com/docs/api-reference/mash-steps/update-a-mash-step.md): Partial update — send only the fields you are changing.
- [List brew sessions](https://brewgravity.com/docs/api-reference/brew-sessions/list-brew-sessions.md): Every brew session on your account, most recent brew date first. Steps are not included — fetch a single session for those.
- [Create a brew session](https://brewgravity.com/docs/api-reference/brew-sessions/create-a-brew-session.md): Starts a session against a recipe. Unlike the web app, this does not generate a brew day checklist — add steps yourself.
- [Get a brew session](https://brewgravity.com/docs/api-reference/brew-sessions/get-a-brew-session.md): The session with its full brew day checklist.
- [Delete a brew session](https://brewgravity.com/docs/api-reference/brew-sessions/delete-a-brew-session.md): Deletes the session along with its steps and fermentation logs. The recipe is untouched.
- [Update a brew session](https://brewgravity.com/docs/api-reference/brew-sessions/update-a-brew-session.md): Partial update. This is where you record measured OG and FG and move the session through its statuses.
- [Add a brew day step](https://brewgravity.com/docs/api-reference/brew-day-steps/add-a-brew-day-step.md): Appends a step to the session's checklist.
- [Delete a brew day step](https://brewgravity.com/docs/api-reference/brew-day-steps/delete-a-brew-day-step.md): Removes the step from its session.
- [Update a brew day step](https://brewgravity.com/docs/api-reference/brew-day-steps/update-a-brew-day-step.md): Partial update. Set `completed` to tick the step off; the completion timestamp is recorded for you.
- [List fermentation readings](https://brewgravity.com/docs/api-reference/fermentation-logs/list-fermentation-readings.md): Every reading for the session, oldest first.
- [Add a fermentation reading](https://brewgravity.com/docs/api-reference/fermentation-logs/add-a-fermentation-reading.md): Every field is optional — log whatever you actually measured. `gravity` is always specific gravity; use `gravity_unit` to record what the instrument read in.
- [Delete a fermentation reading](https://brewgravity.com/docs/api-reference/fermentation-logs/delete-a-fermentation-reading.md): Removes the reading.
- [Update a fermentation reading](https://brewgravity.com/docs/api-reference/fermentation-logs/update-a-fermentation-reading.md): Partial update. `created_at` is writable here, so a reading taken yesterday can be entered today at the right point on the curve.
- [List inventory](https://brewgravity.com/docs/api-reference/inventory/list-inventory.md): Every ingredient you have on hand, most recently updated first, optionally filtered to one category.
- [Add an inventory item](https://brewgravity.com/docs/api-reference/inventory/add-an-inventory-item.md): Amount units are free text and are never converted — record what is printed on the bag.
- [Get an inventory item](https://brewgravity.com/docs/api-reference/inventory/get-an-inventory-item.md): A single item.
- [Delete an inventory item](https://brewgravity.com/docs/api-reference/inventory/delete-an-inventory-item.md): Removes the item.
- [Update an inventory item](https://brewgravity.com/docs/api-reference/inventory/update-an-inventory-item.md): Partial update — typically to draw down `amount` after a brew day.
- [Generate a recipe preview](https://brewgravity.com/docs/api-reference/ai/generate-a-recipe-preview.md): A structured read of how a recipe will turn out: appearance, aroma, flavour, mouthfeel, style adherence, and specific observations.
- [Get today's AI usage](https://brewgravity.com/docs/api-reference/ai/get-todays-ai-usage.md): Messages and tokens used today against your daily budget. Both reset at midnight UTC.
- [List chat threads](https://brewgravity.com/docs/api-reference/chats/list-chat-threads.md): Your AI chat threads, optionally filtered to those started against one recipe.
- [Create a chat thread](https://brewgravity.com/docs/api-reference/chats/create-a-chat-thread.md): Starts an empty thread. The streaming turn endpoint creates one automatically if you do not, so this is rarely needed directly.
- [Get a chat thread](https://brewgravity.com/docs/api-reference/chats/get-a-chat-thread.md): The thread with its messages and attached context.
- [Delete a chat thread](https://brewgravity.com/docs/api-reference/chats/delete-a-chat-thread.md): Deletes the thread and its messages.
- [Rename a chat thread](https://brewgravity.com/docs/api-reference/chats/rename-a-chat-thread.md): Sets the thread's title.

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)