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

# Apply custom app theme configuration

> Applies a new custom app theme configuration to all employers under the account. This will cascade the theme update to all employers' subdomains in WorkBright.



## OpenAPI

````yaml /i9/api-reference/i-9-api.yaml post /v1/applicationTheme
openapi: 3.1.0
info:
  contact:
    name: Symmetry Software
    url: https://www.symmetry.com
  description: I-9 API Documentation
  license:
    name: Terms of service
    url: https://www.symmetry.com/terms
  title: I-9 API
  version: 1.69.13
servers:
  - url: https://api.symmetry.com/i9
security: []
tags:
  - description: >-
      Endpoints for managing custom app theming configurations for a specific
      employer
    name: Employer Custom App Theming
  - description: >-
      Endpoints for managing custom app theming configurations for all employers
      in the account
    name: Account Custom App Theming
paths:
  /v1/applicationTheme:
    post:
      tags:
        - Account Custom App Theming
      summary: Apply custom app theme configuration
      description: >-
        Applies a new custom app theme configuration to all employers under the
        account. This will cascade the theme update to all employers' subdomains
        in WorkBright.
      operationId: applyCustomAppTheme_1
      requestBody:
        content:
          application/json:
            examples:
              Custom app theme request:
                description: Custom app theme request
                summary: Example custom app theme configuration
                value:
                  custom_app_theme:
                    alerts:
                      borderRadius: 4px
                      borderWidth: 1px
                      variants:
                        danger:
                          backgroundColor: '#fffbfb'
                          borderColor: '#c53336'
                        primary:
                          backgroundColor: '#fdfcff'
                          borderColor: '#006cc1'
                    body:
                      color: '#525257'
                      fontSize: 16px
                    buttons:
                      borderRadius: 4px
                      variants:
                        default:
                          borderColor: '#1c1c1c'
                        primary:
                          activeBackgroundColor: '#005c5c'
                          backgroundColor: '#0A8080'
                    formControl:
                      borderColor: '#929292'
                      borderRadius: 4px
                      focusBorderColor: '#005c5c'
                    headings:
                      h1:
                        color: '#262626'
                        fontSize: 32px
                        fontWeight: '500'
                      h2:
                        color: '#000fff'
                        fontSize: 50px
                        fontWeight: '500'
                    link:
                      color: '#0a8080'
                      decoration: underline
                      hoverColor: '#005c5c'
                      hoverDecoration: underline
            schema:
              $ref: '#/components/schemas/CustomAppThemeRequest'
        description: Custom app theme configuration object
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                Batch response:
                  description: Batch response
                  summary: Example batch operation response with per-employer status
                  value:
                    employerStatuses:
                      - employerId: 01992ae8-efbb-7765-a6f1-a50bad7a2c65
                        status: success
                      - employerId: 01992ae8-efbb-7765-a6f1-a50bad7a2c64
                        status: success
                    summary:
                      failed: 0
                      successful: 2
                      total: 2
                    theme:
                      custom_app_theme:
                        body:
                          color: '#525257'
                          fontSize: 16px
                        link:
                          color: '#0a8080'
                          decoration: underline
                          hoverColor: '#005c5c'
                          hoverDecoration: underline
              schema:
                $ref: '#/components/schemas/CustomAppThemeBatchResponse'
          description: Successfully applied custom app theme
        '400':
          description: Invalid theme configuration
      security:
        - AuthenticationToken: []
components:
  schemas:
    CustomAppThemeRequest:
      description: Custom app theme configuration request
      properties:
        custom_app_theme:
          $ref: '#/components/schemas/CustomAppThemeObject'
          description: Custom app theme configuration object
      required:
        - custom_app_theme
      type: object
    CustomAppThemeBatchResponse:
      description: Response for batch custom app theme operations
      properties:
        employerStatuses:
          description: Status report for each employer
          items:
            $ref: '#/components/schemas/EmployerStatus'
          type: array
        summary:
          $ref: '#/components/schemas/Summary'
          description: Summary statistics
        theme:
          $ref: '#/components/schemas/CustomAppThemeResponse'
          description: >-
            The custom app theme configuration from the first successful domain,
            if any.
      type: object
    CustomAppThemeObject:
      description: Custom app theme configuration
      properties:
        alerts:
          $ref: '#/components/schemas/AlertsTheme'
        body:
          $ref: '#/components/schemas/BodyTheme'
        buttons:
          $ref: '#/components/schemas/ButtonsTheme'
        formControl:
          $ref: '#/components/schemas/FormControlsTheme'
        headings:
          $ref: '#/components/schemas/HeadingsTheme'
        link:
          $ref: '#/components/schemas/LinkTheme'
      type: object
    EmployerStatus:
      description: Status of theme operation for a specific employer
      properties:
        employerId:
          description: Employer UUID
          example: 01992ae8-efbb-7765-a6f1-a50bad7a2c65
          type: string
        error:
          description: Error message if operation failed
          example: Rate limit exceeded
          type: string
        status:
          description: Operation status
          enum:
            - failed
            - success
          example: success
          type: string
      type: object
    Summary:
      description: Summary statistics for the batch operation
      properties:
        failed:
          description: Number of failed operations
          format: int32
          type: integer
        successful:
          description: Number of successful operations
          format: int32
          type: integer
        total:
          description: Total number of employers processed
          format: int32
          type: integer
      type: object
    CustomAppThemeResponse:
      description: Custom app theme configuration response
      properties:
        custom_app_theme:
          $ref: '#/components/schemas/CustomAppThemeObject'
          description: Custom app theme configuration object
      type: object
    AlertsTheme:
      description: Alerts styling
      properties:
        borderRadius:
          type: string
        borderWidth:
          type: string
        variants:
          $ref: '#/components/schemas/AlertsVariants'
      type: object
    BodyTheme:
      description: Body text styling
      properties:
        color:
          type: string
        fontSize:
          type: string
      type: object
    ButtonsTheme:
      description: Buttons styling
      properties:
        borderRadius:
          type: string
        variants:
          $ref: '#/components/schemas/ButtonVariantsTheme'
      type: object
    FormControlsTheme:
      description: Form controls styling
      properties:
        borderColor:
          type: string
        borderRadius:
          type: string
        focusBorderColor:
          type: string
      type: object
    HeadingsTheme:
      description: Headings styling
      properties:
        h1:
          $ref: '#/components/schemas/HeadingLevelTheme'
        h2:
          $ref: '#/components/schemas/HeadingLevelTheme'
        h3:
          $ref: '#/components/schemas/HeadingLevelTheme'
        h4:
          $ref: '#/components/schemas/HeadingLevelTheme'
        h5:
          $ref: '#/components/schemas/HeadingLevelTheme'
        h6:
          $ref: '#/components/schemas/HeadingLevelTheme'
      type: object
    LinkTheme:
      description: Link styling
      properties:
        color:
          type: string
        decoration:
          type: string
        hoverColor:
          type: string
        hoverDecoration:
          type: string
      type: object
    AlertsVariants:
      description: Alert variants styling
      properties:
        danger:
          $ref: '#/components/schemas/AlertVariantTheme'
        info:
          $ref: '#/components/schemas/AlertVariantTheme'
        primary:
          $ref: '#/components/schemas/AlertVariantTheme'
        success:
          $ref: '#/components/schemas/AlertVariantTheme'
        warning:
          $ref: '#/components/schemas/AlertVariantTheme'
      type: object
    ButtonVariantsTheme:
      description: Button variants styling
      properties:
        danger:
          $ref: '#/components/schemas/ButtonVariantTheme'
        default:
          $ref: '#/components/schemas/ButtonVariantTheme'
        info:
          $ref: '#/components/schemas/ButtonVariantTheme'
        primary:
          $ref: '#/components/schemas/ButtonVariantTheme'
        success:
          $ref: '#/components/schemas/ButtonVariantTheme'
        warning:
          $ref: '#/components/schemas/ButtonVariantTheme'
      type: object
    HeadingLevelTheme:
      description: Heading level styling
      properties:
        color:
          type: string
        fontSize:
          type: string
        fontWeight:
          type: string
      type: object
    AlertVariantTheme:
      description: Alert variant styling
      properties:
        backgroundColor:
          type: string
        borderColor:
          type: string
      type: object
    ButtonVariantTheme:
      description: Button variant styling
      properties:
        activeBackgroundColor:
          type: string
        backgroundColor:
          type: string
        borderColor:
          type: string
      type: object
  securitySchemes:
    AuthenticationToken:
      bearerFormat: JWT
      scheme: bearer
      type: http

````