Skip to content

Read an instance logo image

GET
/appearance/logo

Streams the current instance logo, or a listed logo picked by its hash.

No sign-in is needed, even when public mode is off. Leave out v, or send it empty, to get the active logo. A nonempty value must exactly match a hash in the current logo history; older listed logos stay readable even when another logo is active or the bundled default is selected.

You get 404 when nothing is selected, the hash isn’t listed, the storage service isn’t available, the recorded media type isn’t allowed, or storage reports the object missing. Show the bundled default mark when the logo can’t be loaded. Errors reading the configuration and other storage errors can fail the request.

The response streams the stored original, with no conversion and no new byte-integrity check. Content-Type is the allowlisted type recorded at upload: PNG, JPEG, GIF or WebP. The response also sets X-Content-Type-Options: nosniff and a restrictive Content Security Policy. Those protect the response; they don’t prove that every stored image is harmless.

Prefer the versioned logo_url from /appearance. Successful responses set Cache-Control: public, max-age=31536000, immutable and an ETag containing the selected hash, and Content-Length is sent only when the reported size is positive. The same cache policy is sent for a request with no v or an empty one, even though the active selection behind it can change. The handler doesn’t answer conditional requests with 304 and doesn’t serve byte ranges.

Logo history and stored bytes can change after you get a response or URL. Removing a logo from the list doesn’t recall copies clients have already cached.

v
string
/^[0-9a-f]{64}$/

A listed logo hash, matched exactly and case-sensitively against the current history. Leave it out, or send it empty, to get the active logo. The schema advertises 64 lowercase hex characters, but the handler checks list membership instead of that pattern, and a value that doesn’t match gets 404. It isn’t an arbitrary storage-object address.

The stored logo image. Its actual Content-Type is the recorded image type, even though the schema declares application/octet-stream.

string format: binary

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed