Skip to content

Page.create

Adds a page to your Site at a path, such as `/rent-ledger-template`.

Action class
None
Approval
Runs on its own
Emits
Page.created
Price
Free
POST https://api.sb/{your-domain}/pages

Adds a page to your Site at a path, such as /rent-ledger-template.

It extends the hub’s record call Page.create, which every page takes. It is one of the Verbs of Sites and content.

Inputs

NameTypeMeaning
pathstringRequired. The path under its Site, such as /pricing.
kindstringThe page type, such as landing, pricing, or terms. Optional.
fromstringLineage: the slot it compiles from, as Hypothesis#<slot>@v<version>. Optional.
siteSiteA Site serves its pages, each at its own path. Optional.
templateTemplateA Template fills one page per Thing or per member of a Collection. Optional.

The hub inherits this call on every Noun: it takes the page’s own Properties, listed on the hub’s page page.

Outputs

FieldTypeWhat null means
pagePageNever null: the page as the call leaves it.

Effects

Action class

None: no approval rule names it, so it runs within its seat’s Permissions and Limits

Modes
  • try: Runs every check and returns the record as it would be; nothing is stored.
  • send: Returns a pending Action at once; Page.created fires when it is done.
  • do: Waits for the Action to finish and returns the record.
Idempotency

Only with a key: the same Idempotency-Key and input return the first Action, and the same key with other input returns 409.

Saved or shared

The page is saved as the call leaves it, with the Action that changed it.

Emits

Page.created with { page }

Performed by

Whichever seat calls it

Price

Free on your own account: the platform charges nothing for the call.

On each Venue

It acts on your own records and reaches no Venue, so every account answers the same way.

What try does

Runs every check the call meets and returns the record as it would be; nothing is stored, sent or posted.

Refuses when

The hub sets no guard of its own on this call: it refuses only on the shared checks every write meets (a missing record, a Permission the seat lacks).

When it waits

Returns in one response; nothing waits.

Example

In send mode the call returns its pending Action at once, and Page.created delivers the result.

You, to your agent
Add a page at /rent-ledger-template.
Response, in send mode
{
  "mode": "send",
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/action_Sd3kQ9vT2w",
    "operation": "Page.create",
    "status": "pending",
    "reason": "running"
  }
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

Used by

None.