Skip to main content

Overview

Admins can create, view, and revoke API keys directly from the Moonbounce dashboard. API keys provide programmatic access to the Moonbounce API for your integrations and automated workflows. To manage API keys, navigate to Account Settings → API Keys.
Only users with the Admin role can access and manage API keys.

Creating an API Key

  1. Go to Account Settings → API Keys and click Create API Key.
  2. Enter a descriptive name for the key (e.g. “Production API Key”).
  3. Choose a duration for how long the key should remain valid:
    • 30 days
    • 90 days
    • 180 days
    • 365 days
  4. Click Create.
  5. Copy your API key immediately. The full key is only shown once and cannot be retrieved later.

Using Your API Key

Include your API key in the request headers when calling the Moonbounce API:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.clavata.ai/v1/jobs
For SDK usage, refer to the Python SDK, JavaScript/TypeScript SDK, or Go SDK documentation.

Managing Existing Keys

The API Keys page displays all keys for your account, including:
ColumnDescription
NameThe label you assigned when creating the key
OwnerThe email of the user who created the key
StatusEnabled, Disabled, or Revoked
CreatedWhen the key was generated
ExpiresWhen the key will expire, color-coded by urgency
SignatureThe last 6 characters of the key for identification

Key Actions

From the actions menu on each key, you can:
  • Disable — Temporarily deactivate a key. It can be re-enabled later.
  • Enable — Reactivate a previously disabled key.
  • Revoke — Permanently invalidate a key. This action cannot be undone.

Best Practices

  • Rotate keys regularly. Create a new key before revoking an old one to avoid downtime.
  • Use descriptive names. Name keys after their intended use (e.g. “CI Pipeline”, “Staging Environment”) so you can easily identify them later.
  • Revoke unused keys. If a key is no longer needed, revoke it promptly to reduce your attack surface.
  • Never share keys in plaintext. Store API keys in environment variables or a secrets manager, not in source code.