Playbooks
Opinionated recipes: what to call, in what order, with a dry run before anything changes.
Hygiene before publish
Audit, dry run, human OK, apply, re-audit. Never publish from the agent.
- 1Audit contentRun the content audit to build the fix list.
- 2Audit mediaCheck alt text, titles, and folders.
- 3Dry-run fixesSee every proposed change without applying it.
- 4ApplyApply only what you approved.
- 5Re-auditCheck the result and update the list.
Ship a landing page
List and get the guide, shape its blocks, link places and stories, then hygiene-check.
- 1Find the landing pageList guides and open the one you want.
- 2Edit blocksShape the content blocks.
- 3Link placesAttach places and stories.
- 4Related postsLink related posts.
- 5AuditRun the hygiene check.
Connect MCP
Wire Claude, Cursor, or Gemini with OAuth or an API key over SSE (or Streamable HTTP for Gemini).
- 1Pick the clientClaude and Cursor use SSE. Gemini uses Streamable HTTP at /mcp.
- 2Paste the connector URL or create a keyOAuth needs no key. Keys live under Developers in the app.
- 3Smoke-testAsk: List my Roami projects.
Call the API
Public blog reads and protected CMS writes. Know which path you need.
- 1Choose public or protectedReads are public. Writes need a key.
- 2Use a bearer keySend your key as a bearer token or x-api-key.
- 3Check the envelopeRead the response shape before you rely on it.
Build a public site
Hand another AI the OpenAPI document and a prompt. Public GET only, with no keys in the frontend.
- 1Copy the promptStart from the provided prompt in Developers.
- 2Import the OpenAPI documentGive it to your AI.
- 3GET /api/publicRead posts from the public endpoints.
- 4Smoke-testCheck the output before you build more.
Connect your agent and see the first draft
Free during beta. No card. Agents cannot publish.