Creating an API key
- Go to Settings in the sidebar
- Click Generate API Key
- Enter a label (e.g., “CI/CD pipeline”, “Monitoring script”)
- Copy the key immediately
The full API key is shown only once. It’s hashed before storage — we cannot recover it. Save it in a secure location.
Using API keys
Include the key in the Authorization header:
curl -H "Authorization: Bearer dbh_abc123..." \
https://dbhost.app/api/v1/databases
API keys have a visible prefix (e.g., dbh_abc1) for identification and a secret portion. In the settings page, you’ll see the prefix, label, and last-used timestamp.
Revoking a key
Click Revoke next to any key in the settings page. The key stops working immediately.