Retrieve a widget theme

get/v1/widget/presets/{presetId}

One saved widget theme.

Private keyapi.v1.widget.presets.retrieveNo demo

Path parameters

presetIdstring (uuid)required

The theme's id.

Response

200The theme.

WidgetPresetrequired

A saved widget theme, as stored.

idstring (uuid)required

Pass it to the embed, or to preflight, as themeId.

namestringrequired

Shown in the theme builder.

objectrequired

The colours, grouped as stored.

createdstring (date-time)required

When it was saved first.

modifiedstring (date-time)required

When it was last changed.

Errors

Every error is JSON with a single error string unless noted. Match on the status code; the message is for humans.

404

Widget preset not found: <presetId>

No theme with this id belongs to the key's organization.

curl -X GET "https://stylor.ai/api/v1/widget/presets/YOUR_PRESET_ID" \
  -H "Authorization: Bearer $STYLOR_API_KEY"

Response · 200

{
  "preset": {
    "id": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
    "name": "Ranch",
    "options": {
      "button": {
        "label": "Ask a stylist",
        "color": "#2D2926",
        "hoverColor": "#000000",
        "textColor": "#FFFFFF"
      },
      "widget": {
        "typingDotColor": "#999999",
        "accentColor": "#B5651D",
        "accentHoverColor": "#8A4B12",
        "mutedTextColor": "#6B6B6B",
        "primaryTextColor": "#2D2926",
        "pageColor": "#FBF8F3",
        "surfaceColor": "#FFFFFF",
        "borderColor": "#E6E1DA",
        "inputColor": "#F3EFE9",
        "footerColor": "#FBF8F3",
        "roundness": 60
      }
    },
    "created": "2026-10-04T18:20:03.001Z",
    "modified": "2026-10-04T18:20:03.001Z"
  }
}