Rotar API key del usuario de servicio

Rotar una clave de API de un usuario de servicio.

Crea una nueva clave de API. De forma predeterminada, revoca la clave de API anterior; establece revoke_current=false para una rotación gradual en la que ambas claves de API permanezcan activas temporalmente. Devuelve 404 si no se encuentra la clave de API y 400 si la clave de API no está activa.

POST /v3beta1/enterprise/service-users/{service_user_id}/api-keys/{api_key_id}/rotate

Rotar API key del usuario de servicio

cURL

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
}
'

200

{
  "api_key_id": "<string>",
  "api_key_name": "<string>",
  "token": "<string>"
}

​

Permisos

Requiere un usuario de servicio con el permiso ManageAccountServiceUsers en el nivel Enterprise.

Autorizaciones

Authorization · string · header · requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

service_user_id · string · requerido

ID del usuario de servicio (prefijo: service-user-)

Ejemplo:

"service-user-abc123def456"

api_key_id · string · requerido

Cuerpo

application/json

new_key_expires_at · integer | null

Vencimiento opcional de la nueva key como marca de tiempo UNIX en segundos. Null si no vence.

revoke_current · boolean · predeterminado: true

Indica si se debe revocar la key actual. Establézcalo en False para una rotación gradual.

Respuesta

200

application/json

Respuesta exitosa

Modelo de respuesta compartido para la creación/rotación de API key (incluye un token de un solo uso).

api_key_id · string · requerido

api_key_name · string · requerido

token · string · requerido

El token de API sin procesar. Solo se muestra una vez, en el momento de la creación o la rotación.