SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Change a website name, timezone, settings or refresh frequency

Send only the fields to change. Round-trip updated_at as expected_updated_at; a 409 STALE_VERSION means someone changed the site since you read it, so read it again before retrying.

PATCHhttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

namestring

Display name. Defaults to the domain.

timezonestring

IANA timezone for reporting. Defaults to UTC.

settings_jsonobject

brand_terms (string[]), thresholds, page_cap, query_page_cap.

refresh_frequencystring

daily, weekly or monthly.

expected_updated_atstring

The updated_at you last read.

Response

Response Body

idstringWebsite id. Use it as site_id in every other call.
namestringDisplay name.
domainstringBare domain the site is tracked under.
gsc_property_urlstring | nullSearch Console property bound to this site, or null when not connected. Reports and history imports need this.
gsc_connection_idstring | nullGoogle connection carrying the property.
gsc_connection_statusstring | nullState of that Google connection: active, reconnect_required or revoked. Null when none is linked. Returned by the list and get calls.
gsc_connection_activebooleanTrue only when the linked Google connection is active. When false the site stops refreshing and reports cannot start until the account is reconnected or the property is bound again. Returned by the list and get calls.
links_schedulestringHow often the website is read on its own: off, weekly or monthly.
links_last_run_atstring | nullWhen the website was last read on its own.
bing_connection_idstring | nullBing Webmaster connection used for link imports.
bing_site_urlstring | nullBing Webmaster site used for link imports.
timezonestringIANA timezone used for reporting.
statusstringactive, paused or archived.
refresh_frequencystringdaily, weekly or monthly automatic refresh.
last_refresh_atstring | nullWhen Search Console data was last refreshed.
settings_jsonobjectBrand terms, thresholds and caps that tune the detectors.
visibilitystringprivate, tenant or shared. A plain API key only sees tenant-wide sites; a connected app sees what its member sees.
created_byinteger | nullMember who added the site.
created_atstringCreation time.
updated_atstringRound-trip as expected_updated_at on PATCH to avoid overwriting a newer edit.

Request

curl --request PATCH \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id} \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "Acme Bakery",
"timezone": "Europe/London",
"settings_json": {
"brand_terms": [
"acme bakery"
]
},
"refresh_frequency": "daily"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"name": "Acme Bakery",
"domain": "acmebakery.co.uk",
"gsc_property_url": "sc-domain:acmebakery.co.uk",
"gsc_connection_id": null,
"gsc_connection_status": "active",
"gsc_connection_active": true,
"links_schedule": "off",
"links_last_run_at": null,
"bing_connection_id": null,
"bing_site_url": null,
"timezone": "Europe/London",
"status": "active",
"refresh_frequency": "daily",
"last_refresh_at": null,
"settings_json": {
"brand_terms": [
"acme bakery"
]
},
"visibility": "tenant",
"created_by": 12,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
}
}