Create

Create an OpenRouter API Key Rotation for the specified project.

POST /api/v2/secret-rotations/open-router-api-key

cURL

cURL

curl --request POST \
  --url https://us.infisical.com/api/v2/secret-rotations/open-router-api-key \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "projectId": "<string>",
  "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "environment": "<string>",
  "secretPath": "<string>",
  "rotationInterval": 2,
  "parameters": {
    "name": "<string>",
    "limit": 1,
    "limitReset": "daily",
    "includeByokInLimit": true
  },
  "secretsMapping": {
    "apiKey": "<string>"
  },
  "description": "<string>",
  "isAutoRotationEnabled": true,
  "rotateAtUtc": {
    "hours": 11.5,
    "minutes": 29.5
  }
}
'

200

{
  "secretRotation": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "rotationInterval": 123,
    "rotationStatus": "<string>",
    "lastRotationAttemptedAt": "2023-11-07T05:31:56Z",
    "lastRotatedAt": "2023-11-07T05:31:56Z",
    "connection": {
      "app": "open-router",
      "name": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "environment": {
      "slug": "<string>",
      "name": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "projectId": "<string>",
    "folder": {
      "id": "<string>",
      "path": "<string>"
    },
    "rotateAtUtc": {
      "hours": 11.5,
      "minutes": 29.5
    },
    "type": "open-router-api-key",
    "parameters": {
      "name": "<string>",
      "limit": 1,
      "limitReset": "daily",
      "includeByokInLimit": true
    },
    "secretsMapping": {
      "apiKey": "<string>"
    },
    "description": "<string>",
    "isAutoRotationEnabled": true,
    "activeIndex": 0,
    "lastRotationJobId": "<string>",
    "nextRotationAt": "2023-11-07T05:31:56Z",
    "isLastRotationManual": true,
    "lastRotationMessage": "<string>"
  }
}

Check out the configuration docs for OpenRouter API Key Rotations to learn how to obtain the required parameters.

Creates an OpenRouter API Key secret rotation. Infisical will create and rotate API keys via your OpenRouter connection and write them to the specified secret path.

Request body

Field	Type	Required	Description
name	string	Yes	A unique name for the rotation (max 100 characters).
projectId	string (UUID)	Yes	The project ID.
connectionId	string (UUID)	Yes	ID of the OpenRouter app connection (Provisioning API key).
environment	string	Yes	Environment slug (e.g. dev, prod).
secretPath	string	Yes	Path where the generated API key secret will be stored.
isAutoRotationEnabled	boolean	Yes	Whether to rotate automatically on the schedule.
rotationInterval	number	Yes	Days between rotations (e.g. 30).
rotateAtUtc	object	Yes	Time of day (UTC) to run rotation: { "hours", "minutes" }.
parameters.name	string	Yes	Name for the API key in OpenRouter (max 100 characters).
parameters.limit	number	Yes	Usage limit for the key.
parameters.limitReset	string	Yes	"monthly" or "never".
parameters.includeByokInLimit	boolean	No	Whether BYOK usage counts toward the limit. Default false.
secretsMapping.apiKey	string	Yes	Secret key name to store the generated API key (e.g. OPEN_ROUTER_API_KEY).
description	string	No	Optional description.

Sample request

curl --request POST \
  --url https://us.infisical.com/api/v2/secret-rotations/open-router-api-key \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
    "name": "my-open-router-rotation",
    "projectId": "<project-id>",
    "description": "OpenRouter API key rotation",
    "connectionId": "<open-router-connection-id>",
    "environment": "dev",
    "secretPath": "/",
    "isAutoRotationEnabled": true,
    "rotationInterval": 30,
    "rotateAtUtc": { "hours": 0, "minutes": 0 },
    "parameters": {
      "name": "my-app-key",
      "limit": 100,
      "limitReset": "monthly",
      "includeByokInLimit": false
    },
    "secretsMapping": {
      "apiKey": "OPEN_ROUTER_API_KEY"
    }
  }'

Sample response

{
  "secretRotation": {
    "id": "<rotation-id>",
    "name": "my-open-router-rotation",
    "description": "OpenRouter API key rotation",
    "secretsMapping": { "apiKey": "OPEN_ROUTER_API_KEY" },
    "isAutoRotationEnabled": true,
    "activeIndex": 0,
    "connectionId": "<open-router-connection-id>",
    "rotationInterval": 30,
    "rotateAtUtc": { "hours": 0, "minutes": 0 },
    "type": "open-router-api-key",
    "parameters": {
      "name": "my-app-key",
      "limit": 100,
      "limitReset": "monthly",
      "includeByokInLimit": false
    }
  }
}

Body

application/json

name · string · required

The name of the OpenRouter API Key Rotation to create. Must be slug-friendly.

Required string length: 1 - 64

projectId · string · required

The ID of the project to create the rotation in.

Minimum string length: 1

connectionId · string<uuid> · required

The ID of the OpenRouter Connection to use for rotation.

environment · string · required

The slug of the project environment to create the rotation in.

Required string length: 1 - 64

secretPath · string · required

The secret path of the project to create the rotation in.

Minimum string length: 1

rotationInterval · number · required

The interval, in days, to automatically rotate secrets.

Required range: x >= 1

parameters · object · required

Show child attributes

secretsMapping · object · required

Show child attributes

description · string | null

An optional description for the OpenRouter API Key Rotation.

Maximum string length: 256

isAutoRotationEnabled · boolean · default: true

Whether secrets should be automatically rotated when the specified rotation interval has elapsed.

rotateAtUtc · object

The hours and minutes rotation should occur at in UTC. Defaults to Midnight (00:00) UTC.

Show child attributes

Response

200

application/json

Default Response

secretRotation · object · required

Show child attributes