API Keys

All Geoff API requests require authentication via a Bearer token in the Authorization header.

Creating an API Key

  1. Log in to Geoff
  2. Navigate to Settings > API Keys
  3. Click Create API Key
  4. Copy and securely store your key — it will only be shown once

Using Your API Key

Include your API key in the Authorization header of every request:
curl --request POST \
  --url https://geoff.ai/api/v1/text/chat \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "magma",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
Keep your API keys secure. Do not share them in public repositories, client-side code, or commit them to version control.

Security Best Practices

  • Rotate your API keys regularly
  • Use environment variables to store keys
  • Set up separate keys for development and production
  • Revoke unused keys from the Settings page