Appearance
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
directory_id | number | No | Only images in this folder. |
page | number | No | Page number, starting at 1. |
per_page | number | No | Images 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | One of the two | A public http or https address of the image. |
content_base64 | string | One of the two | The image itself, as a data URI (data:image/png;base64,…). |
file_name | string | No | Name for the image, up to 255 characters. |
directory_id | number | No | The 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.