変更点
ステップ 1: サービスユーザーを作成する
既存のレガシーAPIキーをサービスユーザーに置き換えます。- Settings > Devin API を開き、サービスユーザー タブを開きます
- Provision service user をクリックし、適切なロールを割り当てて、有効期限を選択します (デフォルトは 30 日)
- プロビジョニング後に表示されるAPIキー (
cog_で始まる) をコピーします - 既存の統合の設定を更新し、新しいキーを使用するようにします
既存のレガシーAPIキーは、非推奨期間中も引き続き使用できます。移行は段階的に行えます。
ステップ2: エンドポイント URL を更新する
セッションエンドポイント
Knowledge エンドポイント
プレイブック エンドポイント
/playbooks エンドポイントは、すべての API バージョンで非推奨です。プレイブックはスキルへ移行中です。新しい指示は、Customize ページでスキルとして作成してください。2026年10月24日以降に作成され、プレイブックを持たないアカウントでは、これらのエンドポイントは 410 を返します。詳しくはプレイブックはスキルに移行しますを参照してください。シークレットエンドポイント
Enterprise 専用エンドポイント (新規)
これらのエンドポイントには v1/v2 に対応するものはなく、現行の API でのみ利用できます。GET /v3/enterprise/organizations— Organization 一覧GET /v3/enterprise/audit-logs— 監査ログGET /v3/enterprise/consumption/*— 利用状況および請求データGET /v3/enterprise/metrics/*— 利用状況メトリクスGET /v3/enterprise/members/users— ユーザー管理GET /v3/enterprise/roles— ロール管理- サービスユーザーのプロビジョニング、IP アクセスリスト、ACU 制限など
ステップ 3: ページネーションを更新する
現行 API では、オフセット方式ではなくカーソル方式のページネーションを使用しています。ステップ 4: レスポンス形式の変更に対処する
セッションステータス値
現在の API は、より詳細なステータス情報を返します。完全なスキーマについては、エンドポイントのリファレンスを参照してください。エラーレスポンス
現在のAPIは、RFC 9457 形式のエラーをapplication/problem+json コンテンツタイプで返します。ボディには type、title、status の各メンバーが含まれ、さらに detail、instance、errors、error_code の各メンバーが含まれる場合もあります。
レガシーAPIは、detail メンバーを含む JSON ボディを返します。現在のAPIの 422 レスポンスでは、detail は文字列で、フィールド単位のエラーは errors メンバーに格納されます。
廃止スケジュール
設定 > Devin API では、レガシーキーは API keys (legacy) タブに一覧表示されます。エンタープライズ設定 > Devin API では、レガシーキーは レガシーAPI タブに一覧表示され、このタブには廃止予定のバナーが表示されます。移行期間中は次のように動作します。- 現在: レガシーAPIキーは引き続き利用できます。新しい組織では、レガシーキーを新規作成できない場合があります。
- 非推奨期間: レガシーキーとサービスユーザー トークンの両方を併用できます。
- 提供終了: レガシーAPIキーはまもなく廃止されます。告知のため Devin の設定画面を確認してください。

