Zum Hauptinhalt springen
POST
Not-Aus-Schalter
Verwenden Sie diesen Endpunkt für Notfälle wie einen kompromittierten Agenten. Geben Sie den Agentenbezeichner und einen nicht leeren Vorfall reason (maximal 2000 UTF-8-Bytes) an. Der authentifizierte Arbeitsbereich und die Umgebung bestimmen, welchen Agenten Sie widerrufen können. Der Vorgang widerruft den Agenten und seine delegierten Nachkommen, beendet ihre aktiven Sitzungen, widerruft ihre aktiven Delegationslinks und speichert die Entscheidung in einer Datenbanktransaktion. Falls diese Transaktion fehlschlägt, werden ihre Statusänderungen zurückgesetzt.
Der Widerruf ist dauerhaft. Registrieren Sie einen neuen Agenten, wenn die Arbeit wieder aufgenommen werden muss. Zuvor ausgestellte Belegnachweise bleiben erhalten; dieser Endpunkt löscht oder überschreibt sie nicht.

Ergebnis prüfen

Eine erfolgreiche Antwort enthält status: "killed". agents_changed enthält den angeforderten Agenten; cascade_count zählt neu widerrufene Nachkommen. sessions_terminated und delegations_revoked melden die betroffenen Sitzungen und Delegationslinks. Wenn die verwaltete Signierung erfolgreich ist, ist receipt_status signed und receipt_id identifiziert eine signierte Widerrufsempfangsbestätigung. Rufen Sie diese über die Receipts API ab. Die Gültigkeit der Signatur und der Lebenszyklusstatus des widerrufenen Agenten sind separate Prüfungen. Wenn die Signierung nicht verfügbar ist, ist der Widerruf dennoch erfolgreich: receipt_status ist unavailable und receipt_id ist null. Die dauerhafte Widerrufsentscheidung bleibt aufgezeichnet. Eine signierte Quittung oder ein automatischer Signaturwiederholungsversuch ist durch diese Antwort nicht impliziert.

Audit-Verhalten

Der Dienst zeichnet ein agent.killed-Ereignis und ein Widerrufsereignis zusammen mit den Statusänderungen auf. Eine Antwort stellt keine externe Transparenzverankerung, Webhook-Zustellung oder SIEM-Zustellung her. Überprüfen Sie diese Kanäle separat, wenn Ihr Vorfallprozess davon abhängt. Ein unbekannter Agent in der ausgewählten Arbeitsbereichsumgebung gibt 404 zurück. Ein bereits widerrufener Agent gibt 409 zurück. Überprüfen Sie den bestehenden Status, bevor Sie eine Notfallanfrage erneut versuchen.

Autorisierungen

X-API-Key
string
header
erforderlich

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

Pfadparameter

agentId
string
erforderlich

Agenten-Identifikator

Body

application/json
reason
string
erforderlich

Nicht leerer Vorfallgrund, maximal 2000 UTF-8 Bytes

Required string length: 1 - 2000

Antwort

Agent getötet

agent_id
string
tenant_id
string<uuid>
status
enum<string>
Verfügbare Optionen:
killed
agents_changed
integer
cascade_count
integer

Nachfolgende Agenten neu widerrufen, ausgenommen der angeforderte Agent.

sessions_terminated
integer
delegations_revoked
integer
reason
string
killed_at
string<date-time>
receipt_id
string | null

ID des signierten Widerrufsbelegs oder null, wenn die Signatur nicht verfügbar war.

receipt_status
enum<string>

Nicht verfügbar macht die abgeschlossene Notfallwiderrufung nicht rückgängig.

Verfügbare Optionen:
signed,
unavailable