Skip to main content
Base URL: https://posy.page (or your own server). Everything edits the draft until you call publish.

​
Authentication

Create an API key on the Agents page of the dashboard (it is shown once) and send it as a bearer token:
OAuth 2 with the page:write scope also works; MCP clients use it automatically.

​
Reading a published page

No key needed:

​
Concurrency

PUT /api/v1/page takes a baseVersion. If the page changed since, you get 409 instead of overwriting newer edits.

​
Spec

The endpoints below are generated from /openapi.json. A copy lives in the repo at docs-site/api-reference/openapi.json; npm run docs:sync refreshes it. The full-page JSON Schema is at /schema/page.schema.json. The agent guide has curl examples and a CLI.