API Keys
API keys authenticate your applications with MutagenT. Learn how to create, manage, and securely use them.Creating API Keys
Create Key
Click Create API Key and configure:
- Name: Descriptive name (e.g., “Production Server”)
- Scope: Personal, Workspace, or Organization
- Permissions: Select required permissions
Key Scopes
| Scope | Access Level | Use Case |
|---|---|---|
| Personal | Your resources only | Development, personal projects |
| Workspace | All workspace resources | Team projects, shared prompts |
| Organization | All org resources | Admin tools, cross-workspace access |
Using API Keys
Environment Variables (Recommended)
SDK Configuration
HTTP Headers
For direct API calls:Security Best Practices
Use environment variables
Use environment variables
Store keys in
.env files and load with dotenv or your framework’s config system.Rotate keys regularly
Rotate keys regularly
Create new keys periodically and revoke old ones.
Use minimal permissions
Use minimal permissions
Create keys with only the permissions needed for their specific use case.
Monitor usage
Monitor usage
Review API key usage in the dashboard to detect anomalies.