Pages

Create a page

POST
/pages

Create a public page as a draft inside a space. Flow: pages.create → pages.publish → pages.links_create → send the returned url → pages.submissions_list to read answers. Kind 'blocks' takes a block definition (headings, text, tables, downloads, fields, choices, uploads). Use {{ variable }} placeholders in texts and declare them under 'variables'; each link freezes its own values via 'context'. Kind 'live_document' shares a native live document by source_document_id; links with permissions.live = 'write' let visitors edit it in real time. Kind 'html' takes a self-contained HTML document in 'html' (max 5 MiB, rendered in a sandboxed frame without network access) plus an optional declaration: 'definition.fields' so window.adlass.submit(values) is validated and 'definition.data' (records and chart blocks by key) so the document can read them through window.adlass.records(key, {cursor, limit, q}) and window.adlass.chart(key, {days}); nothing else is reachable from the document. settings.chrome 'none' hides the header bar so the document owns the viewport. Read the pages guide for the bridge contract.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/pages" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "space_id": "123e4567-e89b-42d3-a456-426614174000",    "name": "Customer documents"  }'
{  "id": "123e4567-e89b-42d3-a456-426614174000",  "space_id": "123e4567-e89b-42d3-a456-426614174002",  "kind": "html",  "name": "Quarterly report",  "status": "PUBLISHED",  "source_type": "USER",  "source_id": null,  "current_version": {    "id": "123e4567-e89b-42d3-a456-426614174001",    "number": 3,    "content_hash": "3f786850e387550fdab836ed7e6dc881de23001b",    "created_at": "2026-09-04T12:00:00Z"  },  "submission_count": 0,  "link_count": 1,  "visit_count": 12,  "created_at": "2026-09-04T12:00:00Z",  "updated_at": "2026-09-04T12:00:00Z",  "source_document_id": null,  "source_metadata": {},  "draft_definition": {},  "draft_settings": {},  "draft_assets": [],  "created_by": {    "id": "123e4567-e89b-42d3-a456-426614174002",    "name": "Ada Lovelace",    "email": "ada@example.com"  }}