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

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

Returns the workspace's fonts, newest first. The list isn't paginated. A workspace has at most 256 fonts.

Workspace fonts are font files the workspace uploaded, which every app in the workspace can use. Each font is one weight and style of a family, so a family with a regular and a bold weight is two fonts.

Fonts belong to the workspace your credential is for. With a personal access token, that's the token's workspace, and there's no parameter to choose another one.

This is limited to 120 requests per minute, shared with [Get workspace font](/api-reference/get-workspace-font). Some workspaces have a different limit.

<Note>Call this as a member of the workspace, with a personal access token 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/fonts
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/fonts:
    get:
      summary: List workspace fonts
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns the workspace's fonts, newest first. The list isn't paginated. A
        workspace has at most 256 fonts.


        Workspace fonts are font files the workspace uploaded, which every app
        in the workspace can use. Each font is one weight and style of a family,
        so a family with a regular and a bold weight is two fonts.


        Fonts belong to the workspace your credential is for. With a personal
        access token, that's the token's workspace, and there's no parameter to
        choose another one.


        This is limited to 120 requests per minute, shared with [Get workspace
        font](/api-reference/get-workspace-font). Some workspaces have a
        different limit.


        <Note>Call this as a member of the workspace, with a personal access
        token 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_fonts_api_fonts_get
      parameters:
        - name: family_name
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Keep only the fonts in this family, matched exactly but ignoring
              case. A name longer than 100 characters matches nothing.
            title: Family Name
          description: >-
            Keep only the fonts in this family, matched exactly but ignoring
            case. A name longer than 100 characters matches nothing.
          example: Acme Sans
      responses:
        '200':
          description: The workspace's fonts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceFontList'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't a member of the workspace, your token 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:
    WorkspaceFontList:
      properties:
        items:
          items:
            $ref: '#/components/schemas/WorkspaceFont'
          type: array
          title: Items
          description: The workspace's fonts, newest first.
          example:
            - created_by: dana@acme.com
              created_date: '2026-09-02T11:24:05.311000'
              display_family_name: Acme
              family_name: Acme Sans
              id: 68d4b2e1f0a9c8001b3e5f27
              public_url: >-
                https://media.base44.com/files/public/workspaces/67e0b12c4d8a3f005b21c9e4/fonts/3f9a1c2e_68d4b2e1f0a9c8001b3e5f27.woff2
              style: normal
              weight: 400
        total:
          type: integer
          title: Total
          description: Number of fonts in `items`.
          example: 1
      type: object
      required:
        - items
        - total
      title: WorkspaceFontList
    WorkspaceFont:
      properties:
        id:
          type: string
          title: Id
          description: ID of the font.
          example: 68d4b2e1f0a9c8001b3e5f27
        family_name:
          type: string
          title: Family Name
          description: >-
            Family name, read from the font file. Use it as the CSS
            `font-family`.
          example: Acme Sans
        display_family_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Family Name
          description: >-
            The broader family the font file says it belongs to, which groups
            stylistic variants such as an inline cut, or `null` when the file
            doesn't say.
          example: Acme
        variant_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Variant Name
          description: >-
            Name of the stylistic variant, or `null` when the file doesn't name
            one.
          example: Inline
        weight:
          type: integer
          title: Weight
          description: Weight from 1 to 1000, usually a multiple of 100.
          example: 400
        style:
          type: string
          enum:
            - normal
            - italic
          title: Style
          description: Style of the font.
          example: normal
        public_url:
          type: string
          title: Public Url
          description: Public URL of the font as a WOFF2 file, for an `@font-face` `src`.
          example: >-
            https://media.base44.com/files/public/workspaces/67e0b12c4d8a3f005b21c9e4/fonts/3f9a1c2e_68d4b2e1f0a9c8001b3e5f27.woff2
        created_by:
          type: string
          title: Created By
          description: Email of the member who uploaded the font.
          example: dana@acme.com
        created_date:
          type: string
          title: Created Date
          description: When the font was uploaded, as a UTC timestamp in ISO 8601 format.
          example: '2026-09-02T11:24:05.311000'
      type: object
      required:
        - id
        - family_name
        - display_family_name
        - variant_name
        - weight
        - style
        - public_url
        - created_by
        - created_date
      title: WorkspaceFont
      description: 'One uploaded font: a single weight and style of a family.'
  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.