---
title: "更新API Key"
method: PUT
path: "/api/v1/api-keys/{api_key_id}"
tags: ["API Key管理"]
---

# 更新API Key

`PUT /api/v1/api-keys/{api_key_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

更新API Key信息

## Path parameters

- `api_key_id` string, required

## Request body

- APIKeyUpdate: 更新API Key请求模型
  - `name` string, nullable
  - `description` string, nullable
  - `expires_at` string, date-time, nullable
  - `permissions` string[], nullable
  - `is_active` boolean, nullable

## Response `200`

Successful Response

- APIKeyResponse: API Key响应模型
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `key_prefix` string, required: API Key前缀（用于识别）
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, nullable, required
  - `last_used_at` string, date-time, nullable, required
  - `permissions` string[], required
  - `is_active` boolean, required
  - `created_by` string, required: 创建者用户ID

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pancrepal-xiaoyibao/apis/pancrepal-xiaoyibao.md) - [All operations](https://skmtc.dev/pancrepal-xiaoyibao/apis/pancrepal-xiaoyibao/llms.txt) - [OpenAPI document](https://skmtc.dev/pancrepal-xiaoyibao/apis/pancrepal-xiaoyibao/revisions/289a5ec9b9c3?raw)