Skip to main content
POST
Get Cascade Analytics

Overview

Retrieve Cascade-specific analytics data including lines suggested/accepted, model usage, credit consumption, and tool usage statistics.

Request

string
required
Your service key with “Teams Read-only” permissions
string
Filter results to users in a specific group. Cannot be used with emails parameter.
string
Start time in RFC 3339 format (e.g., 2023-01-01T00:00:00Z)
string
End time in RFC 3339 format (e.g., 2023-12-31T23:59:59Z)
array
Array of email addresses to filter results. Cannot be used with group_name parameter.
array
Filter by IDE type. Available options:
  • "editor" - Devin Desktop Editor
  • "jetbrains" - JetBrains Plugin
  • "cli" - Devin CLI
If omitted, returns data for all IDEs.
When filtering by Devin CLI ("cli"), the mode field of cascade_runs is not populated. cascade_lines and cascade_tool_usage cover Devin CLI and Devin Local activity, but only include data recorded after those agents began reporting it.
array
required
Array of data source queries to execute. Each object should contain one of the supported data sources.

Data Sources

cascade_lines

Query for daily Cascade lines suggested and accepted.
Response Fields:
  • day - Date in RFC 3339 format
  • linesSuggested - Number of lines suggested
  • linesAccepted - Number of lines accepted

cascade_runs

Query for model usage, credit consumption, and mode data.
Response Fields:
  • day - Date in RFC 3339 format
  • model - Model name used
  • mode - Cascade mode (see modes below)
  • messagesSent - Number of messages sent
  • cascadeId - Unique conversation ID
  • promptsUsed - Credits consumed (in cents)
Cascade Modes:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Write mode
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Read mode
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Legacy mode
  • UNKNOWN - Unknown mode

cascade_tool_usage

Query for tool usage statistics (aggregate counts).
Response Fields:
  • tool - Tool identifier (see tool mappings below)
  • count - Number of times tool was used

Tool Usage Mappings

Example Request

Response

array
Array of query results, one for each query request

Example Response

Notes

  • The API returns raw data which may contain “UNKNOWN” values
  • For metrics analysis, aggregate by specific fields of interest (e.g., sum promptsUsed for usage patterns)
  • Mode and prompt data may be split across multiple entries
  • Credit consumption (promptsUsed) is returned in cents (100 = 1 credit)