OpenPostOrganization Themes
Create an Organization theme draft
POST
/themesAuthorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/themes" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "organization_id": "string" }'{ "$schema": "https://example.com/api/v1/schemas/Theme.json", "draft": { "manifest": { "assets": [ { "alt": "string", "id": "string", "mimeType": "image/png", "slot": "background-texture", "sourceUrl": "string" } ], "description": "string", "fonts": [ { "display": "swap", "family": "string", "format": "woff2", "id": "string", "sourceUrl": "string", "style": "normal", "weight": 100 } ], "iconPack": "lucide", "id": "string", "name": "string", "revision": "string", "schemaVersion": 1, "schemes": { "dark": { "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 } } }, "light": { "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 } } } }, "supportedSchemes": [ "light" ] }, "revision": 0, "theme_id": "string", "updated_at": "2019-08-24T14:15:22Z", "updated_by": "string" }, "latest_published": { "$schema": "https://example.com/api/v1/schemas/PublishedRevision.json", "manifest": { "assets": [ { "alt": "string", "id": "string", "mimeType": "image/png", "slot": "background-texture", "sourceUrl": "string" } ], "description": "string", "fonts": [ { "display": "swap", "family": "string", "format": "woff2", "id": "string", "sourceUrl": "string", "style": "normal", "weight": 100 } ], "iconPack": "lucide", "id": "string", "name": "string", "revision": "string", "schemaVersion": 1, "schemes": { "dark": { "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 } } }, "light": { "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 } } } }, "supportedSchemes": [ "light" ] }, "published_at": "2019-08-24T14:15:22Z", "published_by": "string", "revision": 0, "source_revision": 0, "theme_id": "string" }, "summary": { "assigned_workspace_count": 0, "built_in": true, "created_at": "2019-08-24T14:15:22Z", "description": "string", "draft_revision": 0, "icon_pack": "lucide", "is_organization_default": true, "name": "string", "organization_id": "string", "published_revision": 0, "reference": { "id": "string", "kind": "built_in", "version": 1 }, "supported_schemes": [ "light" ], "updated_at": "2019-08-24T14:15:22Z" }}List Organization theme summaries GET
Returns a bounded page of compact summaries. Fetch one theme by ID for draft and published manifests.
List theme summaries available to a Workspace administrator GET
Returns a bounded page of built-ins and published Organization themes without exposing drafts, manifests, or asset inventory.