Update Meal Status

Mark a meal as consumed or not consumed

Endpoint

PUT /api/meal-detail/{meal_detail_id}/status

Update the consumption status of a specific meal. This is used in the Dashboard to track which meals have been eaten.

Path Parameters

meal_detail_id · integer · required

The unique identifier of the meal detail to update

Query Parameters

is_consumed · boolean · required

Whether the meal has been consumed (true) or not (false)

Authentication

This endpoint requires authentication. Include the JWT token in the Authorization header.

Response

Returns the updated meal detail with the new consumption status.

id · integer

Meal detail ID

daily_menu_id · integer

ID of the daily menu this meal belongs to

meal_type_id · integer

Type of meal (breakfast, lunch, dinner, snack)

recipe_id · integer

ID of the recipe assigned to this meal

is_consumed · boolean

Whether the meal has been consumed

recipe · object

Complete recipe information

Show recipe properties

id · integer

Recipe ID

name · string

Recipe name

calories · number

Total calories

protein_content · number

Protein in grams

carbohydrate_content · number

Carbohydrates in grams

fat_content · number

Fat in grams

Example Request

cURL

curl -X PUT "http://localhost:8000/api/meal-detail/123/status?is_consumed=true" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

const mealDetailId = 123;
const isConsumed = true;

const response = await fetch(
  `http://localhost:8000/api/meal-detail/${mealDetailId}/status?is_consumed=${isConsumed}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': `Bearer ${token}`
    }
  }
);

const updatedMeal = await response.json();

import requests

meal_detail_id = 123
is_consumed = True

url = f"http://localhost:8000/api/meal-detail/{meal_detail_id}/status"
params = {"is_consumed": is_consumed}
headers = {"Authorization": f"Bearer {token}"}

response = requests.put(url, params=params, headers=headers)
meal = response.json()

Example Response

200 OK

{
  "id": 123,
  "daily_menu_id": 45,
  "meal_type_id": 1,
  "recipe_id": 789,
  "is_consumed": true,
  "recipe": {
    "id": 789,
    "name": "Oatmeal with Berries",
    "calories": 320.5,
    "protein_content": 12.3,
    "carbohydrate_content": 54.2,
    "fat_content": 8.1
  }
}

Error Responses

404 Not Found

The meal detail with the specified ID does not exist.

{
  "detail": "Meal detail not found"
}

401 Unauthorized

Missing or invalid authentication token.

{
  "detail": "Could not validate credentials"
}

Usage in Dashboard

This endpoint is called when users toggle the consumption status of meals in the Dashboard:

1. User views their daily meal plan
2. User clicks the checkbox/toggle on a meal card
3. Frontend calls this endpoint with the meal_detail_id and new is_consumed status
4. Dashboard updates to reflect the new nutritional totals

The Dashboard automatically recalculates daily macronutrient totals when meal status is updated.