Find an Image
Filter the gallery by kind:
The gallery lists the newest first. Switch the sort to Oldest first to start from the other end.
Search finds brand and generated images by what they show. Results come back best match first, so the sort reads Best match until you clear the search.
Hover a tile and click Add to chat in its corner to attach it to the chat composer. Click a tile to open it full size.
Upload Images and Logos
Click Upload. Drop files in From computer, or paste public image links in From links. Mark each one as an Image or a Logo, then click Upload. An agent adds images withadd_image, from a public link or from a file on its machine. See From an Agent.
Crop and Adjust an Image
Open an image in the gallery and click Crop and adjust. The editor can:- Crop to any shape (Free) or to a fixed ratio: 1:1, 4:3, 16:9, or 3:1.
- Rotate left or right, and flip horizontally or vertically.
- Change brightness, contrast, and saturation.
Delete an Image
Open the image, click the … menu next to Use in a new email, and choose Delete image. The image leaves the gallery and image search, so Brew stops offering it for new designs. Its file stays hosted at the same URL, so emails that already show it keep rendering. From an agent, it’sdelete_brand_image over MCP, DELETE /v1/brand/images/{assetId} over the API, or brew.brand.deleteImage(assetId) in the TypeScript SDK. Pass the assetId that search_brand_images or GET /v1/brand/images returns. Each call deletes one image, and it’s free.
{ "assetId": "5f750e5f", "deleted": true }. An assetId that isn’t in the library answers deleted: false and changes nothing, so a repeat is safe.
Logos are refused with 400 INVALID_REQUEST: manage them here on the Assets page.
From an Agent
GET /v1/brand/images lists the same gallery over the API. Pass kind (logo, brand, or generated) to filter it and sort (newest or oldest) to order it. Browsing is free. A search with q costs 1 credit for its first page, and later pages are free (see Credits). Every row carries an assetId, the id the app opens at /assets?image=<assetId>.
search_brand_images over MCP lists the logos and brand images, with kind logo or brand. Images made with Brew stay inside the designs that use them there: create_email and edit_email make new imagery inside a design and don’t add it to this gallery.
POST /v1/content/generate-image (API only) saves each image it makes under Generated. add_image adds images under Brand images for free, and takes one of:
imageUrl: one public link, added at once.imageUrls: up to 100 public links, imported in the background.uploadId: a file from the agent’s machine. PNG, JPEG, GIF, WebP, AVIF, TIFF, or SVG, up to 20 MB (SVG 2 MB).
create_image_upload opens the upload, the agent POSTs the bytes to the uploadUrl it returns (curl -X POST --data-binary @logo.png "<uploadUrl>"), and add_image takes the uploadId. Sending the bytes takes a client with a shell or an HTTP tool on that machine, such as Claude Code or Cursor. In a chat-only client, the agent asks you for a public link and uses imageUrl instead.
add_image returns the new image’s assetId, so an agent can delete what it just added. Over the API it’s POST /v1/content/add-image, and a local file starts with POST /v1/content/image-uploads. Upload a Local Image walks through the three calls.
Crop and adjust is app-only. Over the API, POST /v1/content/transform resizes an image to exact dimensions, optimizes it, or removes its background.
Related
Brand identity
The Brand page: details, links, and the two design files Brew reads.
Set a design baseline
How
image-style.md shapes the images Brew generates.Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
ChatGPT/Claude Integration
Click “Open in ChatGPT” at the top right of any page to explore it further with ChatGPT or Claude.