Grant Access to a Client Session

Grant a client session access to resources

Grants a client session access to one or more resources, such as Connect Webviews, user identities, and so on.

/client_sessions/grant_access

post

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

Body

client_session_idstringoptional

user_identifier_keystringoptional

connected_account_idsstring[]optional

connect_webview_idsstring[]optional

user_identity_idsstring[]optional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://connect.getseam.com/client_sessions/grant_access' \
  --header 'Authorization: Bearer API Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "client_session_id": "text",
    "user_identifier_key": "text",
    "connected_account_ids": [
      "text"
    ],
    "connect_webview_ids": [
      "text"
    ],
    "user_identity_ids": [
      "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-03-25T22:25:10.893Z",
    "expires_at": "2025-03-25T22:25:10.893Z",
    "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 resources that you want a client session to be able to access by including the corresponding parameters in the request body. You can also specify an existing client session ID if desired.

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 to associate with the client session
connected_account_ids	Array of strings Optional	Array of IDs of the connected accounts to associate with the client session
connect_webview_ids	Array of strings Optional	Array of IDs of the Connect Webviews to associate with the client session
user_identity_ids	Array of strings Optional	Array of IDs of the user identities to associate with the client session

Sample Request

JavaScript

await seam.clientSessions.grant_access({
  user_identifier_key: "internal user ID 2",
  connect_webview_ids: [
    "b9f2ad01-12b7-47cf-b566-ed5d9b47e834"
  ]
})

Response

Returns a client_session containing the following properties:

Property	Description
token	Client session token associated with the client session
workspace_id	ID of the workspace that contains the client session
user_identifier_key	Your own internal user ID for the user
client_session_id	ID of the client session
created_at	Date and time at which the client session was created

This response also includes a Boolean ok status indicator.

Sample Response

JSON

{
  workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
  token: 'seam_cst12GGG4LUp_AoHvcSx39aY4AoHQ7GdMDRTH',
  user_identifier_key: 'internal user ID 2',
  created_at: '2023-12-26T05:11:55.048Z',
  client_session_id: '911b4a3f-e566-44a9-a8ac-267d9e586754',
  connected_account_ids: [
      '3ea0b67f-649f-4131-bfe3-f2035e77a3f9',
      '6e1cad57-b244-40ca-b4f3-30a46c8000d4'],
  connect_webview_ids: [
      'b9f2ad01-12b7-47cf-b566-ed5d9b47e834'],
  user_identity_ids: [
      '5c945ab5-c75e-4bcb-8e5f-9410061c401f'],
  device_count: 4
}