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

# Update custom app theme configuration

> Updates the existing custom app theme configuration for all employers under the account. Only the provided fields will be updated; other fields will remain unchanged. This will cascade the update to all employers' subdomains. Returns a status report showing which domains succeeded or failed.



## OpenAPI

````yaml /i9/api-reference/i-9-api.yaml patch /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:
    patch:
      tags:
        - Account Custom App Theming
      summary: Update custom app theme configuration
      description: >-
        Updates the existing custom app theme configuration for all employers
        under the account. Only the provided fields will be updated; other
        fields will remain unchanged. This will cascade the update to all
        employers' subdomains. Returns a status report showing which domains
        succeeded or failed.
      operationId: updateCustomAppTheme_1
      requestBody:
        content:
          application/json:
            examples:
              Partial theme update:
                description: Partial theme update
                summary: Example partial theme update
                value:
                  custom_app_theme:
                    body:
                      color: '#000000'
                    buttons:
                      variants:
                        primary:
                          backgroundColor: '#0066cc'
            schema:
              $ref: '#/components/schemas/CustomAppThemeRequest'
        description: Partial custom app theme configuration object
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                Batch response:
                  description: Batch response
                  summary: Example batch update response with per-employer status
                  value:
                    employerStatuses:
                      - employerId: 01992ae8-efbb-7765-a6f1-a50bad7a2c65
                        status: success
                      - employerId: 01992ae8-efbb-7765-a6f1-a50bad7a2c64
                        error: Rate limit exceeded
                        status: failed
                    summary:
                      failed: 1
                      successful: 1
                      total: 2
                    theme:
                      custom_app_theme:
                        body:
                          color: '#000000'
                        buttons:
                          variants:
                            primary:
                              backgroundColor: '#0066cc'
              schema:
                $ref: '#/components/schemas/CustomAppThemeBatchResponse'
          description: Successfully updated custom app theme
        '404':
          description: No custom app theme found to update
      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

````