Skip to main content
v2 API は alpha 版であり、今後いつでも変更される可能性があります。

​
概要

Analytics API v2 は、Devin Desktop Analytics API の次世代版です。クリーンな REST エンドポイントを通じて、消費量 分析 (クレジットと ACU)、アクティブユーザー、エージェントの出力 (採用されたコード行数) を提供します。クエリパラメータによるフィルタリング、柔軟な グループ化、カーソル方式のページネーションに対応しています。
API の仕様が確定するまでは、v2 エンドポイントは現在 /api/v2alpha プレフィックス で提供されています。ベース URL は https://server.codeium.com です。

​
v2 の新機能

v1 との最大の違いは、認証です。

​
認証

v2 では Bearer トークン 認証を利用します。認証情報はリクエストボディではなく、Authorization ヘッダーに渡してください：
利用できる認証情報は 2 種類です。Devin サービスユーザー APIキー (推奨 — Devin API で利用する cog_ キーと同じもの) または Windsurf サービスキーです。

​
Devin サービスユーザー APIキー

すでに Devin のサービスユーザーを管理している場合、Windsurf 用に別途認証情報を作成する必要はありません。
  1. 組織の場合は Settings > Devin API (サービスユーザー タブ)、Enterprise の場合は Enterprise settings > Devin API (サービスユーザー タブ) でサービスユーザーをプロビジョニングします
  2. Use Local Analytics API 権限を含むカスタムロールを割り当てます (組み込みの管理者ロールにはすでにこの権限が含まれています)
  3. プロビジョニング後に表示される APIキーをコピーします。このキーは cog_ で始まります
  4. このキーを Bearer トークンとして使用します
結果はサービスユーザーが所属する Devin アカウント全体を対象とし、metadata.team_id は アカウントの Devin チーム識別子 (devin-team$<account_id>) です。
group_id フィルターは Windsurf Teams の概念であり、Devin の認証情報ではサポートされていません — 両方を組み合わせたリクエストは 400 Bad Request を返します。

​
Windsurf サービスキー

  1. チーム設定ページを開きます
  2. 「Service Keys」セクションを開きます
  3. Analytics Read 権限を持つ新しいサービスキーを作成します
  4. キーを Authorization ヘッダーの Bearer トークンとして利用します
グループにスコープされたサービスキーにも対応しています。キーがグループにスコープされている場合、結果は自動的に そのグループに限定されます。
これらの認証情報は厳重に管理し、クライアントサイドのコードや公開リポジトリには絶対に公開しないでください。

​
利用可能なエンドポイント

​
課金方式

消費量のレスポンスは、metadata.billing_strategy で示されるチームの課金方式に応じて変わります (出力およびアクティブユーザーのレスポンスには影響しません):
  • CREDITS — 各行に prompt_credits と flex_credits が含まれます
  • ACU — 各行に billed_acus が含まれます
message_count (請求イベント) および user_message_count (ユーザーが送信したメッセージ数。2026-04-11 より前の使用量については null) フィールドは、方式にかかわらず常に返されます。

​
ページネーション

一覧のレスポンスはページ分割されています。さらにデータがある場合、レスポンスには pagination.next_page_cursor が含まれます。次のページを取得するには、これを page_cursor クエリパラメータとして渡します。カーソルの有効期限は24時間です。

​
レート制限

これらのエンドポイントは、リアルタイムで使用量を監視する用途ではありません。データは1時間単位で集計され、 レート制限も低く設定されています (チームごとに1時間あたり10リクエスト) 。ライブ ダッシュボードやリクエスト単位の追跡ではなく、定期的なレポート作成や一括 エクスポートに利用してください。
v2 エンドポイントには、チームごとに1時間あたり10リクエストのレート制限があります。制限を超えると、 429 Too Many Requests が Retry-After ヘッダーとともに返されます。 前回のクエリをページネーションする場合 (next_page_cursor をたどる場合) は、レート 制限にはカウントされません。カウント対象となるのは、各レポートの最初のクエリだけです。この低い制限は、これらのエンドポイントが リアルタイム監視ではなく、定期的なレポート作成向けであることを反映しています。