Passer au contenu principal
POST
Révoquer l'agent

Révoquer un agent

POST /v1/agents/{agentID}/revoke Révoque définitivement une identité d’agent machine. Il s’agit d’une opération irréversible qui :
  1. Définit le statut de l’agent sur "revoked"
  2. Invalide toutes les sessions actives
  3. Bloque toutes les invocations futures de l’outil
  4. Empêche l’agent d’être utilisé dans de nouvelles délégations
La révocation est permanente et irréversible. Si vous avez besoin de temporairement désactiver un agent, utilisez le suspendre point de terminaison à la place. Révoqué les agents restent dans le système à des fins d’audit mais ne peuvent pas être réactivé.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

string
Statut mis à jour, toujours "revoked" en cas de succès.
string
L’identifiant d’agent MAIP qui a été révoqué.

Exemple


Quand révoquer ou suspendre

Après avoir révoqué un agent, vous pouvez toujours consulter son historique complet via le GET point de terminaison /v1/agents/. L’enregistrement de l’agent est conservé indéfiniment pour la conformité d’audit (SOC 2 Type II, ISO 27001).

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de chemin

agentId
string<uuid>
requis

Identifiant de l'agent

Corps

application/json
reason
string
requis

Raison de révocation lisible par l'homme

Réponse

Agent révoqué

id
string<uuid>
agent_type
enum<string>
Options disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Options disponibles:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Plage requise: 0 <= x <= 1
public_key
string

Clé publique encodée en Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>