Customiser icons

Reorder icons

Copy page

Sets the storefront presentation order of the customiser's icons. icon_ids must be the complete current membership of the family, each id exactly once, in the order to present them; a partial or stale list is refused with a 422 naming the missing, unknown, and duplicated ids rather than being partially applied.

POST/api/v3/customisers/{customiser_id}/icons/reorder

Reorder icons

Sets the storefront presentation order of the customiser's icons. `icon_ids` must be the complete current membership of the family, each id exactly once, in the order to present them; a partial or stale list is refused with a 422 naming the missing, unknown, and duplicated ids rather than being partially applied. Competing reorders of unchanged membership are last-write-wins. The generated icon font is untouched — a reorder changes presentation, not glyphs. Requires `customisers:write` and an `Idempotency-Key`. The reorder clears the customiser's cached storefront configuration and runs the advisory language sync, and never regenerates Shopify products, product images, or the product cache.

Reorder icons

Overview

Competing reorders of unchanged membership are last-write-wins. The generated icon font is untouched — a reorder changes presentation, not glyphs. Requires customisers:write and an Idempotency-Key. The reorder 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

Request body

icon_idsarraybody

Request body example

{
  "icon_ids": [
    12,
    9
  ]
}

Reorder icons

curl https://web.signcustomiser.com/api/v3/customisers/1/icons/reorder \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "icon_ids": [
    12,
    9
  ]
}'

{
  "data": [
    {
      "object": "icon",
      "id": 12,
      "customiser_id": 42,
      "name": "Star",
      "svg": "<svg viewBox=\"0 0 24 24\"><path d=\"M4 4h16v16H4z\"/></svg>",
      "rendered_svg": "<svg viewBox=\"0 0 24 24\"><path d=\"M4 4h16v16H4z\"/></svg>",
      "min_height_cm": 5,
      "icon_font": {
        "glyph_code": "f102",
        "font_family": "icon-font-a1b2c3d4",
        "ttf_url": "https://cdn.signcustomiser.com/icon-fonts/icons.ttf"
      },
      "sort_order": 1,
      "created_at": "2026-08-13T00:00:00Z",
      "updated_at": "2026-08-13T00:05:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/icons/reorder",
    "documentation": "https://www.signcustomiser.com/help/api/",
    "next": null
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}

{
  "type": "https://www.signcustomiser.com/help/api/problems/missing_idempotency_key",
  "title": "Missing idempotency key",
  "status": 400,
  "code": "missing_idempotency_key",
  "detail": "Provide an Idempotency-Key header for this write.",
  "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 customisers:write scope.",
  "required_scopes": [
    "customisers:write"
  ],
  "granted_scopes": [
    "customisers: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/reorder_membership_mismatch",
  "title": "Reorder membership mismatch",
  "status": 422,
  "code": "reorder_membership_mismatch",
  "detail": "A reorder must list the complete current membership of the family exactly once each.",
  "errors": [
    {
      "pointer": "/icon_ids",
      "code": "reorder_membership_mismatch",
      "detail": "The submitted ids do not match the family membership exactly once each."
    }
  ],
  "missing_ids": [
    12
  ],
  "unknown_ids": [
    88
  ],
  "duplicate_ids": [],
  "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"
}