Skip to main content
POST
Ruota l'API key dell'utente di servizio

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageAccountServiceUsers a livello dell’Enterprise.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

service_user_id
string
obbligatorio

ID utente di servizio (prefisso: service-user-)

Esempio:

"service-user-abc123def456"

api_key_id
string
obbligatorio

Corpo

application/json
new_key_expires_at
integer | null

Scadenza facoltativa per la nuova key come timestamp UNIX in secondi. Null se non è prevista alcuna scadenza.

revoke_current
boolean
predefinito:true

Indica se revocare la key attuale. Impostare False per una rotazione graduale.

Risposta

Risposta corretta

Modello di risposta condiviso per la creazione/rotazione dell'API key (include un token una tantum).

api_key_id
string
obbligatorio
api_key_name
string
obbligatorio
token
string
obbligatorio

Il token API in chiaro. Viene mostrato una sola volta, al momento della creazione/rotazione.