メインコンテンツへスキップ
このページでは、Devin の API（v1、v2、v3）に関する変更履歴を掲載します。アプリケーション機能のリリースについては、アプリケーションリリースノート を参照してください。

​
2025

​
2025年12月
v3 API のアップデート
  • セッションアーカイブエンドポイント (12月11日): セッションをアーカイブするための POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive エンドポイントを追加しました。あわせて、DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id}（セッションの終了）に archive クエリパラメータを追加し、セッションレスポンスに is_archived フィールドを追加しました。
  • order パラメータの削除 (12月11日): 互換性のない変更: セッション一覧エンドポイント（GET /v3beta1/organizations/{org_id}/sessions）から order クエリパラメータを削除しました。クライアントは order を送信しないようにする必要があります。代わりに first/after パラメータを用いたカーソルベースのページネーションを使用してください。
  • 高度なセッションモードのサポート (12月8日): 高度なセッションモード（analyze、create、improve、batch、manage）をサポートし、新しいリクエストパラメータ advanced_mode、child_playbook_id、session_links、bypass_approval を追加しました。セッションレスポンスには新たに child_session_ids、parent_session_id、is_advanced フィールドが含まれるようになりました。
  • Searches ルーター (12月10日): 検索をページネーションおよびフィルタリング付きで一覧表示するために、GET /v3beta1/enterprise/searches および GET /v3beta1/organizations/{org_id}/searches に Enterprise および組織レベルの検索エンドポイントを追加しました。
  • Audit logs の改善 (12月10日): audit logs レスポンスに data オブジェクト、service_user_name、user_email フィールドを追加しました。update_git_permission アクションタイプを追加しました。
  • Session Tags ルーター (12月5日): 組織ごとの許可されたセッションタグを管理するために、/v3/beta/enterprise/organizations/{org_id}/tags に CRUD エンドポイントを追加しました。タグ検証が有効な場合、セッションの作成およびタグ更新時に、許可リストに含まれるタグのみを使用できます。
  • Enterprise Sessions エンドポイント (12月5日): Enterprise 全体のセッションを一覧表示する GET /v3/beta/enterprise/sessions を追加しました。任意で org_ids によるフィルタリングが可能です。
  • Git Permissions の更新 (12月5日): リポジトリをパスのプレフィックスでマッチさせるための prefix_path フィールドを追加しました。組織のすべての権限を一括で置き換えたり、すべてクリアしたりするための PUT および DELETE エンドポイントを追加しました。
  • セッションの代理作成 (12月5日): セッション作成エンドポイントに create_as_user_id パラメータを追加し、サービスユーザーが他のユーザーに代わってセッションを作成できるようにしました。
  • Hypervisors レスポンスの変更 (12月5日): Hypervisors エンドポイントのレスポンスは、max_slots および available_slots の代わりに utilization_percentage を返すようになりました。
  • Notes および Playbooks ルーター (12月1日): v3 API に、Enterprise および組織レベルでの Notes と Playbooks の管理エンドポイントを追加しました。Notes エンドポイントには ManageAccountKnowledge 権限が必要で、Playbooks エンドポイントには ManageAccountPlaybooks 権限が必要です。
v2 API のアップデート
  • セッションの messages フィールド (12月11日): v2 sessions API のレスポンスに messages フィールドを追加し、v1 API と同様にすべてのセッションメッセージを提供するようにしました。
  • レスポンススキーマの改善 (12月11日): AuditLogsResponse、EnterpriseSnapshotResponse、EnterprisePlaybookResponse を含む audit logs、snapshots、playbook エンドポイント向けの正式なレスポンススキーマを追加しました。
v1 API のアップデート
  • Audit logs の非推奨化 (12月5日): /v1/audit-logs エンドポイントは非推奨となりました。代わりに v2 または v3 の audit logs エンドポイントを使用してください。
​
2025年11月
v2 Enterprise API のアップデート
  • ページネーション limit の更新 (11月21日): パフォーマンスと信頼性向上のため、ページネーションの最大 limit を 1,000 から 1 リクエストあたり 200 件に減らしました。デフォルトの limit は引き続き 100 のままです。この変更は v1 External API には影響しません。
  • Sessions ルーター (11月16日): Enterprise 管理者向けに、v2 API に包括的なセッション管理エンドポイントを追加しました。
  • Snapshots API エンドポイント (11月3日): スナップショットの詳細をプログラムから取得するためのエンドポイントを追加しました。
v1 API のアップデート
  • セッション終了エンドポイント (10月31日): 実行中のセッションをプログラムから終了するためのエンドポイントを追加しました。
​
2025年10月
v3 API のリリース (ベータ版)
  • API v3 のリリース (10月23日): v3 API をリリースしました。フル RBAC サポート、サービスユーザー認証モデル、およびサービスユーザーの操作に対する包括的な監査ログを提供します。
v2 Enterprise API のアップデート
  • スナップショット作成エンドポイント (10月30日): Enterprise 管理者が、リポジトリをプログラムからクローンし、カスタムセットアップ手順および起動コマンド付きでスナップショットを作成できる、新しい v2 Enterprise Organizations API エンドポイントを追加しました。
  • Playbooks API の改善 (10月14日): Enterprise Playbooks を公開するための API を追加し、Playbooks をプログラムから管理するための機能を強化しました。
​
2025年9月
v2 Enterprise API のアップデート
  • Roles ルーター (9月25日): ロールをプログラムから管理するための 5 つの API エンドポイントを備えた Enterprise Roles ルーターを追加しました。
v1 API のアップデート
  • Playbooks API (9月6日): Playbooks をプログラムから作成、更新、一覧表示、削除するための包括的な Playbooks API エンドポイントを v1 に追加しました。
  • Secrets エンドポイント (9月5日): API 経由でシークレットを作成するための新しい POST /v1/secrets エンドポイントを追加しました。
​
2025年3月
v2 Enterprise API のリリース
  • API v2 のリリース (3月23日): 組織管理、利用状況トラッキング、メンバー管理機能を備えた、Enterprise 管理者向けの Enterprise API v2 をリリースしました。

​
2024年

​
2024年10月
v1 API ローンチ (10月26日)
  • セッションのプログラム的な作成・管理のための REST API をリリース
  • セッションの作成・監視・管理用エンドポイント
  • ファイル添付のアップロード／ダウンロードに対応
  • APIキーを用いたベーシック認証
  • セッション作成の冪等性をサポート
  • ユースケース：自動 PR レビュー、Lint エラーの解消、マイグレーション

​
API のバージョン管理ポリシー

​
後方互換性

メジャーバージョン内では後方互換性を維持するよう努めています。後方互換性を損なう変更は次のように扱われます。
  1. 少なくとも 7 日前までに告知されます
  2. 本リリースノート内で明記されます
  3. 該当する場合は移行ガイドが提供されます

​
非推奨化プロセス

API 機能を非推奨とする場合は、次の手順で進めます。
  1. 告知: 非推奨化とその予定をお知らせします
  2. 非推奨期間: 機能は引き続き利用できますが、非推奨としてマークされます
  3. 削除: 非推奨期間の終了後、その機能を削除します

​
バージョンのサポート状況

  • v1: 一般提供中、積極的に保守されています
  • v2: 一般提供中、積極的に保守されています
  • v3: ベータ版 - 変更される可能性があり、まだ本番環境での利用は推奨されません

​
移行ガイド

​
v1 から v3 への移行

きめ細かな権限管理が必要な新しいインテグレーションを構築する場合は、v1 ではなく v3 の利用を検討してください。 主な違い:
  • 認証: v3 では、個人／サービスの APIキー ではなく、サービスユーザーのトークンが必要です
  • 認可: v3 では、ロールベースの権限を備えた完全な RBAC を提供します
  • エンドポイント: v3 では異なる URL パターン（/v3beta1/* ではなく /v1/*）を使用します
移行手順:
  1. Enterprise Settings > Service Users でサービスユーザーを作成します
  2. サービスユーザーに適切なロールを割り当てます
  3. サービスユーザー用の APIキー を生成します
  4. インテグレーションを更新し、v3 のエンドポイントを使用するようにします
  5. 本番以外の環境で十分にテストします
v3 API ドキュメントを表示 →

​
v2 から v3 への移行

v3 は Enterprise 向け自動化において、v2 よりも高い柔軟性を提供します。 主な違い:
  • 認証: v3 では Enterprise 管理者の個人キーは不要で、サービスユーザーを使用します
  • 認可: v3 では Enterprise 管理者専用アクセスではなく、きめ細かな RBAC をサポートします
  • スコープ: v3 では特定の組織にスコープを絞ることができますが、v2 は常に Enterprise 全体が対象です
移行を検討すべきタイミング:
  • 管理者権限以外の権限で自動化が必要な場合
  • API アクセスの対象を特定の組織に限定したい場合
  • 人のアカウントとサービスアカウントを明確に分離する必要がある場合
  • 自動化されたアクションについて、詳細な監査証跡が必要な場合

​
サポート

APIの変更や移行支援に関するご質問がある場合は、以下をご利用ください：