Site
A Site is a website as a Thing: its Pages, navigation, and Brand, served on one or more Domains.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
navigation | json | The menus that link its Pages. |
Inherited from Interface: 3 properties
| Property | Type | Required | Description |
|---|---|---|---|
kind | string | required | One of api, mcp, cli, sdk, site, app, docs, or webhooks. |
path | string | Where it is mounted on its Domain, such as /. | |
conformsTo | json | The Standards it also speaks, each mapping the Standard’s operations onto the Product’s Verbs. |
Object
{
"$id": "https: //api.sb/ shiftnote.app/ sites/ site_1",
"$type": "Site",
"kind": "api",
"path": "/",
"conformsTo": {
"standard": "openai-chat",
"operations": {
"chat.completions.create": "Listing.write"
}
},
"navigation": {}
}Relationships
- A Site contains many Pages: a Site serves its Pages, each at its own path.
contains, inversecontainedIn. - A Site is hosted at many Domains: a Site answers on one or more Domains; each Domain serves one Site.
hostedAt, inversehosts. - A Site includes one Portal: a Site includes one Portal, the signed-in part where each Customer sees only their own records.
includes, inverseincludedIn. - A Site is styled by one Brand: a Site renders one Brand’s name, voice and Theme.
styledBy, inversestyles. - A Site has many Visits: each Visit arrives on one Site.
visits, inverselands.
Verbs
createCreates a Site.POST /{namespace}/sitesgetReturns one Site by id.GET /{namespace}/sites/{id}listReturns Sites, newest first, one page at a time.GET /{namespace}/sitesupdateChanges the given properties of a Site.PATCH /{namespace}/sites/{id}deleteDeletes a Site; its history is kept.DELETE /{namespace}/sites/{id}publishPublish puts a Site’s current Pages live on its Domains, under its Brand.POST /{namespace}/sites/{site}/publish
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Site.create | Yes | Yes | Yes | No |
Site.get | Yes | Yes | Yes | Yes |
Site.list | Yes | Yes | Yes | Yes |
Site.update | Yes | Yes | Yes | No |
Site.delete | Yes | Yes | Yes | No |
Site.publish | Yes | Yes | Yes | No |
Call it
Publish the site “Algebra session”.Example
A home-inspector directory is a Site with home, city, inspector, and pricing Pages under one Brand, served on inspectfinder.com and www.inspectfinder.com.