POST `/admin/tenants/{tenant_id}/api-keys/{key_id}/rotate`

Rotate an API Key, generating a new key and immediately invalidating the old one.

Tenant Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`id`	`path`	`string`	Yes				Tenant ID
`key_id`	`path`	`string`	Yes				API Key ID

Status	Description	Schema
200	New API Key	`dto.DataResponse-dto_RotateApiKeyResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
403	Insufficient permissions	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	API Key not found	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Field	Type	Required
`code`	`integer`	No
`data`	`dto.RotateApiKeyResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

Field	Type	Required	Example
`api_key`	`string`	No	`tk_f6e7d8c9a0b1...`
`created_at`	`string`	No	`2026-05-12T16:00:00Z`
`id`	`string`	No	`tak_001`
`key_prefix`	`string`	No	`tk_f6e7d8c9`
`message`	`string`	No	`Please save the new API Key immediately; the old key is no longer valid`

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No