Get Dashboard Interactions
Other Endpoints
Get Dashboard Interactions
Retrieve detailed conversation-level data for granular analysis and reporting
GET
Get Dashboard Interactions
Returns comprehensive conversation data including user details, agent information, usage metrics, and tool invocations.
Authentication
This endpoint requires a valid JWT token from Clerk authentication. The token must include organization membership.Query Parameters
string
required
Start date for the query range (ISO 8601 format, e.g., “2024-01-01T00:00:00.000Z”)
string
required
End date for the query range (ISO 8601 format, e.g., “2024-12-31T23:59:59.999Z”)
boolean
default:"false"
Whether to include conversations for all users in the organization. Requires
org:admin role.string
Filter results to a specific user ID (admin only when
allInOrg is true)string
Filter by a specific metadata key in user’s organization-scoped metadata
string
Filter by a specific metadata value. Can be used with or without metadataKey. Only searches within the current organization.
Response
Returns an array of conversation objects, organized hierarchically with sub-conversations nested under their parent conversations.string
Unique conversation identifier
number
ID of the agent used in this conversation
string
Parent conversation ID if this is a sub-conversation
string
ISO 8601 timestamp when conversation was created
string
ISO 8601 timestamp when conversation was last updated
string
Display name of the agent
string
AI model used by the agent (e.g., “gpt-4”, “claude-3-sonnet”)
string
URL to the agent’s logo/avatar image
string
Clerk user ID of the conversation participant
string
Email address of the user
string
User’s first name
string
User’s last name
object
Organization-scoped user metadata (isolated per organization)
string
Text content of the first message in the conversation
number
Number of messages sent by the user
number
Number of messages sent by the assistant
number
Total number of messages in the conversation
number
Conversation duration in seconds
number
Total token usage for this conversation
number
Input tokens (user messages and system prompts) for this conversation
number
Output tokens (assistant responses) for this conversation
number
Number of file attachments in the conversation
array
Array of all tool invocations made during the conversation
string
Reason the last message generation finished (e.g., “stop”, “length”, “tool_calls”)
number
Total number of feedback responses for this conversation
number
Number of positive feedback responses
number
Number of negative feedback responses
array
Detailed feedback data with timestamps and comments
array
Array of nested sub-conversations (same structure as parent)
Examples
Error Codes
object
Forbidden - User lacks required permissions (e.g., non-admin trying to use
allInOrg=true)object
Internal Server Error - Server encountered an unexpected condition
Notes
- Results are ordered by
updatedAtin descending order (most recent first) - Conversations marked as deleted (
deletedAtis not null) are excluded from results - Sub-conversations are nested under their parent conversation in the
subConversationsarray - Tool calls include the complete invocation data with arguments and results
- Metadata filtering is organization-scoped: Only searches within the current organization’s user metadata
- Metadata filtering supports flexible querying across user’s publicMetadata JSON field
- All dates are returned in ISO 8601 format
- When
allInOrg=true, only users withorg:adminrole can access organization-wide data