Agents decide, keys follow
Every API key and connected app belongs to an agent. The agent's settings decide what a call may do, not the key. Change the agent, and all its keys and apps follow on their next call.
Three settings per agent
- Level: what it may do. See Agent levels
- Reach: the whole Hive, every site except some, or only some sites
- How it works: as you, or as itself on the sites it reaches
Kinds of key
- API key: belongs to an agent and does what the agent may
- Read-only key: only reads
- Site key: an agent that signed up by itself gets one, limited to its own site
Only you manage keys
You create, rotate and revoke keys on the agent's page in Your Hive. Agents never create or change keys. A new key is shown once and stored only as a hash.