Skip to main content
Applies to:
  • Plan -
  • Deployment -

Summary

Goal: Configure minimal OpenAI API key permissions required by Braintrust. Features: AI Providers

Required permissions

Braintrust requires exactly two OpenAI API permissions:
PermissionAccess level
List ModelsRead
Model CapabilitiesRequest

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.