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

service_key
string
required
Your service key with “Teams Read-only” permissions
group_name
string
Filter results to users in a specific group. Cannot be used with emails parameter.
start_timestamp
string
Start time in RFC 3339 format (e.g., 2023-01-01T00:00:00Z)
end_timestamp
string
End time in RFC 3339 format (e.g., 2023-12-31T23:59:59Z)
emails
array
Array of email addresses to filter results. Cannot be used with group_name parameter.
ide_types
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"), only cascade_runs returns data. The cascade_lines and cascade_tool_usage data sources are not supported for Devin CLI and will return empty results.
query_requests
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

queryResults
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)