Roam Research API (Graph API)
Roam Research is a graph-based note-taking tool with bidirectional links. Its API allows reading and writing pages, blocks, and graph structure. Data is stored in an EDN (Extensible Data Notation) format with a Datalog query interface — unconventional but powerful for graph traversal.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Community/specialized tool. Apply standard security practices for category. Review documentation for specific security requirements.
⚡ Reliability
Best When
An agent is augmenting a personal Roam knowledge graph, ingesting processed content, or reading from the graph to build context.
Avoid When
You need a stable, well-documented API with predictable behavior — Roam's API is unofficial and subject to change.
Use Cases
- • Ingesting external content into a Roam knowledge base
- • Querying the knowledge graph to surface related concepts
- • Creating daily notes entries from agent-processed data
- • Bulk importing research notes or structured data
- • Automating block creation and page linking
Not For
- • Team or collaborative knowledge bases (Roam is primarily personal/solo)
- • Agents needing reliable, well-documented REST endpoints
- • Production systems requiring SLA guarantees
Interface
Authentication
API token tied to a graph. Token is generated per-graph in settings. No scopes — full read/write to the graph. Very limited official documentation on auth; largely community-documented.
Pricing
Flat individual pricing, no team tiers. The API itself is not an officially marketed product feature — it emerged as a community-discovered capability.
Agent Metadata
Known Gotchas
- ⚠ API is unofficial and undocumented by Roam — behavior can change without notice
- ⚠ EDN data format is unusual; most agents will need a Clojure/EDN parser or community wrapper
- ⚠ No rate limit documentation — agents must self-throttle conservatively
- ⚠ No webhooks — agents must poll to detect changes
- ⚠ Block UIDs must be generated by the client; collisions cause silent failures in some cases
- ⚠ Graph mutations are not atomic — partial writes can leave graph in inconsistent state
- ⚠ No official SDK; community libraries (roam-client, etc.) are unmaintained or experimental
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Roam Research API (Graph API).
Scores are editorial opinions as of 2026-03-06.