Saltar al contenido principal
POST
Rotar una clave de API del usuario de servicio

Permisos

Requiere un usuario de servicio o un token de acceso personal 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 de 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 clave como marca de tiempo UNIX en segundos. Null si no vence.

revoke_current
boolean
predeterminado:true

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

Respuesta

Respuesta correcta

Modelo de respuesta compartido para la creación o rotación de API keys (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 rotación.