Users

Create a durable connect session

Creates a durable connect session for invisible end-user onboarding. The session can be used from a partner app, email recovery flow, CLI handoff, or agent-driven flow and is exchanged into fresh pit_ tokens during provider OAuth. Partner credentials may create a session for any provisioned user. A user sk_ token may create a session for its own user only; in that case an existing active session with more than a day left is returned, otherwise a fresh one is minted. pit_ tokens are not accepted on this route.

post/v1/users/{user_id}/connect-sessions

Request

  • Base URL: http://0.0.0.0:3000
  • URL: http://0.0.0.0:3000/v1/users/{user_id}/connect-sessions
  • Auth: none declared

Path parameters

user_idstring uuid required

Request body

client_idstring
provider'gmail' | 'outlook' | 'slack' | 'google_calendar' | 'google_meet' | 'teams'
display'popup' | 'redirect'
return_tostring uri
include_installboolean

Response

Default Response

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.