Account-Level Theming

Endpoint

Use this endpoint to manage an account-level application theme that cascades to all employers under your account:

/v1/applicationTheme

Supported Methods

Method	Behavior
`POST`	Applies a theme to all employers
`PATCH`	Partially updates the theme for all employers
`DELETE`	Removes the theme from all employers

Additional behavior:

Requests are rate-limited to 25 requests per second
Cascading updates are processed in parallel

Configuration Structure

All theming customizations are defined within a single JSON object using the structure shown below:

{
  "custom_app_theme": {
    "alerts": {/* Notification styling with variants */},
    "body": {/* Body text styling */},
    "buttons": {/* Button styling with variants and states */},
    "formControl": {/* Input field styling */},
    "headings": {/* H1-H6 typography */},
    "link": {/* Link styling and hover states */}
  }
}

Each section supports a predefined set of properties. Properties outside the supported set are ignored and do not affect the rendered embedded UI.

Examples

Apply a theme to all employers in your account

Use POST to create or fully replace the account-level application theme.

Request

POST /v1/applicationTheme

{
  "custom_app_theme": {
    "body": {
      "fontSize": "14px",
      "color": "#525257"
    },
    "link": {
      "hoverColor": "#005c5c",
      "hoverDecoration": "underline",
      "color": "#0a8080",
      "decoration": "underline"
    },
    "headings": {
      "h1": {
        "fontSize": "32px",
        "fontWeight": "500",
        "color": "#262626"
      },
      "h2": {
        "fontSize": "50px",
        "fontWeight": "500",
        "color": "#000fff"
      }
    },
    "alerts": {
      "borderWidth": "1px",
      "borderRadius": "4px",
      "variants": {
        "primary": {
          "backgroundColor": "#fdfcff",
          "borderColor": "#006cc1"
        },
        "danger": {
          "backgroundColor": "#fffbfb",
          "borderColor": "#c53336"
        }
      }
    },
    "buttons": {
      "borderRadius": "4px",
      "variants": {
        "primary": {
          "backgroundColor": "#0A8080",
          "activeBackgroundColor": "#005c5c"
        },
        "default": {
          "borderColor": "#1c1c1c"
        }
      }
    },
    "formControl": {
      "borderColor": "#929292",
      "borderRadius": "4px",
      "focusBorderColor": "#005c5c"
    }
  }
}

Response

The response returns the full theme as applied.

Partially update a theme

Use PATCH to update only the specified properties. All unspecified properties retain their existing values.

Request

PATCH /v1/applicationTheme

{
  "custom_app_theme": {
    "body": {
      "fontSize": "15px",
      "color": "#525257"
    }
  }
}

Response

The response returns the complete theme with the updates applied.

Delete a theme

Deleting the account-level theme causes the embedded UI to fall back to the Symmetry default theme.

Request

DELETE /v1applicationTheme

curl -X DELETE "https://api.symmetry.com/i9/v1/employers/0456sdfAfrd/applicationTheme" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Response

A successful request returns HTTP 200 OK.