List Fonts

List user's studio fonts

Info

Required scope: studio.read

Warning

This method requires authentication

Retrieve a list of studio fonts available to the authenticated user. Each font exposes one or more variants (weight + style combinations) and previews rendered by Studio.

Fonts can optionally be linked to a brand via the brandId field. When brandId is null, the font is part of the default catalog and available to all of the user's brands. Default catalog entries are flagged with isDefault: true.

curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/studio/fonts

Response

Success
Error
{
  "fonts": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "filename": "Inter-Regular.woff2",
      "family": "Inter",
      "brandId": null,
      "isDefault": true,
      "variants": [
        {
          "weight": 400,
          "style": "Normal",
          "localNames": ["Inter Regular", "Inter-Regular"],
          "sources": [
            {
              "url": "https://studio-assets.restream.io/fonts/inter/inter-regular.woff2",
              "format": "Woff2"
            }
          ]
        },
        {
          "weight": 700,
          "style": "Normal",
          "localNames": ["Inter Bold", "Inter-Bold"],
          "sources": [
            {
              "url": "https://studio-assets.restream.io/fonts/inter/inter-bold.woff2",
              "format": "Woff2"
            }
          ]
        }
      ],
      "previews": [
        {
          "orientation": "Landscape",
          "url": "https://studio-assets.restream.io/fonts/inter/preview-landscape.png",
          "width": 640,
          "height": 160
        }
      ]
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "filename": "BrandSans.ttf",
      "family": "Brand Sans",
      "brandId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "isDefault": false,
      "variants": [
        {
          "weight": 400,
          "style": "Normal",
          "localNames": [],
          "sources": [
            {
              "url": "https://studio-assets.restream.io/fonts/user/brand-sans.ttf",
              "format": "Ttf"
            }
          ]
        }
      ],
      "previews": []
    }
  ]
}