Zum Hauptinhalt springen
POST
API key für Service-Benutzer rotieren

Berechtigungen

Erfordert einen Service-Benutzer mit der Berechtigung ManageAccountServiceUsers auf Enterprise-Ebene.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

service_user_id
string
erforderlich

Service-Benutzer-ID (Präfix: service-user-)

Beispiel:

"service-user-abc123def456"

api_key_id
string
erforderlich

Body

application/json
new_key_expires_at
integer | null

Optionales Ablaufdatum für den neuen key als UNIX-Zeitstempel in Sekunden. Null für kein Ablaufdatum.

revoke_current
boolean
Standard:true

Gibt an, ob der aktuelle key widerrufen werden soll. Für eine unterbrechungsfreie Umstellung auf False setzen.

Antwort

Erfolgreiche Antwort

Gemeinsames Antwortmodell für die Erstellung/Rotation von API keys (einschließlich Einmal-Token).

api_key_id
string
erforderlich
api_key_name
string
erforderlich
token
string
erforderlich

Das rohe API-Token. Es wird nur einmal bei der Erstellung/Rotation angezeigt.