Passer au contenu principal
POST
/
v3beta1
/
enterprise
/
service-users
/
{service_user_id}
/
api-keys
/
{api_key_id}
/
rotate
Effectuer une rotation de l’API key pour l’utilisateur de service
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
}
'
{
  "api_key_id": "<string>",
  "api_key_name": "<string>",
  "token": "<string>"
}

Autorisations

Nécessite un utilisateur de service disposant de l’autorisation ManageServiceUsers au niveau de l’entreprise.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

service_user_id
string
requis

ID de l’utilisateur de service (préfixe : service-user-)

Exemple:

"service-user-abc123def456"

api_key_id
string
requis

Corps

application/json
new_key_expires_at
integer | null

Expiration facultative de la nouvelle clé sous forme d’horodatage UNIX en secondes. Null si aucune expiration.

revoke_current
boolean
défaut:true

Indique s’il faut révoquer la clé actuelle. Définissez cette valeur sur False pour un renouvellement progressif.

Réponse

Réponse réussie

Modèle de réponse partagé pour la création/la rotation d’API key (inclut un token ponctuel).

api_key_id
string
requis
api_key_name
string
requis
token
string
requis

Le token API brut. Il n’est affiché qu’une seule fois au moment de la création ou de la rotation.