⚫🔴🔵 Attach or replace the display image of a manual intake.

Attaches an image that is used only for displaying an existing manual intake.

The uploaded image is presentation-only. It does not trigger food recognition, segmentation, barcode processing or nutritional calculation,
and it does not modify the intake's foods, recipes, quantities, nutrition, timestamp or occasion.

If the intake already has a display image, the new image replaces it.

Display images are supported only for intakes that originate from manual input.
This also includes manual intakes that may be represented internally as APIImage entries after using favorites, custom recipes or barcode foods.

Recognition and segmentation intakes cannot receive a display image.

The caller must own the intake or be authorized to manage the APIUser that owns it.

The request must use multipart/form-data and provide the image in the image field. The maximum image size is 1 MB.

After uploading the image, GET /v2/intake/{imageId} and GET /v2/history/getIntakesList return this display image through image_url.

Use DELETE /v2/intake/{image_id}/display_image to remove the explicitly attached display image and return to the intake's normal image fallback.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

ID of the manual intake whose display image will be attached or replaced.

Body Params
file
required

Display-only image to upload. Maximum size is 1 MB.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json