Sites / Update site

Update site

PATCH/v1/sites/{id}

Partially update a site. Send only the fields you want to change. domain must be a bare origin (https://example.com) with no path, query, or trailing slash.

Path parameters

string · required

The site id.

Body parameters

name

string

New label.

domain

string

New canonical origin, or null to clear it.

timezone

string

New IANA timezone.

Response fields

string

Prefixed identifier, e.g. site_29Et…. Use this in URLs.

name

string

Human-friendly label. Defaults to My Website.

domain

string | null

Canonical origin, e.g. https://northwind.com. null until set.

timezone

string

IANA timezone. Defaults to America/New_York.

site_key

string

Short public key used in the install snippet. Not the same as id.

created_at

timestamp

When the site was created.

Setting domain controls which origins the tracking snippet accepts. A null domain means no origins are allowed, so the snippet rejects everything.

PATCH/v1/sites/{id}

curl -X PATCH https://app.converly.io/api/v1/sites/site_29Et… \
  -H "Authorization: Bearer sk_live_…" \
  -d '{ "name": "Northwind EU" }'

200 OK

{
  "id": "site_29Et…",
  "name": "Northwind EU",
  "domain": "https://northwind.com",
  "timezone": "America/New_York",
  "site_key": "site_1VQH84sr"
}