Get the site's appearance

How the public site looks: theme, the color scheme a first visit opens in, where the navigation sits, brand color, and custom CSS.

GET/site/appearance

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Responses

200The site's appearance.

themestring

Allowed:paper

schemestring

Allowed:systemlightdark

navigationstring

A bar across the top, a sidebar with each collection's articles under it, or a sidebar listing the collections alone.

Allowed:topsidebartopics

accentstring | null

A hex color, or null for the theme's own.

cssstring

The custom stylesheet. Empty when there is none.

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/site/appearance" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/site/appearance", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "theme": "paper",
  "scheme": "system",
  "navigation": "top",
  "accent": "string",
  "css": "string"
}