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 |
knowledge:read | List and inspect knowledge metadata |
knowledge:write | Update knowledge flags |
tags:write | Add and remove tags on knowledge items |
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 |
youtube:read | List and inspect YouTube videos |
x:read | List and inspect X posts |
linkedin:read | List and inspect LinkedIn posts |
podcasts:read | List and inspect podcast episodes |
credits:read | Read current credit status and action costs |
usage:read | Read credit usage events |
Requests without the required scope return 403.