v1

latestOpenAPI 3.1.02026-07-2670105729.6 KB
Content

Add image

Adds an image to the brand image library from a public URL: fetches it, optimizes it (resize ≤1200px, palette PNG via Sharp), stores it, and vector-indexes it so the email agent can find it. Returns the durable cdn.brew.new URL plus dimensions. Credit-metered (fixed cost).

post/v1/content/add-image

Headers

Idempotency-Keystring

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Request body

imageUrlstring uri required

Response

The image was optimized, saved to the brand library, and rehosted; url is a durable cdn.brew.new URL.

urlstring uri required
widthinteger required
heightinteger required
aspectRatiostring required