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

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

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 to which you want to grant access to resources.

user_identifier_keystringOptional

Your user ID for the user that you want to associate with the client session.

connected_account_idsstring[]Optional

IDs of the connected accounts that you want to associate with the client session.

connect_webview_idsstring[]Optional

IDs of the Connect Webviews that you want to associate with the client session.

user_identity_idsstring[] · min: 1 · max: 1OptionalDeprecated

IDs of the user identities that you want to associate with the client session.

user_identity_idstringOptional

ID of the user identity that you want to associate with the client session.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/client_sessions/grant_access

HTTPcURLJavaScriptPython

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

{
  "client_session_id": "text",
  "user_identifier_key": "text",
  "connected_account_ids": [
    "text"
  ],
  "connect_webview_ids": [
    "text"
  ],
  "user_identity_id": "text"
}

{
  "client_session": {
    "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-01-30T22:32:09.036Z",
    "expires_at": "2026-01-30T22:32:09.036Z",
    "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 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
}