Skip to main content
GET
Get session information
This endpoint returns comprehensive session information including timeout configuration, renewal count, and real-time expiration status.

Path Parameters

string
required
The unique identifier of the session

Response

string
Unique session identifier
string
UUID of the agent
string
UUID of the user
string
ISO timestamp of session creation
string
ISO timestamp of last activity in the session
string
ISO timestamp when the session will expire
object
Current timeout configuration for the session
number
Number of times the session has been renewed
number
Milliseconds until session expiration
boolean
Whether the session is within the warning threshold
object
Any metadata attached to the session

Error Responses

Path Parameters

sessionId
string
required

ID of the session

Response

Session information retrieved successfully

sessionId
string
agentId
string<uuid>
userId
string<uuid>
createdAt
string<date-time>
lastActivity
string<date-time>
metadata
object
expiresAt
string<date-time>

When the session will expire

timeoutConfig
object

Current timeout configuration

renewalCount
integer

Number of times the session has been renewed

timeRemaining
integer

Milliseconds until session expiration

isNearExpiration
boolean

Whether the session is within the warning threshold