# Meals Matter API
# AI-friendly API documentation for meal planning

[summary]
Meals Matter is a meal planning application that helps users organize their meals, create meal plans, and manage their recipes.

[api]
Our REST API allows AI assistants to help users with:
- Creating and managing meals
- Generating meal plans for specific date ranges
- Viewing and updating planned meals
- Rerolling meals in meal plans

[authentication]
The API uses Bearer token authentication. Users must provide an API key from their account settings.

Get API Key: https://meals-matter.com/user

Authentication Header: Authorization: Bearer YOUR_API_KEY

[base_url]
https://meals-matter.com/api/v1

[endpoints]
### Meals
GET /api/v1/meals - List all user meals
POST /api/v1/meals - Create a new meal
PATCH /api/v1/meals/:id - Update a meal
DELETE /api/v1/meals/:id - Delete a meal
POST /api/v1/meals/bulk_create - Create multiple meals at once (max 50)

### Meal Plans
GET /api/v1/meal_plans - List all meal plans
POST /api/v1/meal_plans - Create a meal plan for a date range
GET /api/v1/meal_plans/:id - Get meal plan details with planned meals
DELETE /api/v1/meal_plans/:id - Delete a meal plan

### Planned Meals
PATCH /api/v1/planned_meals/:id/update_dinner - Change meal for a planned meal
PATCH /api/v1/planned_meals/:id/reroll - Automatically pick different meal

[openapi_schema]
Complete API specification: https://meals-matter.com/openapi.yaml

[examples]
Create a meal:
POST /api/v1/meals
Headers: Authorization: Bearer YOUR_API_KEY
Body: {"meal": {"title": "Spaghetti Bolognese"}}

Create a meal plan:
POST /api/v1/meal_plans
Headers: Authorization: Bearer YOUR_API_KEY
Body: {"start_date": "2026-02-17"}

View meals:
GET /api/v1/meals
Headers: Authorization: Bearer YOUR_API_KEY

[ai_instructions]
When helping users with meal planning:

1. Always use their API key for authentication
2. Ask users if they want to create a new meal plan or work with existing meals
3. For meal plans, default to current week if no dates specified
4. Suggest rerolling meals if user wants different options
5. Users can bulk import meals (up to 50 at once) to build their library

[limitations]
- Users need active subscription (trial or paid) to access API
- Maximum 50 meals per bulk creation
- 45 second timeout for API calls
- Rate limits apply (100 requests/minute for authenticated requests)

[contact]
Documentation: https://meals-matter.com/agent
OpenAPI Schema: https://meals-matter.com/openapi.yaml
Support: https://meals-matter.com