Coming soonThe Library API is in design. This page will be updated at launch.
Library API
OAuth 2.0 access to Reedle user libraries. Build apps that act on behalf of your users — read articles, write highlights, manage lists — with the user's permission.
How it differs from the Extraction API
| Extraction API | Library API | |
|---|---|---|
| Auth | sk_iopho_ key (yours) | OAuth 2.0 (user grants access) |
| Acts as | Your server | The user |
| Can access | Content extraction only | User's library, highlights, lists |
| Use case | Backend pipelines | Third-party apps (e.g. Notion sync) |
| Status | Live | Coming soon |
Planned capabilities
- Read articles and highlights from a user's library
- Save articles to a user's inbox
- Create and update highlights
- Manage lists
- Access flashcard decks (read-only)
Planned OAuth scopes
| Scope | Access granted |
|---|---|
library:read | Read articles and metadata |
library:write | Save articles, manage lists |
highlights:read | Read highlights and notes |
highlights:write | Create and update highlights |
In the meantime
If you need to build on Reedle today, the MCP server gives complete read/write library access for AI agents. For server-to-server content extraction, use the Extraction API.