Makeswift Docs

curl -X POST https://api.makeswift.com/v4/typographies \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "siteId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Heading 1",
  "style": [
    {
      "deviceId": "desktop",
      "value": {
        "color": {
          "swatchId": "8a1f3c2d-5b6e-4f7a-9c0d-1e2f3a4b5c6d",
          "alpha": 1
        },
        "fontFamily": "Inter",
        "fontSize": {
          "value": 48,
          "unit": "px"
        },
        "fontWeight": 500,
        "lineHeight": 2
      }
    },
    {
      "deviceId": "mobile",
      "value": {
        "fontSize": {
          "value": 32,
          "unit": "px"
        }
      }
    }
  ]
}'

{
  "id": "2f3c9a1e-8b47-4d6a-9c1e-5a7b3d2f8e91",
  "referenceId": "VHlwb2dyYXBoeToyZjNjOWExZS04YjQ3LTRkNmEtOWMxZS01YTdiM2QyZjhlOTE=",
  "name": "Heading 1",
  "style": [
    {
      "deviceId": "desktop",
      "value": {
        "color": {
          "swatchId": "8a1f3c2d-5b6e-4f7a-9c0d-1e2f3a4b5c6d",
          "alpha": 1
        },
        "fontFamily": "Inter",
        "fontSize": true,
        "fontWeight": 500,
        "lineHeight": 2
      }
    },
    {
      "deviceId": "mobile",
      "value": {
        "fontSize": true
      }
    }
  ],
  "siteId": "123e4567-e89b-12d3-a456-426614174000"
}

This feature is in Beta and may change. Requests return 403 until the feature flag is enabled for your site or workspace.

Creates a site owned typography.

Authentication

x-api-keystring

API key authentication. Accepts either:

App API key (e.g. sk_eczMHVBY9fV6GYFhvs53qcnxq7yptlXL3ABKOZtn6dQ)
Site API key (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)

API key authentication. Accepts either: - App API key (e.g. sk_eczMHVBY9fV6GYFhvs53qcnxq7yptlXL3ABKOZtn6dQ) - Site API key (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)

Request

This endpoint expects an object.

siteIdstringRequiredformat: "uuid"

The site ID to create the typography on.

namestringRequired>=1 character

The name of the typography.

stylelist of objectsRequired

Per-device style overrides. A “color” references an existing swatch by its “id” in “swatchId” (create one with the Swatch API first); omit or null it for no swatch. “alpha” (0-1) sets opacity.

Response

idstringformat: "uuid"

referenceIdstring

The id to use wherever a text element references this typography (e.g. the “id” field of a Text element’s “typography” prop in a page’s element data) - NOT the plain “id” field above, which is used as the typography identifier in other REST typography api calls.

namestring

stylelist of objects

siteIdstringformat: "uuid"

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error