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.
Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”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.
Responses
Section titled “ Responses ”The stored logo image. Its actual Content-Type is the recorded image type, even though the schema declares application/octet-stream.
Resource not found
object
Human-readable error summary
Example
the request could not be completed