API v1
Scopes
API v1 uses capability scopes to limit key access.
Choose the smallest set of scopes your integration needs.
| Scope | Allows |
|---|---|
collections:read | List and inspect collections |
collections:write | Create collections |
knowledge:read | List and inspect knowledge metadata |
knowledge:write | Update knowledge flags |
tags:read | List tags and inspect knowledge-item or source tags |
tags:write | Add and remove knowledge-item or inherited source tags |
search:read | Run keyword and semantic search |
articles:read | List and inspect saved articles |
emails:read | List and inspect received emails |
rss:read | List and inspect RSS items |
rss:write | Subscribe and unsubscribe RSS feeds |
youtube:read | List and inspect YouTube videos and subscribed channels |
youtube:write | Subscribe and unsubscribe YouTube channels |
x:read | List and inspect X posts and subscribed accounts |
x:write | Subscribe and unsubscribe X accounts |
linkedin:read | List and inspect LinkedIn posts and subscribed sources |
linkedin:write | Subscribe and unsubscribe LinkedIn sources |
newsletters:write | Start automated newsletter subscriptions |
podcasts:read | List and inspect podcast episodes |
podcasts:write | Subscribe and unsubscribe podcast shows |
websites:read | List website monitors and inspect delivered changes |
websites:write | Create, pause, resume, override, and remove monitors |
credits:read | Read current credit status and action costs |
usage:read | Read credit usage events |
Requests without the required scope return 403.