Fonts

Create a new font

Upload a custom TTF or OTF font (Pro plan and above). Send either a multipart 'file' or a JSON body with a public 'url'. The font is validated and security-checked before it is stored.

post/api/v1/fonts

Request

  • Base URL: https://api.sudomock.com
  • URL: https://api.sudomock.com/api/v1/fonts
  • Auth: API key in header x-api-key

Request body

urlstring required

Public URL of a TTF or OTF font file to fetch

license_confirmedboolean

Confirmation that you have the right to use and embed this font. Required.

Example request

{
  "license_confirmed": true,
  "url": "https://example.com/fonts/MyBrand-Bold.ttf"
}

Response

Successful Response

uuidstring required

Font id

familystring required

Font family name, e.g. 'Open Sans'

subfamilystring nullable

Style within the family, e.g. 'Bold Italic'

postscript_namestring required

PostScript name, the stable key used to reference this font when rendering text layers

categorystring nullable

Catalog category, e.g. 'sans-serif', 'serif', 'display'

licensestring nullable

License identifier (system fonts)

is_premiumboolean

Whether this is a premium catalog font

is_systemboolean required

True for the shared system catalog, False for a font you uploaded

preview_urlstring nullable

Legacy rendered preview image, when available; new catalog entries no longer include one (use file_url for live previews)

file_urlstring nullable

URL of the web-optimized WOFF2 file for live @font-face preview: a public CDN URL for system fonts, a short-lived link for your own uploads. Null for premium fonts; the original TTF/OTF source is never exposed.

created_atstring nullable

When the font was added

Example response

{
  "category": "sans-serif",
  "created_at": "2026-07-13T00:00:00+00:00",
  "family": "Open Sans",
  "file_url": "https://cdn.sudomock.com/mockup-assets/fonts/web/9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f.woff2",
  "is_premium": false,
  "is_system": true,
  "license": "OFL",
  "postscript_name": "OpenSans-Regular",
  "subfamily": "Regular",
  "uuid": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "preview_url": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.