Theme Builder

List all built theme snapshots

{
  "data": [
    {
      "id": "th-001",
      "name": "light-v1",
      "mode": "light",
      "compliant": true,
      "component_theme_count": 8,
      "created_at": "2026-03-26T08:30:00Z"
    },
    {
      "id": "th-002",
      "name": "dark-v1",
      "mode": "dark",
      "compliant": true,
      "component_theme_count": 8,
      "created_at": "2026-03-26T08:31:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

Get a full theme snapshot including component overrides

{
  "id": "th-001",
  "name": "light-v1",
  "mode": "light",
  "compliant": true,
  "primary_color": "#1A73E8",
  "background_color": "#FFFFFF",
  "surface_color": "#F8F9FA",
  "on_primary_color": "#FFFFFF",
  "component_themes": {
    "elevated_button": {
      "background_color": "#1A73E8",
      "foreground_color": "#FFFFFF"
    },
    "text_field": {
      "fill_color": "#F8F9FA",
      "border_color": "#DADCE0"
    }
  },
  "created_at": "2026-03-26T08:30:00Z"
}

Build and save a new theme from token values

{
  "name": "high-contrast-v1",
  "mode": "light",
  "primary_color": "#000000",
  "background_color": "#FFFFFF",
  "surface_color": "#F0F0F0",
  "on_primary_color": "#FFFFFF"
}

{
  "id": "th-003",
  "name": "high-contrast-v1",
  "mode": "light",
  "compliant": true,
  "component_theme_count": 8,
  "created_at": "2026-03-26T10:00:00Z"
}

Rebuild a theme with updated token values

{
  "primary_color": "#0057B7",
  "on_primary_color": "#FFFFFF"
}

{
  "id": "th-003",
  "name": "high-contrast-v1",
  "mode": "light",
  "compliant": true,
  "component_theme_count": 8,
  "created_at": "2026-03-26T10:00:00Z",
  "updated_at": "2026-03-26T10:25:00Z"
}

Delete a theme snapshot

{
  "deleted": true,
  "id": "th-003"
}

Validate a theme snapshot for WCAG compliance

{
  "theme_id": "th-001",
  "compliant": true,
  "checks_run": 24,
  "failures": []
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}