---
title: "Add a line by hand"
method: POST
path: "/api/grocery-lists/{id}/items"
tags: ["Meal Plans"]
---

# Add a line by hand

`POST /api/grocery-lists/{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/grocery-lists/{id}/items`
- Auth: HTTP bearer

## Path parameters

- `id` number, required

## Request body

- AddGroceryItemDto
  - `name` string, required
  - `amount` object, nullable
  - `unit` 'g' | 'kg' | 'ml' | 'l' | 'count' | 'tsp' | 'tbsp' | 'pack' | 'can' | 'jar' | 'bottle' | 'bunch' | 'clove' | 'slice' | 'oz' | 'lb' | 'fl_oz' | 'cup', nullable
  - `section` 'produce' | 'meat_seafood' | 'dairy_eggs' | 'bakery' | 'pantry' | 'spices' | 'frozen' | 'beverages' | 'other'

## Response `201`

## Changes

- **2026-10-01** `b32a266fe351`: 1 breaking, 2 warning, 5 info
  - added the new required request property `name`
  - removed the request property `itemName`
  - removed the request property `quantity`
  - api tag `Meal Plans` added
  - …4 more
- **2026-09-12** `0d5ef02a4fbe`: 1 info
  - endpoint added

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