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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# List workspace brands

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns every brand in a workspace, with the details a brand card shows. The list isn't paginated. Get a brand's full kit and design system with [Get workspace brand](/api-reference/get-workspace-brand).

`is_default` marks the workspace's default brand. The default brand is the one Base44 selects for you when you start a new app.

This is limited to 300 requests per minute, shared with [Get workspace brand](/api-reference/get-workspace-brand). A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as any member of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused even though this endpoint only reads, and workspace API keys aren't accepted.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/workspace/{workspace_id}/brands
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/workspace/{workspace_id}/brands:
    get:
      summary: List workspace brands
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns every brand in a workspace, with the details a brand card shows.
        The list isn't paginated. Get a brand's full kit and design system with
        [Get workspace brand](/api-reference/get-workspace-brand).


        `is_default` marks the workspace's default brand. The default brand is
        the one Base44 selects for you when you start a new app.


        This is limited to 300 requests per minute, shared with [Get workspace
        brand](/api-reference/get-workspace-brand). A signed-in session has its
        own limit, and every personal access token for the workspace shares one.
        Some workspaces have a different limit.


        <Note>Call this as any member of the workspace, with a personal access
        token for that workspace sent as a Bearer token, or from a signed-in
        session. A read-only token is refused even though this endpoint only
        reads, and workspace API keys aren't accepted.</Note>
      operationId: list_brands_api_workspace__workspace_id__brands_get
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the workspace. With a personal access token, use the token's
              workspace. Get it from `organization_id` in [Get
              app](/api-reference/get-app).
            title: Workspace Id
          description: >-
            ID of the workspace. With a personal access token, use the token's
            workspace. Get it from `organization_id` in [Get
            app](/api-reference/get-app).
          example: 67e0b12c4d8a3f005b21c9e4
      responses:
        '200':
          description: The workspace's brands.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceBrandList'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't a member of the workspace, your token is for a different
            workspace or is read-only, or your credential can't be used on this
            endpoint.
        '409':
          description: Your workspace requires an unlocked SSO session.
        '429':
          description: Rate limit exceeded.
components:
  schemas:
    WorkspaceBrandList:
      properties:
        items:
          items:
            $ref: '#/components/schemas/WorkspaceBrandCard'
          type: array
          title: Items
          description: Every brand in the workspace.
          example:
            - colors:
                - '#0B7A3B'
                - '#FAF7F2'
              fonts:
                - Fraunces
                - Inter
              id: 68e0c4a1b9d2f7003a5e1b42
              is_default: true
              logo_url: https://media.base44.com/images/public/nordwind-logo.png
              status: ready
              tagline: Furniture built to last
              title: Nordwind
      type: object
      required:
        - items
      title: WorkspaceBrandList
    WorkspaceBrandCard:
      properties:
        id:
          type: string
          title: Id
          description: ID of the brand.
          example: 68e0c4a1b9d2f7003a5e1b42
        title:
          type: string
          title: Title
          description: >-
            Title of the brand, from `kit.title`. `Generating…` while the brand
            is being generated.
          example: Nordwind
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
          description: >-
            URL of the brand's logo, from `kit.logo.url`. `null`, or an empty
            string, when the brand has none.
          example: https://media.base44.com/images/public/nordwind-logo.png
        is_default:
          type: boolean
          title: Is Default
          description: Whether this is the workspace's default brand.
          example: true
        tagline:
          anyOf:
            - type: string
            - type: 'null'
          title: Tagline
          description: >-
            The brand's `kit.tagLine`, or its `kit.description` when it has no
            tagline. `null` when it has neither.
          example: Furniture built to last
        colors:
          items:
            type: string
          type: array
          title: Colors
          description: >-
            Up to 5 colors from the design system's color tokens, in token
            order.
          example:
            - '#0B7A3B'
            - '#FAF7F2'
        fonts:
          items:
            type: string
          type: array
          title: Fonts
          description: >-
            Up to 2 font families from the design system, the heading font
            first.
          example:
            - Fraunces
            - Inter
        status:
          type: string
          enum:
            - generating
            - ready
            - failed
          title: Status
          description: >-
            `ready` once the brand is complete, `generating` while Base44 is
            still generating it, or `failed` if generation stopped. A brand that
            is still `generating` after 45 minutes without progress reads as
            `failed`.
          example: ready
        failure_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Failure Message
          description: >-
            Why generation failed, when it failed for a reason you can fix.
            `null` for any other brand, including one that failed for another
            reason.
          example: description is required
      type: object
      required:
        - id
        - title
        - logo_url
        - is_default
        - tagline
        - colors
        - fonts
        - status
        - failure_message
      title: WorkspaceBrandCard
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.