Skip to main content
POST
/
v1
/
organizations
/
{orgId}
/
api_keys
curl -X POST "https://api.edgee.app/v1/organizations/{orgId}/api_keys" \
  -H "Authorization: Bearer <your_console_api_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Backend",
    "type": "api",
    "models": ["anthropic/claude-opus-4-6", "openai/gpt-5.2"],
    "max_usage": 1000,
    "expires_in_days": 90
  }'

{
  "object": "ai_gateway_api_key",
  "id": "key_abc123xyz",
  "organization_id": "org_12345",
  "name": "Production Backend",
  "type": "api",
  "models": ["anthropic/claude-opus-4-6", "openai/gpt-5.2"],
  "max_usage": 1000,
  "active": true,
  "debug_mode": false,
  "created_at": "2026-04-08T10:00:00Z",
  "expires_at": "2026-07-07T10:00:00Z",
  "last_used_at": "2026-04-08T12:30:00Z",
  "key": "ek_live_abc123xyz..."
}

Documentation Index

Fetch the complete documentation index at: https://www.edgee.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Manage your AI Gateway API keys programmatically. Gateway API keys are used to authenticate requests to the Edgee AI Gateway API (https://api.edgee.ai) for making LLM requests.
These endpoints manage Gateway API keys for the AI Gateway API (api.edgee.ai), not the Console API tokens. Do not confuse these two systems.

​
Request Body

​
name
string
required
A descriptive name for this API key (e.g., “Production Backend”, “Development Client”)
​
type
string
default:"api"
The type of API key. Options: api (for Gateway requests) or coding_agent (for coding assistants)
​
coding_assistant
string
Required if type is coding_agent. Specifies which coding assistant this key is for.Options: claude_code, opencode, codex
​
models
array
Optional list of model restrictions. If specified, this key can only access these models. Leave empty for no restrictions.Example: ["anthropic/claude-opus-4-6", "openai/gpt-5.2"]
​
max_usage
integer
Optional monthly usage limit in USD. If specified, this key will stop working after reaching this cost threshold.
​
expires_in_days
integer
Optional expiration time in days from creation. After this period, the key will stop working.
​
email
string
Optional email address associated with this key (for organization/billing tracking).

​
Response

​
object
string
The object type (always “ai_gateway_api_key”)
​
id
string
Unique identifier for this API key
​
organization_id
string
The organization this key belongs to
​
name
string
The name of this API key
​
type
string
The type of API key (“api” or “coding_agent”)
​
coding_assistant
string
The coding assistant this key is for (if type is “coding_agent”)
​
models
array
List of model restrictions (if any)
​
max_usage
integer
Monthly usage limit in USD (if set)
​
active
boolean
Whether this key is currently active
​
debug_mode
boolean
Whether debug mode is enabled for this key
​
created_at
string
ISO 8601 timestamp when the key was created
​
expires_at
string
ISO 8601 timestamp when the key will expire (if set)
​
last_used_at
string
ISO 8601 timestamp of the last usage (if ever used)
​
key
string
The actual API key (only shown once at creation or when using the reveal endpoint)

​
Examples

curl -X POST "https://api.edgee.app/v1/organizations/{orgId}/api_keys" \
  -H "Authorization: Bearer <your_console_api_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Backend",
    "type": "api",
    "models": ["anthropic/claude-opus-4-6", "openai/gpt-5.2"],
    "max_usage": 1000,
    "expires_in_days": 90
  }'

{
  "object": "ai_gateway_api_key",
  "id": "key_abc123xyz",
  "organization_id": "org_12345",
  "name": "Production Backend",
  "type": "api",
  "models": ["anthropic/claude-opus-4-6", "openai/gpt-5.2"],
  "max_usage": 1000,
  "active": true,
  "debug_mode": false,
  "created_at": "2026-04-08T10:00:00Z",
  "expires_at": "2026-07-07T10:00:00Z",
  "last_used_at": "2026-04-08T12:30:00Z",
  "key": "ek_live_abc123xyz..."
}

​
Tips

  • API Keys vs Console Tokens: Gateway API keys are used to authenticate requests to the Gateway API (api.edgee.ai), while Console tokens authenticate requests to the Console API (api.edgee.app)
  • Model Restrictions: Use the models field to restrict which models a key can access, useful for controlling access and managing costs
  • Usage Limits: Set max_usage to automatically disable a key after spending a certain amount
  • Expiration: Use expires_in_days to automatically revoke keys after a set period for security rotation
  • Key Visibility: Once created, the key is only shown once. Use the reveal endpoint if you need to see it again, but the key must already exist

​
Next Steps