Session Detail
rybbit_get_sessionRead-onlyIdempotent
Retrieve comprehensive session analytics including page views, events, user traits, device information, location data, and complete event timeline for detailed user behavior analysis.
Instructions
Get detailed session information including all page views, events, user traits, device info, location, and full event timeline. Use rybbit_list_sessions first to find session IDs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siteId | Yes | Site ID (numeric ID or domain identifier) | |
| sessionId | Yes | Session ID to retrieve |
Implementation Reference
- src/tools/sessions.ts:150-194 (handler)Registration and handler implementation for the 'rybbit_get_session' tool.
server.registerTool( "rybbit_get_session", { title: "Session Detail", description: "Get detailed session information including all page views, events, user traits, device info, location, and full event timeline. Use rybbit_list_sessions first to find session IDs.", annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false, }, inputSchema: { siteId: siteIdSchema, sessionId: z.string().describe("Session ID to retrieve"), }, }, async (args) => { try { const { siteId, sessionId } = args as { siteId: string; sessionId: string; }; const data = await client.get<SessionDetail>( `/sites/${siteId}/sessions/${sessionId}` ); return { content: [ { type: "text" as const, text: truncateResponse(data), }, ], }; } catch (err) { const message = err instanceof Error ? err.message : String(err); return { content: [{ type: "text" as const, text: `Error: ${message}` }], isError: true, }; } } );