跳转到主要内容
POST
/
v3beta1
/
enterprise
/
service-users
/
{service_user_id}
/
api-keys
/
{api_key_id}
/
rotate
轮换服务用户的 API 密钥
curl --request POST \
  --url https://api.devin.ai/v3beta1/enterprise/service-users/{service_user_id}/api-keys/{api_key_id}/rotate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_key_expires_at": 123,
  "revoke_current": true
}
'
{
  "api_key_id": "<string>",
  "api_key_name": "<string>",
  "token": "<string>"
}

权限

需要具备企业级 ManageServiceUsers 权限的服务用户。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

路径参数

service_user_id
string
必填

服务用户 ID(前缀:service-user-)

示例:

"service-user-abc123def456"

api_key_id
string
必填

请求体

application/json
new_key_expires_at
integer | null

新密钥的可选过期时间,以秒为单位的 UNIX 时间戳。Null 表示不过期。

revoke_current
boolean
默认值:true

是否撤销当前密钥。设为 False 可进行平滑轮换。

响应

成功响应

API 密钥创建/轮换的共享响应模型(包含一次性令牌)。

api_key_id
string
必填
api_key_name
string
必填
token
string
必填

原始 API 令牌。该令牌仅会在创建或轮换时显示一次。