Upload image

Upload an image to a note. If placeholder_id is provided and matches a {{IMG:placeholder_id}} marker in the note content, the marker is replaced with an <img> tag. If the placeholder was already uploaded (re-upload), the old image is replaced. Without placeholder_id, the image is uploaded as a plain attachment.

Supported formats: JPEG, PNG, GIF, WebP. Maximum file size: 25MB. Maximum 20 images per note. File content is validated against magic bytes to prevent spoofed MIME types.

Path Params
uuid
required

Note ID

Body Params
file
required

Image file (JPEG, PNG, GIF, WebP). Max 25MB.

string

Placeholder ID to replace in note content

string
length ≤ 500

Alt text for the image

Responses

400

Invalid file type or size

422

Validation error (invalid placeholder ID, magic bytes mismatch, or max images exceeded)

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