Zum Hauptinhalt springen
POST
Agent widerrufen

Agent widerrufen

POST /v1/agents/{agentID}/revoke Widerruft dauerhaft eine Maschinenagentenidentität. Dies ist ein irreversibler Vorgang, der:
  1. Setzt den Agentenstatus auf "revoked"
  2. Invalidiert alle aktiven Sitzungen
  3. Blockiert alle zukünftigen Tool-Aufrufe
  4. Verhindert die Verwendung des Agenten in neuen Delegationen
Der Widerruf ist dauerhaft und kann nicht rückgängig gemacht werden. Wenn Sie vorübergehend einen Agenten zu deaktivieren, verwenden Sie den Suspendierungs- Endpunkt stattdessen. Widerrufen Agenten bleiben zu Prüfzwecken im System, können aber nicht reaktiviert.

Authentifizierung

Erfordert X-API-Key Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie X-Tenant-ID nicht.

Antwort

string
Aktualisierter Status, bei Erfolg immer "revoked".
string
Der MAIP-Agentenbezeichner, der widerrufen wurde.

Beispiel


Wann widerrufen und wann aussetzen

Nach dem Widerruf eines Agenten können Sie dessen vollständige Historie weiterhin über die GET /v1/agents/ Endpunkt. Der Agentendatensatz wird für die Audit-Compliance (SOC 2 Typ II, ISO 27001).

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Pfadparameter

agentId
string<uuid>
erforderlich

Agenten-Identifikator

Body

application/json
reason
string
erforderlich

Menschenlesbarer Grund für den Widerruf

Antwort

Agent widerrufen

id
string<uuid>
agent_type
enum<string>
Verfügbare Optionen:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Verfügbare Optionen:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Erforderlicher Bereich: 0 <= x <= 1
public_key
string

Base64-kodierter öffentlicher Schlüssel

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