Sign Customiser

Navigation

Dark mode

Customiser sizes

Delete a size

Copy page

Removes the size and returns a deletion receipt: a snapshot of exactly what was removed, so the caller can verify and report the change. A size anything still references is refused with a 409 resource_in_use listing the referencing rows — fonts tied to it, and saved presets that chose it — and references are never silently cleared.

DELETE/api/v3/customisers/{customiser_id}/sizes/{size_id}
DELETEDelete a size
DELETE/api/v3/customisers/{customiser_id}/sizes/{size_id}

Delete a size

Removes the size and returns a deletion receipt: a snapshot of exactly what was removed, so the caller can verify and report the change. A size anything still references is refused with a 409 `resource_in_use` listing the referencing rows — fonts tied to it, and saved presets that chose it — and references are never silently cleared. Requires `customisers:write` and an `Idempotency-Key`; retrying the same request and key replays the original receipt after the row is gone. The delete 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

The Authorization header expects a Bearer token. Generate one on the API keys page in your dashboard.

Path

The customiser id.

The size id, from the list sizes operation.

Delete a size

Overview

Requires customisers:write and an Idempotency-Key; retrying the same request and key replays the original receipt after the row is gone. The delete 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: customisers:write

Path parameters

customiser_idstringpathrequired

The customiser id.

Example: 1

size_idstringpathrequired

The size id.

Example: 1

Delete a size
curl https://web.signcustomiser.com/api/v3/customisers/1/sizes/1 \
  --request DELETE \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
Response
{
  "data": {
    "object": "size_deletion_receipt",
    "id": 7,
    "customiser_id": 42,
    "deleted": true,
    "resource": {
      "object": "size",
      "id": 7,
      "customiser_id": 42,
      "name": "Small",
      "description": null,
      "char_limit": 12,
      "line_limit": 1,
      "min_char": 1,
      "width_cm": 40,
      "height_cm": null,
      "line_height_cm": 10,
      "length_cm": null,
      "width_multiplier": null,
      "sizing_strategy": "fixed_width",
      "height_measurement_mode": "line_height",
      "border_margin_cm": null,
      "sort_order": 1,
      "created_at": "2026-08-13T00:00:00Z",
      "updated_at": "2026-08-13T00:00:00Z"
    }
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/sizes/7",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}

Type a question and press Enter. Use the arrow keys to move between the results.