users_sessions_list

Tool

users_sessions_list

List the end-user sessions of one user of this product, newest first — one row per device, with its status, device metadata and both expiries (the sliding inactivity window and the hard time-box).

List the end-user sessions of one user of this product, newest first — one row per device, with its status, device metadata and both expiries (the sliding inactivity window and the hard time-box). Revoked and expired sessions are included so an operator can see what happened, not only what is live.

Behavior

HTTP: GET /users/sessions

Arguments

Name	Type	Required	Description
userId	string	•	The end user whose sessions to list.

Response

Field	Type	Always	Description
sessions	array	•	The sessions matching the filter, newest first.

Try it

List the end-user sessions of one user of this product, newest first — one row per device, with its status, device metadata and both expiries (the sliding inactivity window and the hard time-box).

When to use

Example

Ask your agent something like this:

List the end-user sessions of one user of this product, newest first — one row per device, with its status, device metadata and both expiries (the sliding inactivity window and the hard time-box).

The agent will invoke users_sessions_list with these arguments:

{
  "userId": "<userId>"
}