Documentation

Update a site

PATCH/v1/sites/:id

Auth: Secret API key (rk_sk_)

Update site name, domain, or widget config. Bumps configVersion for live widget refresh.

Path parameters

NameTypeDescription
idrequireduuidSite ID

Body parameters

NameTypeDescription
namestringDisplay name
domainstringPrimary domain
widgetConfigobjectWidget configuration

Responses

200Updated site
{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "name": "My Store",
  "domain": "store.example.com",
  "publicKey": "rk_pk_live_abc123",
  "createdAt": "2026-01-01T00:00:00Z"
}