メインコンテンツへスキップ
このガイドでは、既存の統合を API v1 または v2 から現行の 組織 および Enterprise API へ移行する方法を説明します。レガシーAPI (v1 と v2) は非推奨期間中も引き続き利用できますが、新機能はすべて現在のAPI でのみ提供されます。

変更点

ステップ 1: サービスユーザーを作成する

既存のレガシーAPIキーをサービスユーザーに置き換えます。
  1. Settings > Devin API を開き、サービスユーザー タブを開きます
  2. Provision service user をクリックし、適切なロールを割り当てて、有効期限を選択します (デフォルトは 30 日)
  3. プロビジョニング後に表示されるAPIキー (cog_ で始まる) をコピーします
  4. 既存の統合の設定を更新し、新しいキーを使用するようにします
既存のレガシー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 では、オフセット方式ではなくカーソル方式のページネーションを使用しています。
詳しくは Pagination を参照してください。

ステップ 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 の設定画面を確認してください。
ロールベースのアクセス制御、セッションの帰属管理、新機能を利用するため、できるだけ早くサービスユーザーへ移行することを推奨します。

お困りですか?

移行中に問題が発生した場合は、通常お使いの Devin のサポートチャネルからご連絡いただくか、support@cognition.ai までお問い合わせください。