Authentication
Every Public API request needs a scoped API key in a header:
Authorization: Bearer $BRAIV_API_KEYX-Api-Key: $BRAIV_API_KEY is equivalent.
Create keys in Studio. Give each key a name, the scopes it needs, and optionally a workspaceId so library and billing stay on that workspace.
Scoped keys start with braiv_live_. Public API access requires a Pro, Business, or Team plan.
| Status | Code | Meaning |
|---|---|---|
| 401 | UNAUTHENTICATED, INVALID_API_KEY | Missing or unknown key |
| 403 | INSUFFICIENT_SCOPE, PERMISSION_DENIED, ROLE_CANNOT_PRODUCE | Key or role cannot do this |
| 429 | RATE_LIMITED | Key concurrency cap |
See Errors for the full list and Workspaces if you produce into a team library.
For Cursor, Claude, VS Code, Windsurf, and other agents, use hosted MCP with OAuth Connect instead of putting a key in MCP config.