Zum Hauptinhalt springen
DELETE
Sitzung beenden

Sitzung beenden

DELETE /v1/agent-sessions/{sessionID} Beendet sofort eine aktive Agentensitzung. Der Zugriffstoken und der Aktualisierungstoken der Sitzung werden ungültig gemacht, und der Sitzungsstatus wechselt zu "terminated". Alle nachfolgenden API-Aufrufe, die die Token dieser Sitzung verwenden, werden abgelehnt.
Die Beendigung der Sitzung wird im Audit-Log mit einem AGENT_SESSION_TERMINATED Ereignis. Ein Kündigungsbeleg wird nicht automatisch generiert – verwenden Sie die Beleg-API, um einen zu erstellen, wenn Ihr Compliance-Workflow es erfordert.

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 "terminated".
string
Der MAIP-Sitzungsbezeichner, der beendet wurde.

Beispiel


Massenbereinigung von Sitzungen

Um alle aktiven Sitzungen für einen bestimmten Agenten zu beenden (z. B. während der Reaktion auf einen Vorfall), listen Sie die Sitzungen nach Agent und Status gefiltert auf und beenden Sie dann jede einzelne:
Für eine schnellere Reaktion auf Vorfälle, das Aussetzen des Agent blockiert sofort alle Sitzungsoperationen, ohne dass eine individuelle Sitzungsbeendigung erforderlich ist.

Autorisierungen

X-API-Key
string
header
erforderlich

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

Pfadparameter

sessionId
string<uuid>
erforderlich

Sitzungs-ID

Body

application/json
reason
string
erforderlich

Grund für die Beendigung

Antwort

Sitzung beendet

session_id
string<uuid>
agent_id
string<uuid>
token
string

Sitzungs-Bearer-Token (einmalig bei Erstellung zurückgegeben)

scopes
string[]
status
enum<string>
Verfügbare Optionen:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>