openapi: 3.1.0
info:
  title: Salesforce Experience Cloud Salesforce CMS Connect Actions Branding Sets API
  description: Manage content, channels, and media in Experience Cloud CMS. Supports creating, updating, and delivering managed content across channels for headless content delivery and site publishing. Part of the Salesforce Connect REST API.
  version: 59.0.0
  contact:
    name: Salesforce Developer Support
    url: https://developer.salesforce.com/
  license:
    name: Salesforce Master Subscription Agreement
    url: https://www.salesforce.com/company/legal/sfdc-website-terms-of-service/
servers:
- url: https://{instance}.salesforce.com/services/data/v59.0/connect/cms
  description: Salesforce Instance
  variables:
    instance:
      default: yourInstance
      description: Your Salesforce instance name or custom domain
security:
- oauth2: []
- bearerAuth: []
tags:
- name: Branding Sets
  description: Branding set management
paths:
  /connect/communities/{communityId}/branding-sets:
    get:
      operationId: listBrandingSets
      summary: Salesforce Experience Cloud List Branding Sets
      description: Returns the branding sets configured for the specified Experience Cloud site. Branding sets define reusable visual property groups for colors, fonts, and images.
      tags:
      - Branding Sets
      parameters:
      - $ref: '#/components/parameters/CommunityId'
      responses:
        '200':
          description: Successfully retrieved branding sets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandingSetCollection'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /connect/communities/{communityId}/branding-sets/{brandingSetId}:
    get:
      operationId: getBrandingSet
      summary: Salesforce Experience Cloud Get a Branding Set
      description: Returns the details of a specific branding set including all its property values for colors, fonts, and image references.
      tags:
      - Branding Sets
      parameters:
      - $ref: '#/components/parameters/CommunityId'
      - name: brandingSetId
        in: path
        required: true
        description: The ID of the branding set
        schema:
          type: string
      responses:
        '200':
          description: Successfully retrieved branding set
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandingSet'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    patch:
      operationId: updateBrandingSet
      summary: Salesforce Experience Cloud Update a Branding Set
      description: Updates the properties of an existing branding set. Only the properties included in the request are updated.
      tags:
      - Branding Sets
      parameters:
      - $ref: '#/components/parameters/CommunityId'
      - name: brandingSetId
        in: path
        required: true
        description: The ID of the branding set
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BrandingSetInput'
      responses:
        '200':
          description: Branding set updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandingSet'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ErrorResponse'
  schemas:
    BrandingProperty:
      type: object
      description: A property within a branding set
      properties:
        name:
          type: string
          description: Property name (e.g., primaryColor, headerFont)
        type:
          type: string
          description: Property type
          enum:
          - Color
          - Font
          - Image
          - String
        value:
          type: string
          description: Property value
    BrandingSet:
      type: object
      description: A branding set with visual properties
      properties:
        id:
          type: string
          description: Branding set ID
        name:
          type: string
          description: Name of the branding set
        description:
          type: string
          description: Description of the branding set
        properties:
          type: array
          description: Branding properties
          items:
            $ref: '#/components/schemas/BrandingProperty'
    BrandingSetInput:
      type: object
      description: Input for updating a branding set
      properties:
        name:
          type: string
          description: Updated name
        description:
          type: string
          description: Updated description
        properties:
          type: array
          description: Updated properties
          items:
            $ref: '#/components/schemas/BrandingProperty'
    BrandingSetCollection:
      type: object
      description: Collection of branding sets
      properties:
        brandingSets:
          type: array
          items:
            $ref: '#/components/schemas/BrandingSet'
        total:
          type: integer
    ErrorResponse:
      type: object
      description: Standard error response
      properties:
        errorCode:
          type: string
        message:
          type: string
  parameters:
    CommunityId:
      name: communityId
      in: path
      required: true
      description: The ID of the Experience Cloud site
      schema:
        type: string
  securitySchemes:
    oauth2:
      type: oauth2
      description: Salesforce OAuth 2.0 authentication
      flows:
        authorizationCode:
          authorizationUrl: https://login.salesforce.com/services/oauth2/authorize
          tokenUrl: https://login.salesforce.com/services/oauth2/token
          scopes:
            api: Access and manage your data
            content: Manage CMS content
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
      description: Bearer token obtained through OAuth 2.0 flow