Create and Manage API Keys

​

Create and Manage API Keys

​

Creating Your First API Key

1. Go to Settings
   • Open Dashboard
   • Click Settings in the left sidebar
   • Select API Keys
2. Create New Key
   • Click ”+ Create New Key”
   • Give it a meaningful name (e.g., “Production”, “Development”, “Testing”)
3. Select Tier
   • Free: 1,000 requests/month, $0/month
   • Pro: 100,000 requests/month, $29/month
   • Enterprise: Custom limits, contact sales
4. Save the Key
   • Copy immediately - it won’t be shown again
   • Store securely in your password manager or .env file

​

Key Format

• acx_live_ - Production keys
• acx_test_ - Testing keys
• acx_dev_ - Development keys

​

Securing Your API Key

​

✅ DO:

• Store in environment variables: AGENT_COREX_API_KEY
• Use .env files (add to .gitignore)
• Rotate keys regularly (every 3 months)
• Use different keys for different environments
• Monitor API usage in your dashboard

​

❌ DON’T:

• Commit keys to git repositories
• Share keys in Slack/email/documents
• Use the same key for multiple environments
• Hardcode keys in source code
• Log keys in error messages

​

Environment Variable Setup

​

macOS/Linux

# Add to ~/.bashrc or ~/.zshrc
export AGENT_COREX_API_KEY="acx_live_xxx"

# Or use .env file
echo "AGENT_COREX_API_KEY=acx_live_xxx" > .env
source .env

​

Windows

# PowerShell
$env:AGENT_COREX_API_KEY = "acx_live_xxx"

# Or set permanently
[Environment]::SetEnvironmentVariable("AGENT_COREX_API_KEY", "acx_live_xxx", "User")

​

Node.js (.env file)

# .env
AGENT_COREX_API_KEY=acx_live_xxx
AGENT_COREX_API_URL=https://api.agent-corex.com

require('dotenv').config();
const apiKey = process.env.AGENT_COREX_API_KEY;

​

Python

# .env
AGENT_COREX_API_KEY=acx_live_xxx

import os
from dotenv import load_dotenv

load_dotenv()
api_key = os.getenv('AGENT_COREX_API_KEY')

​

Using Your API Key

​

With SDKs

import { AgentCorex } from 'agent-corex';

const agent = new AgentCorex({
  apiKey: process.env.AGENT_COREX_API_KEY
});

​

With cURL

curl -H "Authorization: Bearer $AGENT_COREX_API_KEY" \
  https://api.agent-corex.com/v1/retrieve_tools

​

With Environment Variable in Commands

# Linux/macOS
API_KEY=$(echo $AGENT_COREX_API_KEY)
curl -H "Authorization: Bearer $API_KEY" \
  https://api.agent-corex.com/v1/retrieve_tools

# Windows PowerShell
$apiKey = $env:AGENT_COREX_API_KEY
curl -H "Authorization: Bearer $apiKey" `
  https://api.agent-corex.com/v1/retrieve_tools

​

Key Rotation

​

Rotate Keys Monthly

1. Create new key in your dashboard
2. Update code with new key
3. Test thoroughly to ensure it works
4. Revoke old key after 7 days
5. Confirm all systems using new key

​

Revoke a Key

1. Go to Settings → API Keys
2. Find the key to revoke
3. Click “Revoke”
4. Confirm the action
5. All requests with that key will fail

​

Monitoring Key Usage

​

View API Metrics

• Settings → Usage
• See requests/month
• Track by key
• View trending usage

​

Set Usage Alerts

• Settings → Alerts
• Alert when reaching 80% limit
• Alert on failed requests
• Email notifications

​

Troubleshooting

​

Best Practices