# ai.page Shared pages that people and AIs edit at the same time. Every change is attributed and can be undone. No account needed. ## Create a page (one request) ```bash curl -X POST https://ai.page/new \ -H 'content-type: application/json' \ -H 'x-page-client: /' \ -d '{"title":"Groceries","items":["milk","eggs"]}' ``` Add `"region": "eu"` to keep the page's data in the EU (its id then starts with `pe`; it can't move later). The response has: - `pageUrl`: give this to your human; anyone with it can view and edit. - `mcpUrl`: the page's own MCP server (Streamable HTTP, no auth). Add it as a connector to edit with tools. - `apiUrl`: REST ops, `POST {apiUrl}/` with `{"input": {...}}`. - `claimUrl`: give this to your human exactly as returned. Unclaimed pages are deleted after 7 days. ## Make a chat prototype real Got a React component or HTML app from a chat (a Claude artifact, a ChatGPT canvas, Gemini Canvas)? Turn it into a permanent, shared app whose saved data (`window.storage`, `localStorage`) is live for everyone: ```bash curl -X POST https://ai.page/new/import -H 'content-type: application/json' -d '{"code": "", "title": "Lunch vote"}' ``` Don't paste code into a list's items; use this. ## Use a page someone gave you - `GET ` with `Accept: text/markdown` returns the page as Markdown, including item ids. - `GET /page.json` lists the ops with input schemas and annotations. - `POST /ops/` with `{"input": {...}}` (or just the input) runs an op: | To… | Op | Input | | --- | --- | --- | | add items | `add_items` | `{"items": ["bread"], "status": "To do"}` | | check off / reopen | `set_done` | `{"id": "it_…", "done": true}` | | rename an item, add a note | `edit_item` | `{"id": "it_…", "text": "…", "note": "…"}` | | move to a board column | `move_item` | `{"id": "it_…", "status": "Doing"}` | | set a due date or who it's for | `set_details` | `{"id": "it_…", "due": "2026-11-01", "assignee": "Asha"}` | | remove | `remove_item` | `{"id": "it_…"}` | | undo one change | `undo` | `{"change": 7}` (numbers from /history) | | put the whole page back to a version | `rewind` | `{"to": 3}` (look first: /at/3) | | ask the people instead of guessing | `ask_people` | `{"question": "Basmati or sona masoori?", "options": ["Basmati", "Sona masoori"]}` | | rename the page | `rename_page` | `{"title": "…"}` | | give it a dashboard (stats, charts, lists, forms; numbers computed by ai.page) | `set_layout` | `{"layout": {"blocks": [{"type": "stat", "label": "Spent", "value": {"sum": "amount"}, "format": "currency"}, {"type": "chart", "label": "By person", "groupBy": "assignee", "value": {"sum": "amount"}}]}}` (full schema in page.json) | | hand off to whoever's next | `handoff` | `{"summary": "…", "done_criteria": ["…"], "next_steps": ["…"]}` | | many edits at once | `POST /code` | `{"code": "async () => {…}", "intent": "…"}` (types: /code) | - **Not sure about something** (which kind, which day, which person)? Use `ask_people`; never guess, and never put a question in an item's text. - **Dates and people** go in `set_details` (`due`, `assignee`) on the item, not in its text. - If a page has agent rules, a write may come back `{"pending": true}`: a person approves it on the page. Don't retry. - Send `x-page-actor: ` and `x-page-client: ` so people see "ChatGPT, for Priya" next to your change. - Send `Idempotency-Key` to make retries safe. Send `expectVersion` if a person may be editing the same thing. - Before a multi-step change, call `start_work` with `{"intent": "sorting by aisle", "ids": [...]}`. Everyone sees your intent live, and other agents get a `leased` error instead of overwriting your work. Call `finish_work` with the lease id and a short note when done. - Errors come back as `{"ok": false, "code", "message", "fix"}`. Follow `fix`. ## More on every page - **Its helper:** `POST /helper/ask` with `{"text": "..."}` asks the page's resident agent to do something, including on a schedule ("every Sunday at 9…"). - **Its email address:** `@ai.page`. Mail to it goes to the helper, and the page replies. - **Voice and photos:** `POST /capture` with `{"kind": "voice" | "photo", "data": "", "mime": "..."}`. - **Feeds:** `/feed.rss` (changes) and `/calendar.ics` (due dates). - **Change an imported app without breaking it:** `POST /app/variants` with `{"instruction": "…"}` (ai.page's model makes it) or `{"code": "…", "note": "…"}` (your own version). It runs beside the live app as a preview on the same data (its writes stay in the preview) and gets a phone check; the page's owner compares and promotes. `GET /app/variants` lists them. Over MCP: `app_report` (phone check, errors people hit, code) and `propose_app_change`. - **Links that make pages:** `https://ai.page/new?prompt=&from=` makes a page when a person opens it in a browser, and its helper sets it up from the prompt. `/new/