Skip to content

Images ​

Every account has an image bank: the images used in its emails. These tools list the images and add new ones. Each image has a public address (public_path) that can be used in an email.

Images cannot be renamed, moved or deleted with these tools.

Every tool also takes the optional account_id (see Accounts). It is left out of the tables below.

list-images ​

Lists the images in the image bank, newest first, with their name, address, size and dimensions.

ParameterTypeRequiredDescription
directory_idnumberNoOnly images in this folder.
pagenumberNoPage number, starting at 1.
per_pagenumberNoImages per page, up to 100. Defaults to 100.
  • The tool lists images but does not show them; the assistant gives you their names and links.
  • For older images, the type and size may be missing.

Try asking: "Show me the latest images in my image bank."

upload-image ​

Adds one image to the image bank and returns its address.

ParameterTypeRequiredDescription
urlstringOne of the twoA public http or https address of the image.
content_base64stringOne of the twoThe image itself, as a data URI (data:image/png;base64,…).
file_namestringNoName for the image, up to 255 characters.
directory_idnumberNoThe folder to put it in.
  • PNG, JPEG, GIF or WebP, up to 20 MB. SVG is not accepted. Very large images may be resized.
  • If the same image is already in the bank, the existing one is returned instead of a duplicate.
  • An upload can fail when the account's storage is full or the address cannot be reached.

Try asking: "Upload https://example.com/logo.png to my image bank and give me its address."

Limits ​

The image bank allows about 60 requests per minute per account. When the limit is reached, the assistant tells you and waits for you rather than retrying.