> ## Documentation Index
> Fetch the complete documentation index at: https://docs.symmetry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account-level theming

> Manage an account-level theme that cascades to every employer. Covers the endpoint, supported methods, configuration structure, and apply, update, and delete examples.

Account-level theming is the right choice when you serve multiple employers under one brand, when you prefer managing a theme centrally rather than employer by employer, or when you want to overwrite every existing employer theme at once. It is typically applied during onboarding.

## 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

<Warning>
  **The cascade reaches only the employers that are active when you apply the theme.** Employers you activate afterward do not inherit it automatically. To bring a new employer in line, either re-apply the account-level theme with `POST`, or [apply a theme directly to that employer](/i9/custom-theming/employer-level-theming).
</Warning>

## Configuration structure

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

```json theme={null}
{
  "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. For the full list of customizable properties in each section, see [Custom Theming for Embedded Experiences](/i9/custom-theming/app-theming#supported-elements).

## 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`

```json theme={null}
{
  "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`

```json theme={null}
{
  "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](/i9/custom-theming/default-app-theme).

#### Request

`DELETE /v1/applicationTheme`

```bash theme={null}
curl -X DELETE "https://api.symmetry.com/i9/v1/applicationTheme" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```

#### Response

A successful request returns HTTP `200 OK`.