> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API リリースノート

> Devin の API における変更、新機能、改善内容を追跡します

このページでは、Devin の API (v1、v2、v3) に関する変更履歴を掲載します。アプリケーション機能のリリースについては、[アプリケーションリリースノート](/ja/release-notes/overview) を参照してください。

<div id="2026">
  ## 2026
</div>

<Update label="2026年6月">
  **v3 API のアップデート**

  * **IP アクセスリストに IP を追加するエンドポイント**: 既存のエントリを置き換えることなく、Enterprise の IP アクセスリストに IP 範囲を追加するための `POST /v3/enterprise/ip-access-list` を追加しました。リスト全体を置き換える `PUT /v3/enterprise/ip-access-list` とは異なり、このエンドポイントは指定された範囲を現在のリストにマージします。`ManageEnterpriseSettings` 権限が必要です。

  * **git 権限更新エンドポイント**: 既存の git 権限 (`read_only` の切り替えなど) を更新するための `PATCH /v3/enterprise/organizations/{org_id}/git-providers/permissions/{git_permission_id}` を追加しました。`ManageGitIntegrations` 権限が必要です。

  * **組織スコープのメンバー読み取りエンドポイント (Beta)**: 組織スコープのサービスユーザーを使用して組織メンバーの一覧取得および取得を行うための `GET /v3beta1/organizations/{org_id}/members/users`、`GET /v3beta1/organizations/{org_id}/members/users/{user_id}`、`GET /v3beta1/organizations/{org_id}/members/idp-users` を追加しました。カーソル方式のページネーション (`after`、`first`) と `email` フィルタリングをサポートします。組織レベルの `ViewOrgMembership` 権限が必要です。

  * **セッション作成用の Devin Lite mode**: `POST /v3/organizations/{org_id}/sessions` の `devin_mode` パラメータで、`"normal"` と `"fast"` に加えて `"lite"` (Devin Lite) も受け付けるようになりました。Fast と Lite には、Web アプリと同じ機能フラグおよび Enterprise agent preview の制限が適用されます。
</Update>

<Update label="2026年5月">
  **v3 API のアップデート**

  * **セッション作成用の Devin mode パラメータ (5月21日)**: `POST /v3/organizations/{org_id}/sessions` に `devin_mode` パラメータを追加しました。`"normal"` (デフォルトの agent mode) または `"fast"` (Fast mode) を受け付けます。省略した場合、セッションでは組織のデフォルトモードが使用されます。Fast mode には、Web アプリと同じ機能フラグおよび Enterprise agent preview の制限が適用されます。

  * **Git 接続リポジトリのエンドポイント (5月18日)**: 特定の Enterprise Git 接続で利用可能なリポジトリを一覧表示するための `GET /v3/enterprise/git-providers/connections/{connection_id}/repositories` を追加しました。`filter_name` によるフィルタリングとカーソル方式のページネーション (`after`、`first`) をサポートします。`ManageGitIntegrations` 権限が必要です。
</Update>

<Update label="2026年3月">
  **v3 API のアップデート**

  * **Session insights 生成エンドポイント (3月11日)**: オンデマンドでセッションの insights 生成をトリガーするための `POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate` および `POST /v3/enterprise/sessions/{devin_id}/insights/generate` エンドポイントを追加しました。生成が開始されると `{ "status": "started" }` を返し、insights がすでに生成済みまたは生成中の場合は `{ "status": "already_exists" }` を返します。結果を取得するには、既存の GET insights エンドポイントをポーリングしてください。`ManageOrgSessions` 権限が必要です。
</Update>

<Update label="2026年2月">
  **v3 API のアップデート**

  * **v3 エンドポイントを本番環境に昇格**: 以下のエンドポイントグループが `v3beta1` から `v3` (本番環境) に昇格しました。これらのエンドポイントについて、ベース URL を `/v3beta1/` から `/v3/` に更新してください。

    * Sessions (作成、一覧取得、取得、messages、archive、terminate、tags、insights) — Enterprise スコープおよび組織スコープ
    * Knowledge notes — Enterprise スコープおよび組織スコープ
    * Playbooks — Enterprise スコープおよび組織スコープ
    * Secrets — 組織スコープ
    * Schedules — 組織スコープ
    * Attachments — 組織スコープ
    * Audit logs — Enterprise スコープおよび組織スコープ
    * Consumption & billing (cycles、日別内訳、ACU の上限) — Enterprise スコープ
    * Metrics (DAU、WAU、MAU、PRs、sessions、searches、active users、usage) — Enterprise スコープ
    * Organizations、users、メンバー、roles、IDP groups — Enterprise スコープ
    * Git connections & permissions — Enterprise スコープ
    * Hypervisors、queue、IP access lists、org group limits — Enterprise スコープ
    * Session tags (組織デフォルトの tags) — Enterprise スコープ

    **引き続きベータ版** (`v3beta1`) : Repository indexing エンドポイント、サービスユーザー provisioning エンドポイント、および guardrail violations エンドポイントは引き続き `v3beta1` のままで、ドキュメントでは Beta タグが付与されています。

  * **Guardrail violations エンドポイント**: Enterprise 全体の guardrail 違反をクエリするための `GET /v3beta1/enterprise/guardrail-violations` および `GET /v3beta1/enterprise/organizations/{org_id}/guardrail-violations` エンドポイントを追加しました。guardrail の種類、理由付け、信頼度スコア、実行されたアクション、トリガーとなったメッセージなどの違反の詳細を返します。`session_id` および `guardrail_id` によるフィルタリングに加え、期間指定およびカーソル方式のページネーションをサポートします。組織でフィルタリングする場合は、組織別エンドポイントを使用してください。`ManageEnterpriseSettings` 権限が必要です。

  * **IP アクセスリスト用エンドポイント (2月9日)**: Enterprise 向け IP 許可リストを管理するための `GET /v3beta1/enterprise/ip-access-list`、`PUT /v3beta1/enterprise/ip-access-list`、`DELETE /v3beta1/enterprise/ip-access-list` エンドポイントを追加しました。`PUT` エンドポイントは、指定された IP 範囲 (CIDR 表記をサポート) でリスト全体を置き換えます。`ManageEnterpriseSettings` 権限が必要です。

  * **セッションスケジュール用エンドポイント (2月3日)**: 組織レベルのスケジュール管理エンドポイントを追加しました。スケジュールを作成する `POST /v3beta1/organizations/{org_id}/schedules`、スケジュールを一覧表示する `GET /v3beta1/organizations/{org_id}/schedules`、特定のスケジュールを取得する `GET /v3beta1/organizations/{org_id}/schedules/{schedule_id}`、スケジュールを更新する `PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id}`、スケジュールを削除する `DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id}` です。`ManageOrgSchedules` 権限が必要です。
</Update>

<Update label="2026年1月">
  **v3 APIの更新**

  * **ACU 制限エンドポイント (1月27日)**: Devin セッションに対する Enterprise 向け ACU 制限管理エンドポイントを追加しました。Devin セッション用エンドポイント: 制限を取得する `GET /v3beta1/enterprise/consumption/acu-limits/devin`、組織レベルの制限を設定する `PUT .../organizations/{org_id}`、および制限を削除する `DELETE` です。`ManageBilling` 権限が必要です。

  * **Attachments エンドポイント (1月27日)**: 組織向けの添付ファイルエンドポイントを追加しました。添付ファイルをアップロードするための `POST /v3beta1/organizations/{org_id}/attachments` と、ダウンロードするための `GET /v3beta1/organizations/{org_id}/attachments/{uuid}/{name}` です。アップロードには `UseDevinSessions` 権限が、ダウンロードには `ViewOrgSessions` 権限が必要です。

  * **キューエンドポイント (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` を使用してください。
</Update>

<div id="2025">
  ## 2025
</div>

<Update label="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 および組織レベルの検索エンドポイントを追加しました。
  * **監査ログ の改善 (12月10日)**: 監査ログ レスポンスに `data` オブジェクト、`service_user_name`、`user_email` フィールドを追加しました。`update_git_permission` アクションタイプを追加しました。
  * **高度なセッションワークフローのサポート (12月8日)**: 高度なセッションワークフロー向けに、新しいリクエストパラメータ `child_playbook_id`、`session_links`、`bypass_approval` を追加しました。セッションレスポンスには新たに `child_session_ids`、`parent_session_id`、`is_advanced` フィールドが含まれるようになりました。
  * **セッションタグ ルーター (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` を含む 監査ログ、snapshots、playbook エンドポイント向けの正式なレスポンススキーマを追加しました。

  **v1 API のアップデート**

  * **監査ログ の非推奨化 (12月5日)**: `/v1/audit-logs` エンドポイントは非推奨となりました。代わりに v2 または v3 の 監査ログ エンドポイントを使用してください。
</Update>

<Update label="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日)**: 実行中のセッションをプログラムから終了するためのエンドポイントを追加しました。
</Update>

<Update label="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 をプログラムから管理するための機能を強化しました。
</Update>

<Update label="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` エンドポイントを追加しました。
</Update>

<Update label="2025年3月">
  **v2 Enterprise API のリリース**

  * **API v2 のリリース (3月23日)**: Enterprise 管理者向けに、組織管理、利用状況のトラッキング、メンバー管理機能を備えた Enterprise API v2 をリリースしました。
</Update>

<div id="2024">
  ## 2024年
</div>

<Update label="2024年10月">
  **v1 API ローンチ (10月26日)**

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

***

<div id="api-versioning-policy">
  ## API のバージョン管理ポリシー
</div>

<div id="backward-compatibility">
  ### 後方互換性
</div>

メジャーバージョン内では後方互換性を維持するよう努めています。後方互換性を損なう変更は次のように扱われます。

1. 少なくとも 7 日前までに告知されます
2. 本リリースノート内で明記されます
3. 該当する場合は移行ガイドが提供されます

<div id="deprecation-process">
  ### 非推奨化プロセス
</div>

API 機能を非推奨とする場合は、次の手順で進めます。

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

<div id="version-support">
  ### バージョン対応状況
</div>

* **v1**: レガシー — Organization API (v3) への移行に伴い、近日中に廃止予定
* **v2**: レガシー — Enterprise API (v3) への移行に伴い、近日中に廃止予定
* **v3**: 一般提供中で、すべての新規インテグレーションに推奨

***

<div id="migrating-to-the-current-api">
  ## 現行 API への移行
</div>

v1 または v2 からの移行手順については、[移行ガイド](/ja/api-reference/getting-started/migration-guide) を参照してください。

<div id="support">
  ## サポート
</div>

API の変更や移行に関するご質問がある場合は、[support@cognition.ai](mailto:support@cognition.ai) までメールでお問い合わせください。