--- title: "Modify Nutrition Record" method: PATCH path: "/nutrition_records/{nutrition_record_id}" tags: ["Nutrition AI"] --- # Modify Nutrition Record `PATCH /nutrition_records/{nutrition_record_id}` ##### Change the portion size for a nutrition record by ID. You can modify the nutrition record by updating the total serving size or consumption time. At least one of these fields must be provided. The status of the successfully modified record will be set to `updated` while the input type will preserve the original value. ### Updating Serving Size When the serving size is changed, all ingredients and their respective nutritional fields will be automatically recalculated proportionally to maintain the same nutritional ratios. This allows you to easily adjust portion sizes while maintaining accurate nutritional information. The new serving size is expected to be in the same unit as the original serving size. ### Setting Up Consumption Time The consumption time indicates when the food was actually consumed. Leaving the consumption time empty or not providing it will keep the original value. This allows you to first track planned meals (without consumption time) and eventually mark them as consumed by setting up consumption time. ## Path parameters - `nutrition_record_id` string, required — Nutrition report record ID ## Request body - NutritionRecordPatchRequestBody - `consumed_at` string, date-time — The UTC time when food was consumed - `serving_size` number, double — Serving size in metric units ## Response `200` OK - NutritionRecord - `consumed_at` string, date-time — The UTC time when food was consumed. By default, it is set to the record update time - `dish_description` string — Detected dish description - `dish_description_translated` string — Dish description translated to target language - `dish_name` string, required — Detected dish name - `dish_name_translated` string — Dish name translated to target language - `failure_reason` string — Reason for processing failure - `ingredients` NutritionRecordIngredient[], nullable — List of detected ingredients with nutritional information - `name` string, required — Ingredient name using LANGUAL standard terminology - `name_translated` string — Ingredient name translated to target language - `nutritional_fields` object — Nutritional values in the given serving size - `calcium_mg` number — Calcium in milligrams - `carbohydrate_g` number — Carbohydrates in grams - `cholesterol_mg` number — Cholesterol in milligrams - `energy_kcal` number — Energy in kilocalories - `fat_monounsaturated_g` number — Monounsaturated Fat in grams - `fat_polyunsaturated_g` number — Polyunsaturated Fat in grams - `fat_saturated_g` number — Saturated Fat in grams - `fat_total_g` number — Total Fat in grams - `fat_trans_g` number — Trans Fat in grams - `fiber_total_dietary_g` number — Dietary Fiber in grams - `folate_mcg` number — Folate in micrograms - `iron_mg` number — Iron in milligrams - `magnesium_mg` number — Magnesium in milligrams - `manganese_mcg` number — Manganese in micrograms - `niacin_mg` number — Niacin in milligrams - `phosphorus_mg` number — Phosphorus in milligrams - `potassium_mg` number — Potassium in milligrams - `protein_g` number — Protein in grams - `riboflavin_mg` number — Riboflavin in milligrams - `salt_g` number — Salt in grams - `salt_mg` number — Salt in milligrams - `sodium_g` number — Sodium in grams - `sodium_mg` number — Sodium in milligrams - `sugars_total_g` number — Total Sugars in grams - `thiamin_mg` number — Thiamin in milligrams - `vitamin_a_rae_mcg` number — Vitamin A in micrograms - `vitamin_b12_mcg` number — Vitamin B12 in micrograms - `vitamin_b6_mg` number — Vitamin B6 in milligrams - `vitamin_c_mg` number — Vitamin C in milligrams - `vitamin_d_mcg` number — Vitamin D in micrograms - `vitamin_e_mg` number — Vitamin E in milligrams - `vitamin_k_mcg` number — Vitamin K in micrograms - `zinc_mg` number — Zinc in milligrams - `serving_size` number, double, required — Serving size in metric units - `unit` 'g' | 'mg' | 'mcg' | 'ml' | 'kcal', required — Metric unit (g for solids, ml for liquids) - `input_type` 'image' | 'manual' | 'push' | 'text' — Nutrition record input type - `modified_at` string, date-time — Update timestamp in UTC - `nutri_score` string — Nutri-Score known as the 5-Colour Nutrition label (A-E) - `nutritional_fields` object — Nutritional values in the given serving size - `calcium_mg` number — Calcium in milligrams - `carbohydrate_g` number — Carbohydrates in grams - `cholesterol_mg` number — Cholesterol in milligrams - `energy_kcal` number — Energy in kilocalories - `fat_monounsaturated_g` number — Monounsaturated Fat in grams - `fat_polyunsaturated_g` number — Polyunsaturated Fat in grams - `fat_saturated_g` number — Saturated Fat in grams - `fat_total_g` number — Total Fat in grams - `fat_trans_g` number — Trans Fat in grams - `fiber_total_dietary_g` number — Dietary Fiber in grams - `folate_mcg` number — Folate in micrograms - `iron_mg` number — Iron in milligrams - `magnesium_mg` number — Magnesium in milligrams - `manganese_mcg` number — Manganese in micrograms - `niacin_mg` number — Niacin in milligrams - `phosphorus_mg` number — Phosphorus in milligrams - `potassium_mg` number — Potassium in milligrams - `protein_g` number — Protein in grams - `riboflavin_mg` number — Riboflavin in milligrams - `salt_g` number — Salt in grams - `salt_mg` number — Salt in milligrams - `sodium_g` number — Sodium in grams - `sodium_mg` number — Sodium in milligrams - `sugars_total_g` number — Total Sugars in grams - `thiamin_mg` number — Thiamin in milligrams - `vitamin_a_rae_mcg` number — Vitamin A in micrograms - `vitamin_b12_mcg` number — Vitamin B12 in micrograms - `vitamin_b6_mg` number — Vitamin B6 in milligrams - `vitamin_c_mg` number — Vitamin C in milligrams - `vitamin_d_mcg` number — Vitamin D in micrograms - `vitamin_e_mg` number — Vitamin E in milligrams - `vitamin_k_mcg` number — Vitamin K in micrograms - `zinc_mg` number — Zinc in milligrams - `record_id` string, uuid — Report record ID - `serving_size` number, double, required — Serving size in metric units - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'updated' — Processing status - `unit` 'g' | 'mg' | 'mcg' | 'ml' | 'kcal', required — Metric unit (g for solids, ml for liquids) - `uploaded_at` string, date-time — Upload timestamp in UTC - `user_time_offset_minutes` integer — User's local timezone offset in minutes ## Other responses - `400` — Bad Request - `401` — Unauthorized - `404` — Not Found - `422` — Unprocessable Entity - `500` — Internal Server Error --- [API](https://skmtc.dev/spikeapi/apis/application-user-api.md) · [All operations](https://skmtc.dev/spikeapi/apis/application-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spikeapi/application-user-api/revisions/637338fb0c9d/schema)