Static files

https://img.brandmarks.dev/logos/v1/{kind}/{file-key}.{ext}

Kinds are logo, mark, logo-rev, and mark-rev. Extensions are svg and png. The -rev variants contain white artwork. Paths are case-sensitive.

https://img.brandmarks.dev/logos/v1/mark/AAPL.svg
https://img.brandmarks.dev/logos/v1/logo-rev/AAPL.png
https://img.brandmarks.dev/logos/v1/email/mark-128/AAPL.png

Additional email paths are email/mark-64 and email/logo-400, both PNG. Find file keys in the catalog or manifest. Do not append API parameters such as theme, size, or token to transform a static file.

The public image host is img.brandmarks.dev, a custom domain connected to the Brandmarks R2 bucket. The underlying r2.dev address is retained for development checks. For a larger integration, discuss beta API access with us. Direct HTTP clients should send a descriptive User-Agent; some default library agents may be refused by hosting rules.

Files can change at the same URL after a brand refresh, or be removed at a brand owner’s request. /v1/ identifies the path version, not an immutable asset revision.