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

​
2026

​
2026年1月
v3 APIの更新
  • キューエンドポイント (1月21日): Enterprise 管理者がセッションキューの健全性を監視できる GET /v3beta1/enterprise/queue エンドポイントを追加しました。キューに入っているセッションの総数と、ステータスインジケーター（normal、elevated、high のいずれか）を返します。容量に関するアラートを設定する際に役立ちます。ViewAccountMetrics 権限が必要です。
  • Sessions エンドポイント (1月19日): 特定のセッションの詳細を取得するために、GET /v3beta1/enterprise/sessions/{devin_id} および GET /v3beta1/organizations/{org_id}/sessions/{devin_id} エンドポイントを追加しました。アクティブなセッションにメッセージを送信するために、POST /v3beta1/enterprise/sessions/{devin_id}/messages および POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/messages エンドポイントを追加しました（セッションが一時停止されている場合でも自動的に再開されます）。また、セッション一覧エンドポイントに、セッションのオリジンでフィルタリングするための origins フィルタパラメータを追加しました（webapp、slack、teams、api、linear、jira、other）。
  • 監査ログの並び順パラメータ (1月17日): Enterprise および組織の監査ログエンドポイントに、結果の並び順を制御するための order クエリパラメータ（asc または desc、デフォルトは desc）を追加しました。
  • Secrets router (1月16日): 組織レベルのシークレット管理用エンドポイントを追加しました。シークレットを一覧表示する GET /v3beta1/organizations/{org_id}/secrets、シークレットを作成する POST /v3beta1/organizations/{org_id}/secrets、およびシークレットを削除する DELETE /v3beta1/organizations/{org_id}/secrets/{secret_id} です。ManageOrgSecrets 権限が必要です。
  • 監査ログの修正 (1月15日): ページに項目が存在する場合でも、監査ログ API のレスポンスで end_cursor が返されない不具合を修正しました。
  • サービスユーザーのプロビジョニング (1月14日): 新しいサービスユーザーをプログラムからプロビジョニングできるようにするため、POST /v3beta1/enterprise/service-users および POST /v3beta1/organizations/{org_id}/service-users エンドポイントを追加しました。権限昇格を防止する制約を適用しており、対象ロールの権限は呼び出し元の権限のサブセットでなければならず、ManageServiceUsers 権限は付与できません。それぞれ ManageAccountServiceUsers または ManageOrgServiceUsers 権限が必要です。
  • IDP グループの Enterprise レベルのエンドポイント (1月14日): Enterprise に登録されている IDP グループを一覧取得するための GET /v3beta1/enterprise/idp-groups、IDP グループを一括登録するための POST /v3beta1/enterprise/idp-groups（一度に最大 100 件まで）、および登録済みの IDP グループを削除するための DELETE /v3beta1/enterprise/idp-groups/{idp_group_name} を追加しました。既存のロール割り当てまたはユーザーメンバーシップがあるグループは削除できません。ManageAccountMembership 権限が必要です。
  • 監査ログアクション (1月12日): 監査ログのレスポンスに create_join_request、automatic_join_event、reject_join_request のアクション種別を追加しました。
  • アクティブユーザーエンドポイント (1月8日): カスタム日付範囲における一意のアクティブユーザー数を取得するための GET /v3beta1/enterprise/metrics/active-users エンドポイントを追加しました。期間ごとに分解されたリストを返す DAU/WAU/MAU エンドポイントとは異なり、このエンドポイントは指定した範囲全体を通した一意のアクティブユーザー数を単一の数値として返します。組織 ID によるフィルタリングと、min_sessions、min_searches などのアクティビティのしきい値の設定に対応しています。
  • ハイパーバイザーのデフォルトステータス (1月8日): GET /v3beta1/enterprise/hypervisors エンドポイントは、すべてのハイパーバイザーを返すのではなく、デフォルトで available ステータスのもののみを返すようになりました。ステータスに関係なくすべてのハイパーバイザーを取得するには、クエリパラメータで status=all を指定してください。
  • セッションシークレット (1月5日): セッション作成エンドポイント（POST /v3beta1/organizations/{org_id}/sessions）に session_secrets パラメータを追加しました。セッションシークレットは現在のセッション内でのみ利用可能な一時的なシークレットであり、組織シークレットには保存されません。
  • ページネーション修正（1月5日）: v3 Enterprise Users API において、end_cursor が正しく返されない場合があったページネーションのバグを修正しました。
v2 APIの更新
  • リポジトリのクローン修正 (1月20日): POST /v2/enterprise/organizations/{org_id}/clone-repository エンドポイントのスキーマを修正しました。従来の RepoSetupStepsT 形式を廃止し、リクエストボディをフラットなフィールド（pull_repo_commands、run_lint_commands、run_project_commands、update_dependencies_commands、repo_note、repo_path）を用いるシンプルな構造にしました。
  • Git permissions の URL フィールド (1月15日): GitPermissionRequest スキーマに group_prefix_url と repo_url フィールドを追加し、パスベースのリポジトリおよびグループ接頭辞マッチングに対する、URL による完全指定の代替手段を提供します。
  • 組織メンバーのロールフィールド (1月8日): 各メンバーの組織内でのロールを表示するため、GET /v2/enterprise/organizations/{org_id}/members のレスポンスに org_role_name フィールドを追加しました。
  • 組織作成オプション (1月8日): Enterprise 管理者が自分自身をメンバーとして自動追加されることなく組織を作成できるようにするため、POST /v2/enterprise/organizations に add_creator_as_member ブール値パラメータ（デフォルトは true）を追加しました。
  • 消費タイムゾーンのドキュメント（1月7日）: 日次消費量エンドポイントにタイムゾーンの挙動に関するドキュメントを追加しました。課金サイクルにおいては、1日の境界として太平洋標準時の深夜（08:00:00 UTC）を使用します。
v1 API更新
  • シークレットタイプの更新 (1月16日): secrets API スキーマで認識されるシークレットタイプの値として dictionary を追加しました。注意：タイプ dictionary のシークレットの作成は非推奨です。代わりに cookie、key-value、または totp を使用してください。

​
2025

​
2025年12月
v3 API のアップデート
  • Org group limits エンドポイント (12月23日): 組織グループ構成を管理するための GET /v3beta1/enterprise/org-group-limits および PUT /v3beta1/enterprise/org-group-limits エンドポイントを追加しました。グループでは、組織 ID の集合ごとに、課金サイクル単位の任意の最大 Agent Compute Unit 上限を設定できます。ManageOrganizations 権限が必要です。この機能を利用するには、アカウント担当チームによる有効化が必要です。
  • セッションアーカイブエンドポイント (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 パラメータを用いたカーソルベースのページネーションを使用してください。
  • 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 アクションタイプを追加しました。
  • 高度なセッションモードのサポート (12月8日): 高度なセッションモード（analyze、create、improve、batch、manage）をサポートし、新しいリクエストパラメータ advanced_mode、child_playbook_id、session_links、bypass_approval を追加しました。セッションレスポンスには新たに child_session_ids、parent_session_id、is_advanced フィールドが含まれるようになりました。
  • 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 のアップデート
  • Org group limits エンドポイント (12月23日): 組織グループ構成を管理するための GET /v2/enterprise/org-group-limits および PUT /v2/enterprise/org-group-limits エンドポイントを追加しました。グループでは、組織 ID の集合ごとに、課金サイクル単位の任意の最大 Agent Compute Unit 上限を設定できます。PUT エンドポイントは構成全体を置き換えます（リクエストに含まれないグループは削除されます）。この機能を利用するには、アカウント担当チームによる有効化が必要です。
  • Self エンドポイント (12月23日): 認証に使用されている APIキーに関する情報（キー ID、対応するユーザー ID、ユーザーのメールアドレス、組織 ID を含む）を返す GET /v2/enterprise/self エンドポイントを追加しました。
  • セッションの 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 ロール用ルーターを追加しました。
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の変更や移行支援に関するご質問がある場合は、以下をご利用ください：