Passer au contenu principal
DELETE
Terminer la session

Terminer la session

DELETE /v1/agent-sessions/{sessionID} Termine immédiatement une session d’agent active. Le jeton d’accès et le jeton de rafraîchissement de la session sont invalidés, et le statut de la session passe à "terminated". Tout appel API ultérieur utilisant les jetons de cette session sera rejeté.
La fin de session est enregistrée dans le journal d’audit avec un AGENT_SESSION_TERMINATED événement. Un reçu de résiliation n’est pas automatiquement généré — utilisez l’API des reçus pour en créer un si votre flux de travail de conformité l’exige.

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

string
Statut mis à jour, toujours "terminated" en cas de succès.
string
L’identifiant de session MAIP qui a été terminé.

Exemple


Nettoyage de session en masse

Pour terminer toutes les sessions actives pour un agent spécifique (par exemple, pendant la réponse à un incident), listez les sessions filtrées par agent et statut, puis terminez chacune d’elles :
Pour une réponse plus rapide aux incidents, suspendre le agent bloque immédiatement tous les opérations de session sans nécessiter de terminaison de session individuelle.

Autorisations

X-API-Key
string
header
requis

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

Paramètres de chemin

sessionId
string<uuid>
requis

Identifiant de session

Corps

application/json
reason
string
requis

Raison de la résiliation

Réponse

Session terminée

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

Jeton de porteur de session (retourné une seule fois lors de la création)

scopes
string[]
status
enum<string>
Options disponibles:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>