Resources
List fonts
List the fonts uploaded to a workspace.
GET /api/fontsRequires assets:read. Only fonts uploaded to the workspace are listed, not the built-in library.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | Workspace slug or id. Note the parameter name differs from most endpoints. |
search | string | No | Case-insensitive match on the family name. |
page | number | No | Page number. Defaults to 1. |
limit | number | No | Items per page, 1 to 100. Defaults to 16. |
curl "https://app.kalpana.one/api/fonts?slug=acme&search=inter" \
--header "x-api-key: $KALPANA_API_KEY"Response
{
"fonts": [
{
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"scope": "workspace",
"workspaceId": "ws_123",
"family": "Inter",
"style": "Bold",
"weight": 700,
"italic": false,
"contentHash": "…",
"filename": "Inter-Bold.ttf",
"sizeBytes": 310200,
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"url": null
}
],
"total": 1,
"page": 1,
"limit": 16
}Fonts are ordered newest first. Internal storage fields are also present on each item and can be ignored; url is always null.
A template whose missingFonts names a family needs that family uploaded here before it renders as designed.
Errors
| Status | Cause |
|---|---|
403 | Your role or key lacks assets:read. |
Was this page helpful?
Updated 4 Nov 2026