---
title: "Schedule a meal for a future day"
method: POST
path: "/api/planned-meals"
tags: ["Scheduled Meals"]
---

# Schedule a meal for a future day

`POST /api/planned-meals`

## 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/planned-meals`
- Auth: HTTP bearer

## Headers

- `x-timezone` string, required

## Request body

- CreateScheduledMealDto
  - `foodName` string, required
  - `servingSize` string
  - `calories` number
  - `protein` number
  - `carbs` number
  - `fat` number
  - `fiber` number
  - `meal_number` number: Meal slot number (1=breakfast, 2=lunch, 3=dinner, etc.)
  - `plannedDate` string, required
  - `timezone` string
  - `nutrition` string[]: Detailed nutrition breakdown

## Response `201`

- unknown

## Changes

- **2026-10-01** `b32a266fe351`: 3 info
  - api operation id `MealPlanningController_createPlannedMeal` removed and replaced with `ScheduledMealsController_createPlannedMeal`
  - api tag `Scheduled Meals` added
  - api tag `Meal Planning` removed

[Operation history](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/changes/api/planned-meals/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)