Organizations

Fetch a signed URL for the organization logo

Return a short-lived signed URL for the organization's logo.

variant selects the preferred mark and falls back to the other when it is unset, so a client can ask for the dark logo without first checking whether one exists. 404 means the organization has no mark at all.

Deliberately JSON rather than a 307 to the signed URL. A redirect reads like the natural fit for an <img src>, but an <img> tag cannot send an Authorization header, so the request arrives unauthenticated, is rejected, and the browser blocks the cross-origin response (ORB) before the redirect is ever followed. The client fetches this endpoint with its normal authenticated transport and puts the returned storage URL in the tag; that URL carries its own signature and needs no header.

get/organizations/{organization_id}/logo

Path parameters

organization_idstring required

Query parameters

variant'light' | 'dark'

Which of an organization's two marks an operation addresses.

Both are optional and each falls back to the other when rendering, so the variant selects a slot rather than asserting one exists. A StrEnum so the value doubles as the ?variant= query-param string.

Which mark to address: 'light' (the default) or 'dark'. On the GET, an unset variant falls back to the other one.

Response

Successful Response

urlstring required

Signed storage URL for the logo. Load it directly (e.g. as an image source); it carries its own signature and needs no auth header. Treat it as short-lived and refetch rather than persist.

expires_ininteger required

Seconds until the URL expires, from when it was issued.

Changes

No recorded changes to this endpoint across all 1 revision of this API.