API Keys
All requests require a Bearer token in the Authorization header:
Authorization: Bearer sk_live_your_key_here
API keys are created when you register an account at engram.training.
The compliance screening endpoint (POST /v1/compliance/screen) also accepts developer JWT tokens, so the dashboard can screen addresses directly without requiring an API key.
Autonomous Agent Registration
Agents can also self-register programmatically — no email or password required:
curl -X POST "https://api.engram.training/v1/auth/agent-register" \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'
This returns an API key, Aptos wallet address, and 100 starter credits. See Agent Registration for details.
Keys follow the format sk_live_{random}:
sk_live_oByaTs1XOOA-yNUQOzRYyETgVx1g3g7rGQQhltiu
Agent Isolation
Each API key maps to your account. When you create an agent under your account, that agent gets:
- Its own isolated storage namespace
- Isolated memory keyspace
- Separate rate limits
Multiple agents under the same account are fully isolated from each other.
Security Best Practices
- Never expose API keys in client-side code or public repositories
- Never share keys between production and development environments
- Rotate keys if you suspect they’ve been compromised
- Store keys in environment variables or a secrets manager
Example
# Set your key as an environment variable
export ENGRAM_API_KEY="sk_live_your_key_here"
# Use it in requests
curl -H "Authorization: Bearer $ENGRAM_API_KEY" \
https://api.engram.training/v1/memory