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
- OpenAPI: api.storyflo.com/.well-known/openai-app.yaml
- MCP manifest: api.storyflo.com/.well-known/mcp.json
- AgentKit / x402 tools: api.storyflo.com/.well-known/agentkit-tools.json
Common endpoints
GET /v1/articles/search— search the indexGET /v1/articles/:slug— fetch a single articleGET /v1/digest— personalized daily digestPOST /v1/subscribe— subscribe a listener to a topicGET /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.