Overview
Theprincipal_sessions sub-client lets you create short-lived session tokens for your end-users. These tokens power the Permission Dashboard where users can view which agents have access and revoke grants.
principal_sessions.create()
Create a session token for an end-user. Returns a URL they can open to manage their permissions.Parameters: CreatePrincipalSessionParams
Response: PrincipalSessionResponse
Full URL the user can open in their browser to view and revoke permissions. The session token is carried in the URL fragment (
#session=...), not the query string, so it is never transmitted to the server or captured in Referer headers or access logs.