​

Authentication

​

Getting an API Key

1. Sign up at the Anona Memory dashboard
2. Verify your email
3. Go to Settings → API Keys → Create API Key
4. Choose environment (live or test) and a name
5. Copy your key immediately - it’s shown only once

​

Using Your API Key

curl -X POST http://anona-prod-alb-747552680.us-east-1.elb.amazonaws.com/v1/memories \
  -H "Authorization: Bearer anona_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"space_id": "spc_a1b2c3d4", "content": "User data"}'

from anona import AnonaClient

client = AnonaClient(api_key="anona_live_YOUR_KEY")
client.add_memory(space_id="spc_a1b2c3d4", content="User data")

​

Key Security

• Never share your API key - treat it like a password
• Never commit to version control - use environment variables
• Rotate regularly - create new keys and revoke old ones if compromised
• Use test keys in development, live keys only in production

export ANONA_API_KEY="anona_live_YOUR_KEY"

import os
client = AnonaClient(api_key=os.environ["ANONA_API_KEY"])

​

Authentication Errors

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "request_id": "req_..."
  }
}

• API key not included in header
• API key is invalid or revoked
• API key belongs to a different organization
• Header format incorrect (must be Authorization: Bearer <key>)

​

Organization & Space Context

​

API Key Management

• List - see key name, prefix, environment, created date, last used date, status
• Revoke - immediately and permanently disables the key (cannot be undone)
• Rotate - create a new key, update your app, then revoke the old one

​

Rate Limiting

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded",
    "request_id": "req_..."
  }
}

​

Next Steps