Median

GET /site/appearance

Updated Oct 1, 20261 minute read

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.

Part of Site.

Responses

StatusDescription
200The site's appearance.
401The bearer token is missing, revoked, or expired.
429Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits.

200 body

FieldTypeRequiredDescription
theme"paper"No
scheme"system" | "light" | "dark"No
navigation"top" | "sidebar" | "topics"NoA bar across the top, a sidebar with each collection's articles under it, or a sidebar listing the collections alone.
accentanyNoA hex color, or null for the theme's own.
cssstringNoThe custom stylesheet. Empty when there is none.

Example request

curl https://api.median.sh/v1/site/appearance \
  -H "Authorization: Bearer $BEARER_AUTH"

Still need help?

    Esc