Pages
Pages are document-style layouts built from pins—a readable, scrollable surface for reports, playbooks, runbooks, and living documentation.
When to use pages
- Compiled narratives — Stack briefs, tables, charts, and checklists in reading order.
- Client deliverables — Share a single URL with a clear top-to-bottom story.
- Internal docs — Keep operational knowledge next to live data pins.
Key features
- Pin sections — Add, reorder, and remove pins (sidebar reorder on desktop).
- Role-based access — Page-level and per-pin role requirements.
- Share controls — Public links, sign-in requirements, comments.
- Living data — Underlying pins update in place; the page reflects API pushes automatically.
How pages relate to pins
Create and update pin content with the Pins API, then attach pins to a page in the dashboard—or compose the page with the workspace agent.
IDs & routes
- ID prefix:
pg… - Dashboard:
/pages/[pageId] - Share:
/share/page/[pageId]
API
| Resource | Status |
|---|---|
/v1/pages | REST (Workspace auth) — create, list, update, pin membership |
| Pin content | Pins API (/v1/pins) |
Related
- Pins · Pin Types & Schemas
- Articles — Long-form publishing with public author handles