---
title: "Add one or more recipes or foods to a meal plan"
method: POST
path: "/api/meal-plans/{id}/items"
tags: ["Meal Plans"]
---

# Add one or more recipes or foods to a meal plan

`POST /api/meal-plans/{id}/items`

## Request

- Base URL: `https://api.rewritelifestyle.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rewritelifestyle.ai/api/meal-plans/{id}/items`
- Auth: HTTP bearer

## Path parameters

- `id` number, required

## Request body

- AddMealPlanItemsDto
  - `items` MealPlanItemInputDto[], required
    - `source` 'recipe' | 'food', required
    - `name` string, required
    - `servingSize` string
    - `servings` number: How many servings to plan. Defaults to the recipe yield, or 1 for a food.
    - `recipeYield` number: Recipes: how many servings the ingredient list makes.
    - `ingredients` string[]: Recipes: ingredient lines for recipeYield servings.
    - `calories` number
    - `protein` number
    - `carbs` number
    - `fat` number
    - `fiber` number
    - `nutrition` NutritionEntryDto[]
    - `foodRef` object: Foods: search-result identity (foodId, servingId, quantity, unit) for reopening the log flow.

## Response `201`

## Changes

- **2026-10-01** `b32a266fe351`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/changes/api/meal-plans/:id/items/post.md)

---

[API](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api.md) - [All operations](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/revisions/28695827f27a?raw)