Your Metorial API key authenticates your application and gives you access to all deployed integrations.

Creating Your API Key

1. Log in to your Metorial account at metorial.com

2. Navigate to Settings from your dashboard

3. Go to API Keys section in the sidebar

4. Click "Create New API Key"

5. Name your key (e.g., "Production App" or "Development")

6. Copy the key immediately — it will only be shown once for security reasons

7. Store it securely in your environment variables

Using Your API Key

Never hardcode your API key in your source code. Instead, use environment variables:

// .env
METORIAL_API_KEY=your_api_key_here

// In your code
import { Metorial } from 'metorial';

const metorial = new Metorial({
  apiKey: process.env.METORIAL_API_KEY
});

Best Practices

• Use separate keys for development and production environments
• Rotate keys regularly for enhanced security
• Revoke compromised keys immediately from the dashboard
• Never commit keys to version control (add .env to .gitignore)

Revoking API Keys

If a key is compromised or no longer needed:

1. Go to Settings → API Keys
2. Find the key in your list
3. Click "Revoke" next to the key
4. Confirm the revocation

Any applications using the revoked key will immediately lose access.