Zum Hauptinhalt springen
POST
/
api
/
v1
/
CascadeAnalytics
Cascade Analytics abrufen
curl --request POST \
  --url https://server.codeium.com/api/v1/CascadeAnalytics \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "group_name": "<string>",
  "start_timestamp": "<string>",
  "end_timestamp": "<string>",
  "emails": [
    {}
  ],
  "ide_types": [
    {}
  ],
  "query_requests": [
    {}
  ]
}
'
{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "<string>",
            "linesSuggested": "<string>",
            "linesAccepted": "<string>"
          }
        ]
      },
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "<string>",
            "model": "<string>",
            "mode": "<string>",
            "messagesSent": "<string>",
            "cascadeId": "<string>",
            "promptsUsed": "<string>"
          }
        ]
      },
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "<string>",
            "count": "<string>"
          }
        ]
      }
    }
  ]
}

​
Übersicht

Rufen Sie Cascade-spezifische Analytics-Daten ab, darunter vorgeschlagene und akzeptierte Zeilen, AI‑Modellnutzung, Kreditverbrauch und Tool‑Nutzungsstatistiken.

​
Anfrage

​
service_key
string
erforderlich
Ihr Service Key mit Berechtigung „Teams Nur-Lesen“
​
group_name
string
Ergebnisse auf Benutzer in einer bestimmten Gruppe beschränken. Kann nicht zusammen mit dem Parameter emails verwendet werden.
​
start_timestamp
string
Startzeit im RFC 3339-Format (z. B. 2023-01-01T00:00:00Z)
​
end_timestamp
string
Endzeit im RFC 3339-Format (z. B. 2023-12-31T23:59:59Z)
​
emails
array
Array von E-Mail-Adressen zum Filtern der Ergebnisse. Kann nicht zusammen mit dem Parameter group_name verwendet werden.
​
ide_types
array
Nach IDE-Typ filtern. Verfügbare Optionen:
  • "editor" - Windsurf Editor
  • "jetbrains" - JetBrains-Plugin
Wenn weggelassen, werden Daten für beide IDEs zurückgegeben.
​
query_requests
array
erforderlich
Array von Datenquellenabfragen, die ausgeführt werden sollen. Jedes Objekt sollte eine der unterstützten Datenquellen enthalten.

​
Datenquellen

​
cascade_lines

Abfrage der täglich vorgeschlagenen und angenommenen Cascade-Zeilen. 
{
  "cascade_lines": {}
}
Antwortfelder:
  • day - Datum im RFC 3339-Format
  • linesSuggested - Anzahl der vorgeschlagenen Zeilen
  • linesAccepted - Anzahl der übernommenen Zeilen

​
cascade_runs

Abfrage nach AI-Modellnutzung, Credit-Verbrauch und Modusinformationen. 
{
  "cascade_runs": {}
}
Antwortfelder:
  • day - Datum im RFC-3339-Format
  • model - Name des verwendeten AI-Modells
  • mode - Cascade-Modus (siehe Modi unten)
  • messagesSent - Anzahl gesendeter Nachrichten
  • cascadeId - Eindeutige Gesprächs-ID
  • promptsUsed - Genutzte Credits (in Cent)
Cascade-Modi:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Schreibmodus
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Lesemodus
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Legacy-Modus
  • UNKNOWN - Unbekannter Modus

​
cascade_tool_usage

Abfrage von Nutzungsstatistiken für Tools (aggregierte Gesamtzahlen). 
{
  "cascade_tool_usage": {}
}
Antwortfelder:
  • tool - Tool-Bezeichner (siehe Tool-Zuordnungen unten)
  • count - Anzahl der Verwendungen des Tools

​
Zuordnungen der Tool-Nutzung

Tool IdentifierAnzeigename
CODE_ACTIONCode bearbeiten
VIEW_FILEDatei anzeigen
RUN_COMMANDBefehl ausführen
FINDSuchtool
GREP_SEARCHGrep-Suche
VIEW_FILE_OUTLINEDateiübersicht anzeigen
MQUERYRiptide
WORKFLOWS_USEDVerwendete Workflows
LIST_DIRECTORYVerzeichnis auflisten
MCP_TOOLMCP-Tool
PROPOSE_CODECode vorschlagen
SEARCH_WEBIm Web suchen
MEMORYMemory
PROXY_WEB_SERVERBrowser-Vorschau
DEPLOY_WEB_APPWeb-App bereitstellen

​
Beispielanfrage

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2025-01-01T00:00:00Z",
  "end_timestamp": "2025-01-02T00:00:00Z",
  "emails": ["user1@windsurf.com", "user2@windsurf.com"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics

​
Antwort

​
queryResults
array
Array von Abfrageergebnissen, eines für jede Abfrage

​
Beispielantwort

{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "2025-05-01T00:00:00Z",
            "linesSuggested": "206",
            "linesAccepted": "157"
          },
          {
            "day": "2025-05-02T00:00:00Z",
            "linesSuggested": "16"
          }
        ]
      }
    },
    {
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "2025-05-01T00:00:00Z",
            "model": "Claude 3.7 Sonnet (Thinking)",
            "mode": "CONVERSATIONAL_PLANNER_MODE_DEFAULT",
            "messagesSent": "1",
            "cascadeId": "0d35c1f7-0a85-41d0-ac96-a04cd2d64444"
          }
        ]
      }
    },
    {
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "CODE_ACTION",
            "count": "15"
          },
          {
            "tool": "LIST_DIRECTORY",
            "count": "20"
          }
        ]
      }
    }
  ]
}

​
Hinweise

  • Die API gibt Rohdaten zurück, die möglicherweise „UNKNOWN“-Werte enthalten
  • Für Metrik-Analysen nach bestimmten Feldern von Interesse aggregieren (z. B. promptsUsed aufsummieren, um Nutzungsmuster zu erkennen)
  • Mode- und Prompt-Daten können über mehrere Einträge verteilt sein
  • Der Verbrauch von Credits (promptsUsed) wird in Cent angegeben (100 = 1 Credit)