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.
PATCH
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
namestringDisplay name. Defaults to the domain.
timezonestringIANA timezone for reporting. Defaults to UTC.
settings_jsonobjectbrand_terms (string[]), thresholds, page_cap, query_page_cap.
refresh_frequencystringdaily, weekly or monthly.
expected_updated_atstringThe 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" }}