Passer au contenu principal
POST
Suspendre l'agent

Suspendre un agent

POST /v1/agents/{agentID}/suspend Suspend une identité d’agent machine, l’empêchant immédiatement de créer de nouvelles sessions, d’invoquer des outils ou d’effectuer des opérations authentifiées. La suspension est réversible — l’agent peut être réactivé en mettant à jour son statut à nouveau sur "active" via le point de terminaison de mise à jour. Toutes les sessions actives appartenant à l’agent suspendu sont effectivement bloquées au niveau de la couche de contrôle d’accès. Les jetons de session existants échoueront aux vérifications de portée jusqu’à ce que l’agent soit réactivé.
La suspension est la première réponse recommandée pour un comportement d’agent anormal. Utilisez révoquer uniquement lorsque permanent le démantèlement est requis.

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 "suspended" en cas de succès.
string
L’identifiant d’agent MAIP qui a été suspendu.

Exemple


Réactivation d’un agent suspendu

Pour restaurer un agent suspendu à l’état actif, utilisez le point de terminaison PATCH /v1/agents/ :

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 suspension lisible par l'homme

Réponse

Agent suspendu

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>