List the workspace websites, most recently changed first.

Use it to find a website id. Each row carries content_version and who last edited it.

GEThttps://app.softsolz.uk/api/v1/services/site-builder/projects

Recent Requests

TimeStatusUser Agent

Make a request to see history.

Headers

Authorizationstringrequired

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

Query Params

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Pagination offset (default 0).

Response

Response Body · array of objects

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

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.siteBuilder.listProjects({});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
  "data": [
    {
      "id": 0,
      "name": "string",
      "slug": "string",
      "site_address": "string",
      "description": "string",
      "language": "string",
      "status": "string",
      "live_url": "string",
      "published_at": "string",
      "created_at": "string",
      "updated_at": "string",
      "preview_url": "string",
      "logo_path": "string",
      "starter_id": "string",
      "has_unpublished_changes": true,
      "file_count": 0,
      "verified_domains": 0,
      "memory": "string",
      "design_system": "string",
      "content_version": "string",
      "last_edited_via": "string",
      "last_edited_label": "string",
      "domains": []
    }
  ]
}