Location: app.smallest.ai → API Keys
Creating an API Key
- Go to app.smallest.ai → Settings → API Keys
- Click Create API Key
- Give it a name (e.g.
production, staging, dev-team)
- Copy immediately — the key is only shown once
Your API key provides access to your account. Never share it publicly, commit it to version control, or expose it in client-side code.
Managing Keys
The API Keys page shows all your keys with their name and creation date.
| Action | How |
|---|
| Search | Use the search bar to find a key by name |
| Copy | Click the copy icon next to any key |
| Delete | Click the delete icon to revoke a key |
Create separate keys for different environments (production, staging, development) so you can rotate or revoke them independently.
Using Your API Key
Environment Variable (Recommended)
export SMALLEST_API_KEY="your-api-key-here"
In API Requests
Include the key in the Authorization header as a Bearer token:
curl -X GET "https://api.smallest.ai/atoms/v1/agent" \
-H "Authorization: Bearer YOUR_API_KEY"
In Code
from smallestai.atoms import AtomsClient
# Automatically reads SMALLEST_API_KEY from environment
client = AtomsClient()
# Or pass explicitly
client = AtomsClient(api_key="your-api-key")
Best Practices
- Use environment variables — never hardcode keys in source code
- One key per environment — separate keys for dev, staging, production
- Rotate regularly — rotate keys periodically and after any team changes
- Revoke unused keys — delete keys that are no longer needed
