Skip to main content

Creating an API key

  1. Go to Settings in the sidebar
  2. Click Generate API Key
  3. Enter a label (e.g., “CI/CD pipeline”, “Monitoring script”)
  4. 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

Key format

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.