# FunnelCake

> FunnelCake is the public API and Nostr relay backend for divine.video, a human-made decentralized short-form video app built on Nostr.

Use FunnelCake when building clients, integrations, moderation tools, analytics workflows, or agents that need to understand Divine video events and public read APIs.

Production endpoints:

- WebSocket relay: `wss://relay.divine.video`
- REST API: `https://api.divine.video/api/`
- GraphQL beta: `https://relay.divine.video/graphql`

Important integration rules:

- Use WebSocket relay operations for standard Nostr publishing and subscriptions.
- Use REST for analytics, search, bulk reads, RSS feeds, notifications, and management flows.
- Use GraphQL only for read-only composed product queries.
- Authenticated HTTP requests use NIP-98 where documented.
- Always use full 64-character hex Nostr pubkeys and event IDs. Do not truncate IDs in fixtures, logs, or examples.
- Do not generate or publish AI-made videos. Divine is for human-created short-form video.

## Docs

- [LLM API Guide](/docs/llm-guide.md): Complete FunnelCake guide for coding agents, including REST, WebSocket, GraphQL, auth, pagination, and event examples.
- [GraphQL API Guide](/docs/graphql.md): Read-only GraphQL beta schema conventions and query examples.
- [OpenAPI JSON](https://api.divine.video/openapi.json): Machine-readable REST API schema.
- [Swagger UI](https://api.divine.video/swagger-ui/): Human-readable REST API reference.
- [Complete FunnelCake agent docs](/llms-full.txt): Single-file Markdown export for larger-context agents.

## Related Sites

- [diVine app](https://divine.video/): User-facing short-form video app.
- [diVine app llms.txt](https://divine.video/llms.txt): End-user focused agent guide.