Zum Hauptinhalt springen
GET
Sitzungen auflisten

Sitzungen auflisten

GET /v1/agent-sessions Gibt eine paginierte Liste von Agentensitzungen für den authentifizierten Mandanten zurück. Die Ergebnisse können nach Agenten-ID und Sitzungsstatus gefiltert werden. Sitzungen werden in umgekehrter chronologischer Reihenfolge (neueste zuerst) zurückgegeben.

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

object[]
Array von Session-Objekten. Jedes enthält session_id, agent_id, status, scopes, metadata, expires_at, parent_session_id, handed_off_to, ip_address, user_agent, refreshed_at, terminated_at, created_at und updated_at. Token-Hashes werden niemals in Listenantworten offengelegt.
integer
Gesamtzahl der Sitzungen, die den Filterkriterien entsprechen, über alle Seiten hinweg.

Beispiel


Referenz zum Sitzungsstatus

Autorisierungen

X-API-Key
string
header
erforderlich

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

Abfrageparameter

agent_id
string<uuid>

Sitzungen nach Agent filtern

status
enum<string>

Nach Sitzungsstatus filtern

Verfügbare Optionen:
active,
terminated,
expired
limit
integer
Standard:25
Erforderlicher Bereich: 1 <= x <= 100
offset
integer
Standard:0
Erforderlicher Bereich: x >= 0

Antwort

Paginierte Liste der Sitzungen

items
object[]
total
integer