Skip to main content
POST

Authorizations

seam-publishable-key
string
header
required

Body

application/json
connect_webview_ids
string[]

IDs of the Connect Webviews that you want to associate with the client session (or that are already associated with the existing client session).

connected_account_ids
string[]

IDs of the connected accounts that you want to associate with the client session (or that are already associated with the existing client session).

expires_at
string<date-time>

Date and time at which the client session should expire in ISO 8601 format. If the client session already exists, this will update the expiration before returning it.

user_identifier_key
string

Your user ID for the user that you want to associate with the client session (or that is already associated with the existing client session). When you authenticate with a publishable key, the user_identifier_key must be a high-entropy secret that only the user knows, such as a UUIDv4 or a salted hash. Do not use an email address, name, phone number, or other guessable value, because anyone who knows the user_identifier_key can retrieve the client session.

Minimum string length: 1
user_identity_id
string<uuid>

ID of the user identity that you want to associate with the client session (or that are already associated with the existing client session).

user_identity_ids
string<uuid>[]
deprecated

Deprecated. Use user_identity_id.

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

Required array length: 1 element

Response

OK

client_session
object
required

Represents a client session. If you want to restrict your users' access to their own devices, use client sessions. See the client_session object.