Developer documentation

RivetAI REST API

Connect studio systems, automation pipelines, and MCP clients to RivetAI with scoped workspace API keys.

The RivetAI REST API uses Bearer authentication with granular scopes. Keys are workspace-bound: the workspace is resolved from the key, not from request headers.

Studio license required

Create keys in Workspace Settings → API Keys. Usage on project routes requires an active Studio or Enterprise license on that project.

Writer licenses do not include API access
Keys are scoped to your role permissions at creation time
Revoke a key anytime. Integrations stop immediately

Quick start

Create a scoped API key in Workspace Settings → API Keys (Studio-licensed project)
Copy the token when shown. RivetAI never displays the full secret again
Verify the key with GET /api-keys/me

curl -s "https://api.rivetai.com/api-keys/me" \
  -H "Authorization: Bearer rivetai_sk_YOUR_KEY"

Next steps

Authentication & token lifecycle
Scope reference
MCP integration
Security & trust center