List the user's recipe book (own + saved + queued + friend recipes). Caps at ~500 entries.

Get a single recipe by id, including directions, ingredients, tags, prep_notes, comments.

Create a new recipe. Only title is required. Ingredients are an array of {title, amount, unit, note, position}.

Update an existing recipe. Pass only the fields you want to change. To remove an ingredient include {id, _destroy: true} in ingredients.

Delete a recipe by id.

List all courses (Appetizers, Main Course, etc.).

List all cuisines.

List all main-ingredient categories.

List all tags.

List all planner (calendar) events. Each entry: { date, recipe_id, section, servings, ... }.

Fetch all planner events between start_date and end_date (inclusive, YYYY-MM-DD). end_date defaults to start_date + 6 days. Recipe events are enriched with recipe_title.

Find planner events for a given recipe, optionally constrained to a date range. Useful for "is this recipe already planned this week?" checks before scheduling.

Add a recipe to a meal slot on the planner. Returns the newly created event (id, date, section, servings, ...).

Add a freeform "ingredient" entry to a meal slot (e.g. "2 lbs ground beef" attached to Wednesday dinner).

Add a freeform "note" entry to a meal slot (e.g. "Defrost chicken" on Tuesday breakfast).

Schedule a leftover meal derived from a previously planned recipe event. Duplicates the source event with plan_leftover=true and optionally moves the duplicate to a different date/section. Returns the new event.

Move an existing planner event to a different date and/or section. Works for recipe, note, and ingredient events.

Reorder events within a section. Pass event_ids in the desired order. All events should belong to the same date+section for the reorder to be meaningful.

Update the text of a note or ingredient planner entry. Note: uses the description field on the wire even though entries are created with title.

Set the servings count on a recipe planner event.

Duplicate a planner event. Set plan_leftover=true to mark the copy as a leftover.

Delete a planner event by id.

Update planner display/behaviour preferences (time_zone, planner_start_day, calendar_settings.show_calories, etc). Use Rails-style nested keys like user[time_zone] or calendar_settings[show_calories]. Rarely needed.

List what's in the freezer. Each entry: { id, recipe_id, count, servings, frozen_on }. By default only returns active entries (count > 0); pass include_consumed=true to also see history (the API soft-deletes by zeroing the count rather than removing the row).

Mark N portions of a previously cooked recipe as frozen. event_id ties the frozen entry back to the planner event the portions came from.

Mark a frozen entry as consumed (the portion was eaten or thrown out). Soft-delete: API sets count to 0; the entry persists as history.

List saved menus.

Get the current shopping list with sync metadata.

List friends.

Get recipe-book counts: { friends, queued, frozen }.