---
title: "PATCH /api/v2/secret-rotations/open-router-api-key/{rotationId}"
method: PATCH
path: "/api/v2/secret-rotations/open-router-api-key/{rotationId}"
tags: ["Secret Rotations"]
---

# PATCH /api/v2/secret-rotations/open-router-api-key/{rotationId}

`PATCH /api/v2/secret-rotations/open-router-api-key/{rotationId}`

Update the specified OpenRouter API Key Rotation.

## Path parameters

- `rotationId` string, uuid, required

## Request body

- object
  - `name` string — The updated name of the OpenRouter API Key Rotation. Must be slug-friendly.
  - `description` string, nullable — The updated description of the OpenRouter API Key Rotation.
  - `isAutoRotationEnabled` boolean — Whether secrets should be automatically rotated when the specified rotation interval has elapsed.
  - `rotationInterval` number — The updated interval, in days, to automatically rotate secrets.
  - `rotateAtUtc` object — The updated hours and minutes rotation should occur at in UTC.
    - `hours` number, required
    - `minutes` number, required
  - `parameters` object
    - `name` string, required — The name for the generated OpenRouter API key.
    - `limit` number, nullable — The optional spending limit in USD for the generated API key.
    - `limitReset` 'daily' | 'weekly' | 'monthly', nullable — The type of limit reset for the API key (daily, weekly, monthly, or null for no reset).
    - `includeByokInLimit` boolean, nullable — Whether to include BYOK (Bring Your Own Key) usage in the spending limit. When enabled, usage from your own provider keys counts toward this key's limit. See OpenRouter BYOK docs for details.
  - `secretsMapping` object
    - `apiKey` string, required — The name of the secret that the rotated OpenRouter API key will be mapped to.

## Response `200`

Default Response

- object
  - `secretRotation` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `isAutoRotationEnabled` boolean
    - `activeIndex` number
    - `folderId` string, uuid, required
    - `connectionId` string, uuid, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `rotationInterval` number, required
    - `rotationStatus` string, required
    - `lastRotationAttemptedAt` string, date-time, required
    - `lastRotatedAt` string, date-time, required
    - `lastRotationJobId` string, nullable
    - `nextRotationAt` string, date-time, nullable
    - `isLastRotationManual` boolean
    - `connection` object, required
      - `app` 'open-router', required
      - `name` string, required
      - `id` string, uuid, required
    - `environment` object, required
      - `slug` string, required
      - `name` string, required
      - `id` string, uuid, required
    - `projectId` string, required
    - `folder` object, required
      - `id` string, required
      - `path` string, required
    - `rotateAtUtc` object, required
      - `hours` number, required
      - `minutes` number, required
    - `lastRotationMessage` string, nullable
    - `type` 'open-router-api-key', required
    - `parameters` object, required
      - `name` string, required — The name for the generated OpenRouter API key.
      - `limit` number, nullable — The optional spending limit in USD for the generated API key.
      - `limitReset` 'daily' | 'weekly' | 'monthly', nullable — The type of limit reset for the API key (daily, weekly, monthly, or null for no reset).
      - `includeByokInLimit` boolean, nullable — Whether to include BYOK (Bring Your Own Key) usage in the spending limit. When enabled, usage from your own provider keys counts toward this key's limit. See OpenRouter BYOK docs for details.
    - `secretsMapping` object, required
      - `apiKey` string, required — The name of the secret that the rotated OpenRouter API key will be mapped to.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/infisical/apis/infisical-api.md) · [All operations](https://skmtc.net/infisical/apis/infisical-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infisical/infisical-api/versions/885aef3e6c11/schema)