Skip to main content
POST

Authorizations

x-api-key
string
header
required

API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys

Body

file
file
required
binary
license_confirmed
boolean
required

Response

201 - application/json

Successful Response

A single font in the catalog: a shared system font, or one of the caller's own uploaded fonts.

uuid
string
required

Font id

Example:

"7f3a2b1c-9d4e-4a6f-b8c2-1e5d7a0c3f94"

family
string
required

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

Example:

"Open Sans"

postscript_name
string
required

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

Example:

"OpenSans-Regular"

is_system
boolean
required

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

Example:

true

subfamily
string | null

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

Example:

"Regular"

category
string | null

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

Example:

"sans-serif"

license
string | null

License identifier (system fonts)

Example:

"OFL"

is_premium
boolean
default:false

Whether this is a premium catalog font

preview_url
string | null

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

file_url
string | null

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.

Example:

"https://cdn.sudomock.com/mockup-assets/fonts/web/7f3a2b1c-9d4e-4a6f-b8c2-1e5d7a0c3f94.woff2"

created_at
string | null

When the font was added

Example:

"2026-07-13T09:14:22+00:00"