Rename a website or change its description or language
Only the given keys change. Changing language rewrites the html lang attribute of every page (the copy itself is yours to update with files/apply) and marks the site as having unpublished changes. 409 STALE_VERSION when expected_updated_at is stale.
https://app.softsolz.uk/api/v1/services/site-builder/projects/{id}Recent Requests
Kept only in this browserPath Params
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
namestringNew name.
descriptionstringNew description.
languagestringBCP 47 language tag the site is written in (en, en-GB, fr, pt-BR). Defaults to the workspace locale. It is written as the html lang attribute of every page.
expected_updated_atstringOptimistic guard: the updated_at you last read.
Response
Response Body
idintegerWebsite id. Use it as {id} in every project call.namestringWebsite name shown in the dashboard.slugstringURL-safe name, unique per workspace.site_addressstring | nullThe subdomain label the site publishes under.descriptionstring | nullWhat the website is for, as the person described it.languagestringBCP 47 language tag of the site copy, also written as the html lang attribute.statusstringPublish state.live_urlstring | nullPublic URL once published.published_atstring | nullWhen the site was last published.created_atstringCreation timestamp.updated_atstringLast change to the project record. Round-trip as expected_updated_at on PATCH.preview_urlstringAbsolute signed preview URL for the home page (valid about 6 hours).logo_pathstring | nullPath of the uploaded logo under assets/.starter_idstring | nullStarter template the site began from.has_unpublished_changesbooleantrue when files changed since the last publish.file_countinteger | nullNumber of files (list view only).verified_domainsinteger | nullVerified custom domains (list view only).memorystring | nullNotes about the business and design decisions kept with the site.design_systemobject | nullSummary of the design system (style, colors, typography, radius, shadow, spacing) or null.content_versionstring | nullOpaque version of the site files. Send it as expected_version on files/apply to refuse a write over a newer change.last_edited_viastring | nullWho last changed the files: dashboard, chat, api or connected_app.last_edited_labelstring | nullThe app or key name behind the last change.domainsarray of objectsCustom domains (single-project view only).Request
curl --request PATCH \ --url https://app.softsolz.uk/api/v1/services/site-builder/projects/{id} \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "name": "Northwind Bakery", "description": "Artisan bakery in Leeds.", "language": "en-GB"}'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": 42, "name": "Northwind Bakery", "slug": "northwind-bakery", "site_address": "northwind-bakery", "description": "Artisan bakery in Leeds with online ordering.", "language": "en-GB", "status": "draft", "live_url": null, "published_at": null, "created_at": "2026-09-17T09:30:00.000Z", "updated_at": "2026-09-17T09:30:00.000Z", "preview_url": "https://app.softsolz.uk/api/services/site-builder/preview/42/1789000000-abc/index.html", "logo_path": null, "starter_id": null, "has_unpublished_changes": true, "file_count": 5, "verified_domains": 0, "memory": "Palette: warm cream and terracotta. Fonts: Fraunces + Inter.", "design_system": null, "content_version": "2026-09-17T09:30:00.000Z", "last_edited_via": "connected_app", "last_edited_label": "Claude", "domains": [] }}