メインコンテンツへスキップ
このページでは、Devin APIを利用した一般的なエンドツーエンドのワークフローを紹介します。各フローには、コード使用例とあわせて、APIコールの一連の流れがすべて含まれています。各エンドポイントの詳細については、該当するAPIリファレンスページを参照してください。

セットアップ

いずれの使用例を実行する前にも、これらの環境変数を設定してください。

はじめに: APIキーから最初のセッションまで

最も一般的なワークフローです。認証を行い、アカウント情報を確認して、最初のセッションを作成します。

ステップ 1: 認証情報を確認する

組織スコープのサービスユーザーはステップ 3 に進んでください。org ID は Settings ページですでに確認済みです。
レスポンス:

ステップ 2: 自分の組織を一覧表示する

Enterprise のサービスユーザーは、すべての組織を一覧表示できます。
組織スコープのサービスユーザーは、すでに自身の org ID を把握しています (サービスユーザーがプロビジョニングされた Settings > Devin API ページの上部に表示されています) 。

ステップ 3: セッションを作成する

レスポンス:

ステップ 4: イベントをポーリングする

メッセージをポーリングして、セッションを監視します:

Pythonの完全な例


セッションの添付ファイルをダウンロード

セッションで生成されたファイル (ログ、スクリーンショット、生成コードなど) を取得します。

ステップ 1: セッションを取得する

ステップ 2: 添付ファイルを一覧表示する

レスポンス:

ステップ 3: ダウンロード

url の値には APIキーを利用しないでください。この URL にアクセスするには、ウェブアプリへのサインインが必要です。 代わりに、attachment_id と name の値を指定してダウンロード用エンドポイントを利用してください。このエンドポイントは短期間有効な URL への 307 リダイレクトを返すため、リダイレクトを追跡するよう設定してください。

Pythonの完全な例


Knowledge と playbook の管理

Devin がセッションをまたいで利用する前提情報と指示を管理します。

Knowledgeノートを作成する

Knowledgeノートを一覧表示する

Knowledgeノートを更新する

Knowledgeノートを削除する

プレイブック を作成する

/playbooks エンドポイントは非推奨です。プレイブックは スキル に移行中です。移行済みのアカウントでは、このリクエストはプレイブックに対応するスキルに書き込まれます。2026年10月24日以降に作成され、プレイブックが存在しないアカウントでは、これらのエンドポイントは 410 を返します。詳しくは プレイブックはスキルに移行しています を参照してください。

Pythonの完全な例


セッションの自動実行をスケジュールする

schedule:recurring トリガーを持つ自動化を作成すると、セッションを定期的に実行できます。このトリガーは rrule 条件を 1 つ受け取ります。これは UTC で評価される iCalendar の RRULE です (例: 夏時間中の東部時間午前 9 時に平日実行する場合は FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=13;BYMINUTE=0) 。ManageOrgAutomations 権限が必要です。
従来の /schedules エンドポイントは非推奨です。2026 年 9 月 24 日以降、自動化へ移行済みの組織では POST /v3/organizations/{org_id}/schedules は 403 を返します。詳細は API リリースノートを参照してください。

スケジュール実行の自動化を作成する

1回限りの実行の場合は、DTSTART と COUNT=1 を組み合わせて利用します。例えば DTSTART:20260915T170000Z\nRRULE:FREQ=DAILY;COUNT=1 のように指定します。この自動化は1回だけ発生し、その後は自動的に無効化されます。

一覧取得、更新、削除

Pythonの完全な例


どこからでもタスクを引き継げる

Sessions API は単一のリクエストで cloud Devin セッションを作成できるため、どのツール、スクリプト、コーディングエージェントからでも作業を Devin に「引き継ぐ」ことができます。現在の repo、ブランチ、未コミットの変更をプロンプトにまとめて含めることで、cloud Devin セッションは中断したところから作業を再開できます。

リポジトリの前提情報付きでセッションを作成する

クラウドセッションはリポジトリをクローンし、プロンプトの前提情報を適用したうえで、シェル、ブラウザ、リポジトリへのフルアクセスを備えた専用のVM上で実行されます。メッセージをポーリングするか、Devin ウェブアプリ で追跡できます。
git diff HEAD には、未コミットのシークレット (APIキー、トークン、.env の編集など) が含まれる場合があり、プロンプトはクラウドセッションにアップロードされます。引き継ぐ前に diff を確認し、機密性の高い変更はコミット、stash、または削除してください。
これを自分で実装したくないですか?シェルで Devin の APIキーを DEVIN_API_KEY としてエクスポートしてから、このフローに沿って Devin セッションを作成するようコーディングエージェントに依頼しましょう。詳しくは Devin に引き継ぐ を参照してください。

エラー処理

本番環境では、上記のすべての使用例にエラー処理を含める必要があります。以下に、再利用可能なパターンを示します。

サポート

お困りですか?

API に関するご質問や問題の報告は、support@cognition.ai までメールでお問い合わせください