Creates a new API key with the specified alias.

Keys are created with granular permissions. Pass preset for a named preset or permissions to list them explicitly; omit both to get the API preset.

Important Security Notice: The key_secret is only returned once at creation time. Store it securely immediately as it cannot be retrieved again. If lost, you must delete the key and create a new one.

Key Features:

• Create API keys programmatically without UI access
• Assign meaningful aliases for key identification
• Scope a key with a named preset or an explicit list of permissions
• Optionally set an expiry with expires_at
• Keys are immediately active upon creation

Common Use Cases:

• Programmatic key provisioning for CI/CD pipelines
• Self-serve key generation for team members
• Automated key rotation workflows
• Integration with secret management systems

Required permissions: auth:keys:write. Key presets that include them: FULL. See key permissions.

{
  "alias": "Production Key",
  "description": "CI deploy key for the main environment",
  "preset": "API",
  "permissions": [
    "models:requests:read",
    "models:requests:write"
  ],
  "expires_at": "2025-07-15T12:00:00Z"
}

{
  "key_id": "abc123def456",
  "key_secret": "sk_live_abc123...",
  "key": "abc123def456:sk_live_abc123..."
}