Skip to main content
For builders

API documentation

Storyflo exposes a small, stable HTTP surface. The OpenAPI spec is the canonical reference — point any client generator or schema-aware agent at it. OAuth 2.1 + PKCE for user-scoped calls; x402 (USDC on Base) for metered tools.

Canonical specs

Common endpoints

  • GET /v1/articles/search — search the index
  • GET /v1/articles/:slug — fetch a single article
  • GET /v1/digest — personalized daily digest
  • POST /v1/subscribe — subscribe a listener to a topic
  • GET /v1/briefings/premium — x402-metered briefing

Coming soon

A hosted Redocly-rendered reference and TypeScript + Python SDKs. For now, the OpenAPI YAML is the source of truth and generates clean clients with any OpenAPI generator.