OpenPostOrganization Themes
Resolve the complete Workspace theme
Returns one complete manifest. Resolution precedence: locked or missing Workspace selection inherits the Organization default; the default falls back to Workshop. Missing, invalid, unpublished, deleted, inaccessible, or unsupported references fall back as a whole to Workshop with a fallbackReason; the response never mixes schemes or token sources. Cache identity is source:id:version:scheme (fallbacks additionally key on reason) and served as ETag. Native clients: token values use web CSS value syntax (px/rem/em/%, ms/s, oklch(), color-mix(), cubic-bezier); map them to platform values (16px root, hex8 color, millisecond durations, closed recipe enums) and validate the result before staging. Resource URLs are same-origin /api/v1/theme-assets/{id}/content scoped by workspace_id, theme_id, and revision with optional ttf/otf font derivatives.
GET
/themes/resolvedAuthorization
bearerAuth AuthorizationBearer <token>
In: header
Query Parameters
workspace_id*string
Workspace ID
scheme*string
Effective light or dark scheme already chosen from the user's system preference
Value in
- "light"
- "dark"
Header Parameters
If-None-Match?string
Resolved theme cache identity
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/themes/resolved?workspace_id=string&scheme=light"{ "$schema": "https://example.com/api/v1/schemas/ResolvedTheme.json", "assets": [ { "alt": "string", "id": "string", "mimeType": "image/png", "slot": "background-texture", "sourceUrl": "string" } ], "fallbackReason": "missing-theme", "fonts": [ { "display": "swap", "family": "string", "format": "woff2", "id": "string", "nativeDerivative": { "format": "ttf", "identity": "string", "sourceUrl": "string" }, "sourceUrl": "string", "style": "normal", "weight": 100 } ], "iconPack": "lucide", "id": "string", "manifest": { "colors": { "actionDestructive": "string", "actionDestructiveActive": "string", "actionDestructiveHover": "string", "actionDestructiveInk": "string", "actionFocal": "string", "actionFocalActive": "string", "actionFocalHover": "string", "actionFocalInk": "string", "actionLink": "string", "actionLinkHover": "string", "actionOrdinary": "string", "actionOrdinaryActive": "string", "actionOrdinaryBorder": "string", "actionOrdinaryHover": "string", "actionOrdinaryInk": "string", "actionPrimary": "string", "actionPrimaryActive": "string", "actionPrimaryHover": "string", "actionPrimaryInk": "string", "actionQuiet": "string", "actionQuietActive": "string", "actionQuietHover": "string", "actionQuietInk": "string", "border": "string", "brand": "string", "brandInk": "string", "browserChrome": "string", "browserSurface": "string", "canvas": "string", "cardHover": "string", "caret": "string", "chart1": "string", "chart2": "string", "chart3": "string", "chart4": "string", "chart5": "string", "chrome": "string", "chromeInk": "string", "danger": "string", "dangerInk": "string", "disabled": "string", "disabledInk": "string", "field": "string", "fieldBorder": "string", "fieldDisabled": "string", "fieldDisabledInk": "string", "fieldFocus": "string", "fieldHover": "string", "fieldInk": "string", "focus": "string", "info": "string", "infoInk": "string", "ink": "string", "input": "string", "link": "string", "mutedInk": "string", "navigationActive": "string", "navigationActiveInk": "string", "navigationHover": "string", "overlay": "string", "scrim": "string", "selection": "string", "selectionInk": "string", "sidebar": "string", "sidebarActive": "string", "sidebarActiveInk": "string", "sidebarBorder": "string", "sidebarInk": "string", "success": "string", "successInk": "string", "surface": "string", "surfaceRaised": "string", "surfaceSunken": "string", "warning": "string", "warningInk": "string", "workspace": "string", "workspaceInk": "string" }, "components": { "badge": "solid", "button": "solid", "card": "flat", "checkbox": "solid", "chip": "solid", "container": "flat", "decoration": "none", "dialog": "flat", "editorChrome": "neutral", "emptyState": "plain", "input": "filled", "link": "underlined", "list": "divided", "loadingState": "spinner", "navigation": "quiet", "pagination": "quiet", "popover": "flat", "radio": "solid", "select": "filled", "switch": "solid", "table": "ruled", "tabs": "underline", "toast": "flat", "toolbar": "flat" }, "elevation": { "card": "string", "dialog": "string", "focalAction": "string", "popover": "string" }, "motion": { "entry": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "exit": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "hover": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "loading": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "pageTransition": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "press": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 }, "reducedMotion": "instant", "selection": { "distance": "string", "duration": "string", "easing": "string", "opacity": 0 } }, "protectedEditor": { "canvasGrid": "string", "canvasHandle": "string", "canvasPasteboard": "string", "canvasSafeArea": "string", "canvasSelection": "string", "editorBorder": "string", "editorCanvas": "string", "editorControl": "string", "editorControlHover": "string", "editorFocus": "string", "editorFocusBorder": "string", "editorMuted": "string", "editorPanel": "string", "editorText": "string", "protectedGlyph": "string", "timelineClip": "string", "timelinePlayhead": "string", "timelineSelection": "string", "timelineTrack": "string", "timelineWaveform": "string" }, "shape": { "borderStyle": "solid", "borderWidth": "string", "radius": "string", "radiusLg": "string", "radiusMd": "string", "radiusMedia": "string", "radiusPill": "string", "radiusSm": "string" }, "shell": { "canvasTreatment": "plain", "contentMaxWidth": "string", "headerHeight": "string", "mobileNavigationHeight": "string", "sidebarWidth": "string" }, "spacing": { "base": "string", "compactControlHeight": "string", "componentGap": "string", "controlHeight": "string", "density": "compact", "pageGutter": "string", "sectionGap": "string", "touchTarget": "string" }, "typography": { "body": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 }, "code": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 }, "display": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 }, "label": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 }, "metadata": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 }, "title": { "fallbacks": [ "string" ], "family": "string", "lineHeight": "string", "size": "string", "tracking": "string", "weight": 100 } } }, "name": "string", "requestedScheme": "light", "revision": "string", "scheme": "light", "source": "builtin"}