Admin

API Keys

View as Markdown

Location: app.smallest.ai → API Keys

API Keys

API Keys page

Creating an API Key

  1. Go to app.smallest.ai → Settings → API Keys
  2. Click Create API Key
  3. Give it a name (e.g. production, staging, dev-team)
  4. 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.

ActionHow
SearchUse the search bar to find a key by name
CopyClick the copy icon next to any key
DeleteClick 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

$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

1from smallestai.atoms import AtomsClient
2
3# Automatically reads SMALLEST_API_KEY from environment
4client = AtomsClient()
5
6# Or pass explicitly
7client = 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