List Client Sessions

Get all client sessions

Returns a list of all client sessions.

/client_sessions/list

post

Returns a list of all client sessions.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

client_session_idstringOptional

ID of the client session that you want to retrieve.

user_identifier_keystringOptional

Your user ID for the user by which you want to filter client sessions.

connect_webview_idstringOptional

ID of the Connect Webview for which you want to retrieve client sessions.

without_user_identifier_keybooleanOptional

Indicates whether to retrieve only client sessions without associated user identifier keys.

user_identity_idstringOptional

ID of the user identity for which you want to retrieve client sessions.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/client_sessions/list

HTTPcURLJavaScriptPython

POST /client_sessions/list HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "client_session_id": "text",
  "user_identifier_key": "text",
  "connect_webview_id": "text",
  "without_user_identifier_key": true,
  "user_identity_id": "text"
}

{
  "client_sessions": [
    {
      "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-02-21T00:14:26.582Z",
      "expires_at": "2026-02-21T00:14:26.582Z",
      "token": "text",
      "user_identifier_key": "text",
      "device_count": 1,
      "customer_key": "text",
      "connected_account_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "connect_webview_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "user_identity_id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "ok": true
}

Request

List all client sessions or filter the list of client sessions by including the corresponding filter parameters in the request body.

Request Body Parameters

Parameter	Type	Description
client_session_id	String Optional	ID of the client session that you want to retrieve
user_identifier_key	String Optional	Your own internal user ID for the user by which to filter client sessions
connect_webview_id	String Optional	ID of the Connect Webview for which you want to retrieve client sessions
without_user_identifier_key	Boolean Optional	Indicates whether to retrieve only client sessions without associated user identifier keys

Sample Request

JavaScript

await seam.clientSessions.list()

Response

Returns a client_sessions array, in which each returned client session (client_session) contains the following properties:

Property	Description
workspace_id	ID of the workspace that contains the client session
token	Client session token associated with the client session
user_identifier_key	Your own internal user ID for the user
created_at	Date and time at which the client session was created
client_session_id	ID of the client session
user_identity_ids	Array of user identity IDs on behalf of which which the client session may act
connect_webview_ids	Array of Connect Webview IDs associated with the client session
device_count	Number of devices to which the client session grants access
connected_account_ids	Array of connected account IDs associated with this client session

This response also includes a Boolean ok status indicator.

Sample Response

JSON

[
  {
    workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
    token: 'seam_cst1271Q3JUh_A3ECdSrrqgYp98SmB9qY2NGp',
    user_identifier_key: 'internal user ID 1',
    created_at: '2023-12-26T04:23:46.829Z',
    client_session_id: 'c75d4330-ae01-4dfd-b6c5-f3e94e0d8168',
    user_identity_ids: [],
    connect_webview_ids: [],
    device_count: 4,
    connected_account_ids: [
      '3ea0b67f-649f-4131-bfe3-f2035e77a3f9',
      '6e1cad57-b244-40ca-b4f3-30a46c8000d4'
    ]
  },
  {
    workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
    token: 'seam_cst1891oqCmE_6dBwV8PJ2Ffoe9dWYVyMfVHq',
    user_identifier_key: 'internal user ID 2',
    created_at: '2023-12-26T04:25:50.041Z',
    client_session_id: 'e1006128-19a8-4e4d-9a91-536d80cf9c21',
    user_identity_ids: [],
    connect_webview_ids: [],
    device_count: 4,
    connected_account_ids: [
      '2e884e71-b2c1-41a0-bb2c-ec94a7b4c6a4',
      'b0ccf472-cb63-400c-bf21-5b809f5e1afd'
    ]
  },
  ...
]