Skip to content

Page.create

POST /{namespace}/pages

Creates a Page.

Noun
Page
Mode
do
Event
Page.created

Create makes a new Page from the inputs below. It is inherited: every Noun has get, list, create, update and delete.

Inputs

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

Outputs

OutputTypeRequiredDescription
pagePagerequiredThe Page.

Effects

  • Emits Page.created.
  • Two-way: try, send, do.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.Page.create

When it waits

GateDefault
Decision classLow: two-way, nothing at stake
Delay windowNone: it runs once review passes.
LimitThe call Limit of the Permission it runs under.
Over the LimitIt waits pending for an Approval from the Founder. Approved, it runs; refused, it ends refused with limit-exceeded; unanswered by its deadline, it ends canceled.