Scopes & Limits

Key scopes

Scope	recall	recall_sources	retrieve	read_source	trace_provenance	related_nodes	remember	provide_feedback
readonly	✅	✅	✅	✅	✅	✅	❌	❌
readwrite	✅	✅	✅	✅	✅	✅	✅	✅

Use a readonly key when you only want the agent to search and read. Use a readwrite key when you want the agent to save or update knowledge.

Tool type	Limit
Read tools (recall, recall_sources, retrieve, read_source, trace_provenance)	60 calls / minute
Write tools (remember, provide_feedback)	20 calls / minute

If you exceed the limit you will receive a 429 Too Many Requests response. Wait a moment and retry.

Keys are shown once at creation — copy and store them safely
Keys expire after 1 year automatically
You can revoke a key at any time from Org Settings → API Keys
Every tool call is logged — you can see when each key was last used in the dashboard
If a key is compromised, revoke it immediately and generate a new one