Sessions

Use the scalekit_client.sessions client to inspect session metadata and revoke sessions when users sign out or you detect risk.

Typical flows: load a session by ID after authentication, list a user’s sessions for a security UI, and revoke one session or all of a user’s sessions on logout.

get_session

clientSessionshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/sessions.py

#asyncget_session

Method to get session details by session ID

paramsession_idstr

Session ID to get session details

returnsSessionDetails

Session Details

response = scalekit_client.sessions.get_session('session_123456')
session = response[0]

get_user_sessions

clientSessionshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/sessions.py

#asyncget_user_sessions

Method to get all session details for a user with pagination and filtering support

paramuser_idstr

User ID to get all session details for

parampage_sizeint

Optional. Number of sessions to return per page

parampage_tokenstr

Optional. Token for pagination to get next/previous page

paramfilterUserSessionFilter

Optional. Filter to apply to sessions (status, time range)

returnsUserSessionDetails

User Session Details with pagination info

response = scalekit_client.sessions.get_user_sessions(
    'usr_123456',
    page_size=50
)

for session in response[0].sessions:
    print(f'Session: {session.id}')

revoke_session

clientSessionshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/sessions.py

#asyncrevoke_session

Method to revoke a session for a user

paramsession_idstr

Session ID to revoke

returnsRevokeSessionResponse

Revoke Session Response

response = scalekit_client.sessions.revoke_session('session_123456')

revoke_all_user_sessions

clientSessionshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/sessions.py

#asyncrevoke_all_user_sessions

Method to revoke all sessions for a user

paramuser_idstr

User ID to revoke all sessions for

returnsRevokeAllUserSessionsResponse

Revoke All User Sessions Response

response = scalekit_client.sessions.revoke_all_user_sessions('usr_123456')

create_session_filter

clientSessionshttps://github.com/scalekit-inc/scalekit-sdk-python/blob/main/scalekit/sessions.py

#asynccreate_session_filter

Helper method to create a UserSessionFilter for filtering sessions

paramstatusOptional[List[str]]

Optional. List of session statuses to filter by

paramstart_timeOptional[Timestamp]

Optional. Filter sessions from this timestamp

paramend_timeOptional[Timestamp]

Optional. Filter sessions until this timestamp

returnsUserSessionFilter

UserSessionFilter object