メインコンテンツへスキップ
このガイドでは、Teams および標準組織 (非 Enterprise) 向けに API アクセスを設定する方法を説明します。サービスユーザーを作成し、認証情報を取得して、数分で最初の API コールを実行できるようになります。
複数の組織、カスタムロール、または SSO (シングルサインオン) を利用している Enterprise 組織に所属している場合は、代わりに Enterprise クイックスタート を参照してください。

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

  1. 組織の Settings > Service users に移動します
  2. Create service user をクリックします
  3. わかりやすい名前を選びます (例: “CI Pipeline”, “Monitoring Bot”)
  4. ロールを選択します:
    • Admin — セッション、Knowledge、プレイブック、シークレット、設定を管理するためのフルアクセス権
    • Member — Devin セッションの作成と管理、およびリソースの閲覧が可能
ほとんどの自動化には Member ロールを使用してください。連携が組織の設定や他のユーザーを管理する必要がある場合にのみ Admin を使用してください。

​
ステップ 2: APIキーを生成する

  1. サービスユーザーを作成したら、Generate API key をクリックします
  2. すぐにキーをコピーします — cog_ で始まり、この画面以降は表示されません
  3. 環境変数として安全に保存してください:
export DEVIN_API_KEY="cog_your_key_here"

​
ステップ 3: 最初のAPIコールを行う

Devin セッションを作成します: 
export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
組織 ID は Settings → Service Users ページで確認できます。
セッションを自分のユーザーに紐付けたいですか？ デフォルトでは、セッションはサービスユーザーに紐付けられます。特定のユーザーの代理としてセッションを作成し (そのユーザーのセッション一覧に表示されるようにする) には、リクエストボディに "create_as_user_id": "user_abc123" を追加します。これには Admin ロール (ImpersonateOrgSessions 権限を含む) が必要です。詳細は Session attribution を参照してください。

​
ステップ 4: よく使う操作

​
セッションを一覧表示

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

​
実行中のセッションにメッセージを送信する

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

​
Knowledge の管理

# Knowledge エントリの一覧取得
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Knowledge エントリの作成
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger_description": "When writing code", "body": "Use TypeScript strict mode..."}'

​
Teams ユーザーの権限

Teams 組織にはシンプルな権限モデルがあります。
ロールセッションを作成できるリソースを管理できる設定を管理できる
Memberはいはい (Knowledge、プレイブック、シークレット)いいえ
Adminはいはいはい
よりきめ細かなロールベースのアクセス制御 (RBAC) については、Enterprise クイックスタートを参照してください。

​
次のステップ

  • サイドバーで Organization API のエンドポイントを確認する
  • 一般的な連携パターンについては usage examples を参照する
  • authentication について詳しく学ぶ
  • 定期的なタスク向けに scheduled sessions を設定する