Provisioning API Keys

OpenRouter provides endpoints to programmatically manage your API keys, enabling key creation and management for applications that need to distribute or rotate keys automatically.

Creating a Provisioning API Key

To use the key management API, you first need to create a Provisioning API key:

1. Go to the Provisioning API Keys page
2. Click “Create New Key”
3. Complete the key creation process

Provisioning keys cannot be used to make API calls to OpenRouter’s completion endpoints - they are exclusively for key management operations.

Use Cases

Common scenarios for programmatic key management include:

• SaaS Applications: Automatically create unique API keys for each customer instance
• Key Rotation: Regularly rotate API keys for security compliance
• Usage Monitoring: Track key usage and automatically disable keys that exceed limits (with optional daily/weekly/monthly limit resets)

Example Usage

All key management endpoints are under /api/v1/keys and require a Provisioning API key in the Authorization header.

Response Format

API responses return JSON objects containing key information:

When creating a new key, the response will include the key string itself. Read more in the API reference.