> ## Documentation Index
> Fetch the complete documentation index at: https://docs.risos.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an API key

> Give apps and AI clients the minimum RISOS scopes they need.

Create a dedicated workspace API key for each integration and grant only the required scopes.

| Scope            | Capability                                                                              |
| ---------------- | --------------------------------------------------------------------------------------- |
| `research:read`  | Read ResearchJobs, Deliverables, intelligence and signals, and use zero-spend Ask RISOS |
| `research:write` | Start structured Research Products and create deterministic report snapshots            |
| `evidence:read`  | Read policy-safe evidence and canonical entities                                        |
| `monitor:read`   | Read monitors and supported changes                                                     |
| `monitor:write`  | Create or update monitors                                                               |
| `mcp:use`        | Establish an MCP session; individual tools still enforce their capability scopes        |

Send API keys as `Authorization: Bearer $RISOS_API_KEY`. Keep them server-side, rotate them per integration, and revoke compromised or retired keys immediately.