Skip to content

Users

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).

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

NameTypeRequiredDescription
userIdstringThe end user whose sessions to list.

Response

FieldTypeAlwaysDescription
sessionsarray

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

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.

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>"
}

Esc

Start typing to search the docs.

navigateselect