メインコンテンツへスキップ
このガイドでは、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 セッションを作成します： 
curl -X POST "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
URL に org ID を指定する必要はありません。 サービスユーザーは 1 つの組織にスコープされているため、API が自動的に識別します。必要に応じて、次のように含めることもできます: /v3/organizations/{org_id}/sessions。org ID は Settings → Organization details で確認できます。
セッションを特定のユーザーに紐づけたい場合 デフォルトでは、セッションはサービスユーザーに紐づけられます。特定のユーザーの代理としてセッションを作成し（そのユーザーのセッション一覧に表示されるようにする）には、リクエストボディに "create_as_user_id": "user_abc123" を追加します。これには Admin ロール（ImpersonateOrgSessions 権限を含む）が必要です。詳細は Session attribution を参照してください。

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

​
セッションを一覧表示

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

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

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/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/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Knowledge エントリの作成
curl -X POST "https://api.devin.ai/v3/organizations/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 を設定する