Skip to main content
POST
Rotar API key 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 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

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.