Minimum OpenAI API key permissions for Braintrust - Braintrust
Applies to:
- Plan - Any
- Deployment - Any
- Use case - Scoping OpenAI API key permissions to the minimum required by Braintrust
Summary
Goal: Configure minimal OpenAI API key permissions required by Braintrust.
Features: AI Providers
Required permissions
Braintrust requires exactly two OpenAI API permissions:
| Permission | Access level |
|---|---|
| List Models | Read |
| Model Capabilities | Request |
Configuration steps
Step 1: Create a scoped OpenAI API key
In your OpenAI account, create a new API key with restricted permissions. Enable only the two permissions listed above.
Step 2: Scope by model (optional)
If your Braintrust usage targets specific models, restrict the key further by limiting which models the permissions apply to.
Step 3: Add the key to Braintrust
In Braintrust, navigate to Settings → AI providers and enter the scoped OpenAI API key.