Get a Client Session

Get a specified client session

Returns a specified client session.

/client_sessions/get

post

Returns a specified client session.

Authorizations

client_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

client_session_idstring · uuidOptional

ID of the client session that you want to get.

user_identifier_keystringOptional

User identifier key associated with the client session that you want to get.

Responses

200

OK

application/json

okbooleanRequired

400

Bad Request

401

Unauthorized

post

/client_sessions/get

HTTPcURLJavaScriptPython

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

{
  "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
  "user_identifier_key": "text"
}

{
  "client_session": {
    "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-02-21T02:41:21.366Z",
    "expires_at": "2026-02-21T02:41:21.366Z",
    "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

Specify the desired client session by including the corresponding client_session_id or user_identifier_key in the request body.

Request Body Parameters

Parameter	Type	Description
client_session_id	String Optional	ID of the desired client session.
user_identifier_key	String Optional	Your own internal user ID for the user associated with the client session to retrieve.

Sample Request

JavaScript

const clientSession = await seam.clientSessions.get({
  client_session_id: "c75d4330-ae01-4dfd-b6c5-f3e94e0d8168",
})

Response

Returns a client_session containing 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
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
connect_webview_ids	Array of Connect Webview IDs associated with the client session
user_identity_ids	Array of user identity IDs on behalf of which which the client session may act

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',
  device_count: 4,
  connected_account_ids: [
    '3ea0b67f-649f-4131-bfe3-f2035e77a3f9',
    '6e1cad57-b244-40ca-b4f3-30a46c8000d4'
  ],
  connect_webview_ids: [],
  user_identity_ids: []
}