Only what your assistant sends changes. Items change one at a time, by the ids the meal returned: a new portion, a food removed, or a food added. When you eat a meal you planned, your assistant marks it eaten here rather than logging it again.

It takes the same input as Update a meal in the API, plus photos.

Inputs

Input	Type	Description
id	string	Required.
state	string	logged for food eaten; planned only for a plan the person asked to save. One of planned or logged.
eatenAt	date-time	When it was eaten, or for a plan when it will be, with its UTC offset.
timezone	string	The IANA timezone where the meal is eaten, such as America/New_York. Up to 100 characters.
name	string or null	Up to 2,000 characters.
notes	string or null	Up to 2,000 characters.
images	array	Photos already saved on this record to keep, or public https image links. New photos from the conversation go in photos, never here. Up to 20 items.
items	object
photos	array	Photos the person attached in this conversation to keep with this record: pass the attachments themselves, never file paths. Up to 6 items.

Items

Input	Type	Description
add	array	Foods to add, as create_meal items. Up to 100 items.
change	array	New portions by item id, or both null to clear one. Up to 100 items.
remove	array	Ids of items to drop. Up to 100 items.

What your assistant is told

The tool’s own instructions, word for word, as every assistant receives them.

Change a saved meal; only what you pass changes. Mark a planned meal as eaten with state logged (and eatenAt if the time differs) rather than creating it again; move, rename or annotate a meal the same way. A field left out keeps its value, and null clears name or notes. Items change one at a time by the item ids the meal returned: items.change sets a portion, items.remove drops items, and items.add adds foods as in create_meal; to swap a food, remove it and add the other. Ask one short question first if a food or portion is unclear. Pass photos the person attached as photos to add them; images replaces the saved photos, and a saved photo left out is deleted. Confirm the change only after success.