{"openapi":"3.1.0","info":{"title":"Omarchy Themes API","version":"1.0.0","summary":"Read-only catalog of community themes for the Omarchy Linux desktop.","description":"Static JSON, rebuilt daily from GitHub. No key or auth. Responses are cached at the edge, so poll at most once an hour. Versioning: the major version is in the URL path (/api/v1/). Additive changes, such as new fields, ship within v1. A breaking change ships as /api/v2/. Deprecation policy: a deprecated version sends Deprecation (RFC 9745) and Sunset (RFC 8594) headers and keeps working for at least six months. No version is deprecated today.","contact":{"name":"Omarchy Themes","email":"help@omarchytheme.com","url":"https://omarchytheme.com/contact/"},"license":{"name":"MIT","identifier":"MIT"}},"externalDocs":{"url":"https://omarchytheme.com/docs/"},"servers":[{"url":"https://omarchytheme.com"}],"paths":{"/api/v1/themes.json":{"get":{"operationId":"listThemes","summary":"List every theme","description":"Returns all listed themes, most-starred first, with install commands and full palettes.","responses":{"200":{"description":"All themes.","content":{"application/json":{"schema":{"type":"object","required":["count","themes"],"properties":{"count":{"type":"integer"},"themes":{"type":"array","items":{"type":"object","required":["slug","name","author","repository","stars","builtin","install_command","colors","page_url"],"properties":{"slug":{"type":"string","description":"URL-safe theme id.","example":"catppuccin"},"name":{"type":"string","description":"Display name."},"description":{"type":["string","null"],"description":"Repository description from GitHub."},"author":{"type":"string","description":"GitHub owner of the theme repository."},"repository":{"type":"string","format":"uri","description":"GitHub repository URL."},"stars":{"type":"integer","description":"GitHub stars."},"primary_hue":{"type":["string","null"],"description":"Dominant color family of the palette, such as blue, red, green, purple, or grey."},"builtin":{"type":"boolean","description":"True when the theme ships with Omarchy."},"install_command":{"type":"string","description":"Shell command that installs the theme on Omarchy."},"colors":{"type":"object","description":"Terminal palette from colors.toml: background, foreground, accent, cursor, selection_*, color0 to color15.","additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"apps":{"type":"array","items":{"type":"string"},"description":"Apps the theme styles, such as waybar or neovim."},"security_warnings":{"type":"array","items":{"type":"string"},"description":"Things the theme does beyond colors, such as installing an editor extension. Show these to the user before installing."},"preview_url":{"type":["string","null"],"format":"uri","description":"Screenshot of the theme."},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"updated_at":{"type":"string","format":"date-time","description":"Last push to the repository."}}}}}}}}}}}},"/api/v1/themes/{slug}.json":{"get":{"operationId":"getTheme","summary":"Get one theme","description":"Returns one theme by slug. Slugs come from listThemes or the theme page URL.","parameters":[{"name":"slug","in":"path","required":true,"description":"Theme slug, for example catppuccin.","schema":{"type":"string","pattern":"^[a-z0-9-]+$"}}],"responses":{"200":{"description":"The theme.","content":{"application/json":{"schema":{"type":"object","required":["slug","name","author","repository","stars","builtin","install_command","colors","page_url"],"properties":{"slug":{"type":"string","description":"URL-safe theme id.","example":"catppuccin"},"name":{"type":"string","description":"Display name."},"description":{"type":["string","null"],"description":"Repository description from GitHub."},"author":{"type":"string","description":"GitHub owner of the theme repository."},"repository":{"type":"string","format":"uri","description":"GitHub repository URL."},"stars":{"type":"integer","description":"GitHub stars."},"primary_hue":{"type":["string","null"],"description":"Dominant color family of the palette, such as blue, red, green, purple, or grey."},"builtin":{"type":"boolean","description":"True when the theme ships with Omarchy."},"install_command":{"type":"string","description":"Shell command that installs the theme on Omarchy."},"colors":{"type":"object","description":"Terminal palette from colors.toml: background, foreground, accent, cursor, selection_*, color0 to color15.","additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"apps":{"type":"array","items":{"type":"string"},"description":"Apps the theme styles, such as waybar or neovim."},"security_warnings":{"type":"array","items":{"type":"string"},"description":"Things the theme does beyond colors, such as installing an editor extension. Show these to the user before installing."},"preview_url":{"type":["string","null"],"format":"uri","description":"Screenshot of the theme."},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"updated_at":{"type":"string","format":"date-time","description":"Last push to the repository."}}}}}},"404":{"description":"No theme has this slug.","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","required":["type","title","status","code"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string","description":"Stable machine-readable error code."},"detail":{"type":"string"},"resolution":{"type":"string","description":"What to do next."}}}}}}}}}},"components":{"schemas":{"Theme":{"type":"object","required":["slug","name","author","repository","stars","builtin","install_command","colors","page_url"],"properties":{"slug":{"type":"string","description":"URL-safe theme id.","example":"catppuccin"},"name":{"type":"string","description":"Display name."},"description":{"type":["string","null"],"description":"Repository description from GitHub."},"author":{"type":"string","description":"GitHub owner of the theme repository."},"repository":{"type":"string","format":"uri","description":"GitHub repository URL."},"stars":{"type":"integer","description":"GitHub stars."},"primary_hue":{"type":["string","null"],"description":"Dominant color family of the palette, such as blue, red, green, purple, or grey."},"builtin":{"type":"boolean","description":"True when the theme ships with Omarchy."},"install_command":{"type":"string","description":"Shell command that installs the theme on Omarchy."},"colors":{"type":"object","description":"Terminal palette from colors.toml: background, foreground, accent, cursor, selection_*, color0 to color15.","additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"apps":{"type":"array","items":{"type":"string"},"description":"Apps the theme styles, such as waybar or neovim."},"security_warnings":{"type":"array","items":{"type":"string"},"description":"Things the theme does beyond colors, such as installing an editor extension. Show these to the user before installing."},"preview_url":{"type":["string","null"],"format":"uri","description":"Screenshot of the theme."},"page_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"updated_at":{"type":"string","format":"date-time","description":"Last push to the repository."}}},"Problem":{"type":"object","description":"RFC 9457 problem details.","required":["type","title","status","code"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string","description":"Stable machine-readable error code."},"detail":{"type":"string"},"resolution":{"type":"string","description":"What to do next."}}}}}}