Customiser font tiers

Update a font tier

Copy page

Applies an RFC 7396 JSON Merge Patch to one font tier: properties omitted from the body are unchanged. rows is an array, so sending it replaces every row wholesale. Read-only and unknown fields are rejected.

PATCH/api/v3/customisers/{customiser_id}/font-tiers/{font_tier_id}

Update a font tier

Applies an RFC 7396 JSON Merge Patch to one font tier: properties omitted from the body are unchanged. `rows` is an array, so sending it replaces every row wholesale. Read-only and unknown fields are rejected. An empty object `{}` is a valid no-op. Requires `pricing:write`. One exception to wholesale replacement protects per-position pricing: a row resent without `letter_price_by_position` keeps the schedule its size already had, because dropping a schedule by forgetting to echo it would silently reprice a sign. Send `letter_price_by_position: null` to clear one deliberately. An `Idempotency-Key` is optional here: sending one makes the update safe to retry (an exact repeat replays the original response; the same key with a different body is a 409). The update clears the customiser's cached storefront configuration and runs the advisory language sync, and never regenerates Shopify products, product images, or the product cache.

Update a font tier

Overview

An empty object {} is a valid no-op. Requires pricing:write. One exception to wholesale replacement protects per-position pricing: a row resent without letter_price_by_position keeps the schedule its size already had, because dropping a schedule by forgetting to echo it would silently reprice a sign. Send letter_price_by_position: null to clear one deliberately. An Idempotency-Key is optional here: sending one makes the update safe to retry (an exact repeat replays the original response; the same key with a different body is a 409). The update clears the customiser's cached storefront configuration and runs the advisory language sync, and never regenerates Shopify products, product images, or the product cache.

Authorisation

Bearer token required. Include it in the Authorization header.

Required scope: pricing:write

Path parameters

customiser_idstringpathrequired

The customiser id.

Example: 1

font_tier_idstringpathrequired

The font tier id.

Example: 1

Request body

namestringbody

rowsarraybody

Request body example

{
  "name": "Standard",
  "rows": [
    {
      "size_id": 3,
      "base_price": {
        "line_1": 2600,
        "line_2": 3000,
        "line_3": 3500
      },
      "letter_price": {
        "line_1": 400,
        "line_2": 450,
        "line_3": 500
      }
    }
  ]
}

Update a font tier

curl https://web.signcustomiser.com/api/v3/customisers/1/font-tiers/1 \
  --request PATCH \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Standard",
  "rows": [
    {
      "size_id": 3,
      "base_price": {
        "line_1": 2600,
        "line_2": 3000,
        "line_3": 3500
      },
      "letter_price": {
        "line_1": 400,
        "line_2": 450,
        "line_3": 500
      }
    }
  ]
}'

{
  "data": {
    "object": "font_tier",
    "id": 7,
    "customiser_id": 42,
    "name": "Standard",
    "letter_pricing_mode": "every_letter_cost",
    "currency": "USD",
    "rows": [
      {
        "size_id": 3,
        "base_price": {
          "line_1": 2600,
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "line_5": null,
          "line_6": null,
          "line_7": null,
          "line_8": null,
          "line_9": null,
          "line_10": null
        },
        "letter_price": {
          "line_1": 400,
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "line_5": null,
          "line_6": null,
          "line_7": null,
          "line_8": null,
          "line_9": null,
          "line_10": null
        },
        "letter_price_by_position": null
      }
    ],
    "created_at": "2026-08-13T00:00:00Z",
    "updated_at": "2026-08-13T00:05:00Z"
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/font-tiers/7",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/malformed_json",
  "title": "Malformed JSON",
  "status": 400,
  "code": "malformed_json",
  "detail": "The request body is not valid JSON: Syntax error.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
  "title": "Missing API key",
  "status": 401,
  "code": "missing_api_key",
  "detail": "Provide a store API key as a bearer token.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "This operation requires the pricing:write scope.",
  "required_scopes": [
    "pricing:write"
  ],
  "granted_scopes": [
    "pricing:read"
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
  "title": "Resource not found",
  "status": 404,
  "code": "resource_not_found",
  "detail": "The requested resource does not exist or does not belong to the authenticated store.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/idempotency_key_conflict",
  "title": "Idempotency key conflict",
  "status": 409,
  "code": "idempotency_key_conflict",
  "detail": "This Idempotency-Key was already used for a different request body on this operation.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/request_too_large",
  "title": "Request too large",
  "status": 413,
  "code": "request_too_large",
  "detail": "The request body must not exceed 2 MiB.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/validation_failed",
  "title": "Validation failed",
  "status": 422,
  "code": "validation_failed",
  "detail": "The request payload failed validation.",
  "errors": [
    {
      "pointer": "/tiers",
      "code": "prohibited",
      "detail": "The tiers field is read-only and cannot be sent on a write."
    }
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "You have exceeded the request limit for this API key.",
  "retry_after": 37,
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}