Create

Create an OpenRouter Connection.

POST /api/v1/app-connections/open-router

cURL

cURL

curl --request POST \
  --url https://us.infisical.com/api/v1/app-connections/open-router \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentials": {
    "apiKey": "<string>"
  },
  "name": "<string>",
  "description": "<string>",
  "projectId": "<string>",
  "gatewayId": "<unknown>",
  "rotation": "<unknown>"
}
'

200

{
  "appConnection": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "credentials": {},
    "description": "<string>",
    "version": 1,
    "isPlatformManagedCredentials": false,
    "gatewayId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "projectId": "<string>",
    "isAutoRotationEnabled": false,
    "rotation": {
      "rotationInterval": 123,
      "rotateAtUtc": {
        "hours": 123,
        "minutes": 123
      },
      "lastRotationMessage": "<string>",
      "nextRotationAt": "2023-11-07T05:31:56Z"
    },
    "credentialsHash": "<string>",
    "project": {
      "name": "<string>",
      "id": "<string>",
      "type": "<string>",
      "slug": "<string>"
    }
  }
}

Check out the configuration docs for OpenRouter Connections to learn how to obtain the required credentials.

Creates an OpenRouter app connection using a Provisioning API key. The connection can then be used for OpenRouter API Key secret rotations.

Request body

Field	Type	Required	Description
name	string	Yes	A unique name for the connection.
method	string	Yes	Must be "api-key".
projectId	string (UUID)	Yes	The project ID to attach the connection to.
credentials.apiKey	string	Yes	Your OpenRouter Provisioning API key.

Sample request

curl --request POST \
  --url https://app.infisical.com/api/v1/app-connections/open-router \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
    "name": "my-openrouter-connection",
    "method": "api-key",
    "projectId": "<project-id>",
    "credentials": {
      "apiKey": "<YOUR-PROVISIONING-API-KEY>"
    }
  }'

Sample response

{
  "appConnection": {
    "id": "<connection-id>",
    "name": "my-openrouter-connection",
    "projectId": "<project-id>",
    "description": null,
    "version": 1,
    "orgId": "<org-id>",
    "createdAt": "<ISO8601>",
    "updatedAt": "<ISO8601>",
    "isPlatformManagedCredentials": false,
    "credentialsHash": "...",
    "app": "openrouter",
    "method": "api-key",
    "credentials": {}
  }
}

Body

application/json

method · enum<string> · required

The method used to authenticate with OpenRouter.

Available options: api-key

credentials · object · required

The credentials used to connect with OpenRouter.

Show child attributes

name · string · required

The name of the OpenRouter Connection to create. Must be slug-friendly.

Required string length: 1 - 64

description · string | null

An optional description for the OpenRouter Connection.

Maximum string length: 256

projectId · string

The ID of the project to create the OpenRouter Connection in.

isPlatformManagedCredentials · enum<boolean>

Not supported for OpenRouter Connections.

Available options: false

gatewayId · any enum<string>

Not supported for OpenRouter Connections.

isAutoRotationEnabled · enum<boolean>

Not supported for OpenRouter Connections.

Available options: false

rotation · any enum<string>

Not supported for OpenRouter Connections.

Response

200

application/json

Default Response

appConnection · OpenRouter (API Key) · object · required

Show child attributes