Get a Client Session

Get a specified client session

Returns a specified client session.

/client_sessions/get

post

Authorizations

client_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

Body

client_session_idstringoptional

user_identifier_keystringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://connect.getseam.com/client_sessions/get' \
  --header 'Authorization: Bearer Client Session Token' \
  --header 'Content-Type: application/json' \
  --data '{
    "client_session_id": "text",
    "user_identifier_key": "text"
  }'

200

400

401

200

{
  "client_session": {
    "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2025-04-03T04:15:30.209Z",
    "expires_at": "2025-04-03T04:15:30.209Z",
    "token": "text",
    "user_identifier_key": "text",
    "device_count": 1,
    "connected_account_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "connect_webview_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "user_identity_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  },
  "ok": true
}

OK

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: []
}