Skip to content

Get a brand asset

GET
/brand-assets/{id}
Code sample: Shell / cURL
curl --request GET \
--url http://localhost:9090/brand-assets/1

Serve an uploaded brand asset: a logo, a favicon, a background image or a font. This is a public endpoint that does not require authentication.

Linked by an asset’s url, with its content fingerprint in v. Asked for by that fingerprint, the answer may be kept a year; asked for by any other fingerprint, or none, it is kept five minutes. A font is answered with Access-Control-Allow-Origin naming the admin console’s origin, so the console’s pages may draw it, and no other site’s.

id
required
integer format: int64

The asset’s ID

v
string

The asset’s content fingerprint, as its url names it.

The asset, under the type its upload was validated as

string format: binary
Cache-Control
string

“public, max-age=31536000, immutable” when v names the asset’s fingerprint, “public, max-age=300” otherwise

X-Content-Type-Options
string

Nosniff

Access-Control-Allow-Origin
string

The admin console’s origin, on a font alone

No asset has this ID, or the ID is not a positive integer

The request failed inside the server. The body is an HTML error page, not the JSON error envelope.

Media typetext/html
string