---
title: "Fetch a signed URL for the organization logo"
method: GET
path: "/organizations/{organization_id}/logo"
tags: ["Organizations"]
---

# Fetch a signed URL for the organization logo

`GET /organizations/{organization_id}/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.

## Path parameters

- `organization_id` string, 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.

## Response `200`

Successful Response

- OrganizationLogoUrl — A signed URL for reading an organization's logo.
  - `url` string, 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_in` integer, required — Seconds until the URL expires, from when it was issued.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)