メインコンテンツへスキップ
このページでは、Devin の API（v1、v2、v3）に関する変更履歴を掲載します。アプリケーション機能のリリースについては、アプリケーションリリースノート を参照してください。
v3 API の更新
- Notes および Playbooks ルーター (12月1日): v3 API に、Enterprise および組織レベルでの Notes と Playbooks 管理用エンドポイントを追加しました。Notes のエンドポイントには
ManageAccountKnowledge 権限が必要で、Playbooks のエンドポイントには ManageAccountPlaybooks 権限が必要です。
v2 Enterprise API のアップデート
- ページネーション limit の更新 (11月21日): パフォーマンスと信頼性向上のため、1リクエストあたりのページネーションの limit 上限を 1000 から 200 に引き下げました。デフォルトの limit は引き続き 100 です。この変更は v1 External API には影響しません。
- Sessions router (11月16日): Enterprise 管理者向けの包括的なセッション管理エンドポイントを v2 API に追加しました。
- Snapshots API endpoint (11月3日): スナップショットの詳細をプログラムから取得するためのエンドポイントを追加しました。
v1 API のアップデート
- セッション終了エンドポイント (10月31日): 実行中のセッションをプログラムから終了するためのエンドポイントを追加しました。
v3 API リリース（ベータ）
- API v3 リリース（10月23日）: RBAC のフルサポート、サービスユーザー認証モデル、サービスユーザーの操作に対する包括的な監査ログ記録を備えた v3 API をリリースしました。
v2 Enterprise API のアップデート
- スナップショット作成エンドポイント（10月30日）: Enterprise 管理者が、リポジトリをプログラムからクローンし、カスタムのセットアップ手順や起動コマンドを指定してスナップショットを作成できるようにする、新しい V2 Enterprise Organizations API エンドポイントを追加しました。
- Playbooks API の改善（10月14日）: Enterprise プレイブックを公開するための API を追加し、プレイブックをプログラムで管理するための機能を強化しました。
v2 Enterprise API アップデート
- Roles ルーター (9月25日): ロールをプログラム経由で管理するための 5 つの API エンドポイントを備えた Enterprise ロール用ルーターを追加しました。
v1 API アップデート
- Playbooks API (9月6日): プレイブックをプログラム経由で作成・更新・一覧取得・削除できる包括的な Playbooks API エンドポイントを v1 に追加しました。
- Secrets エンドポイント (9月5日): API 経由でシークレットを作成するための新しい
POST /v1/secrets エンドポイントを追加しました。
v2 Enterprise API リリース
- API v2 リリース (3月23日): 組織管理、利用状況の追跡、メンバー管理機能を備えた Enterprise 管理者向けの Enterprise API v2 をリリースしました。
v1 API ローンチ (10月26日)
- セッションのプログラム的な作成・管理のための REST API をリリース
- セッションの作成・監視・管理用エンドポイント
- ファイル添付のアップロード／ダウンロードに対応
- APIキーを用いたベーシック認証
- セッション作成の冪等性をサポート
- ユースケース：自動 PR レビュー、Lint エラーの解消、マイグレーション
メジャーバージョン内では後方互換性を維持するよう努めています。後方互換性を損なう変更は次のように扱われます。
- 少なくとも 7 日前までに告知されます
- 本リリースノート内で明記されます
- 該当する場合は移行ガイドが提供されます
API 機能を非推奨とする場合は、次の手順で進めます。
- 告知: 非推奨化とその予定をお知らせします
- 非推奨期間: 機能は引き続き利用できますが、非推奨としてマークされます
- 削除: 非推奨期間の終了後、その機能を削除します
- v1: 一般提供中、積極的に保守されています
- v2: 一般提供中、積極的に保守されています
- v3: ベータ版 - 変更される可能性があり、まだ本番環境での利用は推奨されません
きめ細かな権限管理が必要な新しいインテグレーションを構築する場合は、v1 ではなく v3 の利用を検討してください。
主な違い:
- 認証: v3 では、個人／サービスの APIキー ではなく、サービスユーザーのトークンが必要です
- 認可: v3 では、ロールベースの権限を備えた完全な RBAC を提供します
- エンドポイント: v3 では異なる URL パターン（
/v3beta1/* ではなく /v1/*）を使用します
移行手順:
- Enterprise Settings > Service Users でサービスユーザーを作成します
- サービスユーザーに適切なロールを割り当てます
- サービスユーザー用の APIキー を生成します
- インテグレーションを更新し、v3 のエンドポイントを使用するようにします
- 本番以外の環境で十分にテストします
v3 API ドキュメントを表示 →
v3 は Enterprise 向け自動化において、v2 よりも高い柔軟性を提供します。
主な違い:
- 認証: v3 では Enterprise 管理者の個人キーは不要で、サービスユーザーを使用します
- 認可: v3 では Enterprise 管理者専用アクセスではなく、きめ細かな RBAC をサポートします
- スコープ: v3 では特定の組織にスコープを絞ることができますが、v2 は常に Enterprise 全体が対象です
移行を検討すべきタイミング:
- 管理者権限以外の権限で自動化が必要な場合
- API アクセスの対象を特定の組織に限定したい場合
- 人のアカウントとサービスアカウントを明確に分離する必要がある場合
- 自動化されたアクションについて、詳細な監査証跡が必要な場合
APIの変更や移行支援に関するご質問がある場合は、以下をご利用ください：
