Passer au contenu principal
GET
Lister les sessions

Lister les sessions

GET /v1/agent-sessions Renvoie une liste paginée des sessions d’agent pour le locataire authentifié. Les résultats peuvent être filtrés par ID d’agent et statut de session. Les sessions sont renvoyées par ordre chronologique inverse (les plus récentes en premier).

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

object[]
Tableau d’objets de session. Chacun contient 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, et updated_at. Les hachages de jetons ne sont jamais exposés dans les réponses de liste.
integer
Nombre total de sessions correspondant aux critères de filtre, sur toutes les pages.

Exemple


Référence de l’état de la session

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de requête

agent_id
string<uuid>

Filtrer les sessions par agent

status
enum<string>

Filtrer par statut de session

Options disponibles:
active,
terminated,
expired
limit
integer
défaut:25
Plage requise: 1 <= x <= 100
offset
integer
défaut:0
Plage requise: x >= 0

Réponse

Liste paginée des sessions

items
object[]
total
integer