OpenRouter Connection

OpenRouter is a unified LLM router that gives you access to hundreds of large language models through a single API. Hanzo KMS supports connecting to OpenRouter using an API Key (Provisioning API key). This connection is used to manage and rotate OpenRouter API keys via Secret Rotation.

Prerequisites

You need a Provisioning API key from OpenRouter. Provisioning keys are used only for key management (create, list, delete keys)—they cannot be used for model completion requests.

Create an OpenRouter Provisioning API Key

In OpenRouter Settings, go to Provisioning API Keys and click Create New Key.

OpenRouter Provisioning Keys

Complete the key creation flow and copy the generated Provisioning API key. Store it securely—you will use it when creating the Hanzo KMS connection.

OpenRouter Key Created

For more details on Provisioning API keys and key management, see OpenRouter's documentation.

Create OpenRouter Connection in Hanzo KMS

In your Hanzo KMS dashboard, go to Organization Settings → App Connections (or the Integrations → App Connections tab in your project).

App Connections Tab

Click Add Connection and choose OpenRouter from the list of available connections.

Select OpenRouter Connection

Complete the form with:

A name for the connection (e.g. openrouter-prod)
An optional description
Your OpenRouter Provisioning API Key (from the steps above)

OpenRouter Connection Form

After clicking Create, Hanzo KMS validates the key against OpenRouter's API. Your OpenRouter Connection is then ready to use for OpenRouter API Key Secret Rotation.

OpenRouter Connection Created

Create an OpenRouter connection via the Create OpenRouter Connection API endpoint.

Sample request

curl --request POST \
  --url https://app.kms.hanzo.ai/api/v1/app-connections/open-router \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "my-openrouter-connection",
    "method": "api-key",
    "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
    "credentials": {
      "apiKey": "<YOUR-PROVISIONING-API-KEY>"
    }
  }'

Sample response

{
  "appConnection": {
    "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
    "name": "my-openrouter-connection",
    "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
    "description": null,
    "version": 1,
    "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
    "createdAt": "2025-04-23T19:46:34.831Z",
    "updatedAt": "2025-04-23T19:46:34.831Z",
    "isPlatformManagedCredentials": false,
    "credentialsHash": "...",
    "app": "open-router",
    "method": "api-key",
    "credentials": {}
  }
}