Authentication

• API keys - For SDK integration (recommended)
• JWT tokens - For web console access (automatic via Clerk)

Authorization: Bearer <token>

​

API keys (for SDK)

​

Generate an API key

1. Log in to console.agentsentinel.dev
2. Navigate to Settings → API Keys
3. Click Generate New Key
4. Copy the key immediately (shown only once)
5. Store it securely (password manager, secrets vault)

curl -X POST "https://platform.agentsentinel.dev/api/v1/api-keys/" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"production-agent"}'

{
  "id": "key_abc123",
  "key": "as_a1b2c3d4e5f6...",
  "key_prefix": "as_a1b2c3",
  "name": "production-agent",
  "created_at": "2024-12-28T10:00:00Z"
}

​

Use an API key in SDK

from agent_sentinel import enable_remote_sync

enable_remote_sync(
    platform_url="https://platform.agentsentinel.dev",
    api_token="as_your_api_key_here",  # Use your API key
    run_id="run-001"
)

​

Manage API keys

curl "https://platform.agentsentinel.dev/api/v1/api-keys/" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

curl -X DELETE "https://platform.agentsentinel.dev/api/v1/api-keys/{key_id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​

JWT tokens (for web console)

​

When you need a JWT

• Accessing the web console
• Making API calls from the browser
• Programmatic API access (e.g., scripts, CI/CD)

​

Get a JWT token

1. Log in to the web console
2. Open browser DevTools → Console
3. Run:
   await window.Clerk.session.getToken()
   
4. Copy the token (valid for 1 hour)

​

JWT expiration

• Web console: Tokens auto-refresh - you stay logged in
• Programmatic: Tokens expire after 1 hour - regenerate as needed

​

Best practices

​

Troubleshooting

• Verify API key is correct (starts with as_)
• Check key is still active (not revoked)
• Ensure you’re using Authorization: Bearer <key> header

• Keys may take up to 30 seconds to propagate
• Verify you copied the full key including as_ prefix
• Test with a simple API call to verify

​

See also

• Quickstart - Get your first API key and connect to the platform
• Settings - Manage API keys in the web console