クイックスタート：Teams

このガイドでは、Teams および標準組織 (非 Enterprise) 向けに API アクセスを設定する方法を説明します。サービスユーザーを作成し、認証情報を取得して、数分で最初の API コールを実行できるようになります。

複数の組織、カスタムロール、または SSO (シングルサインオン) を利用している Enterprise 組織に所属している場合は、代わりに Enterprise クイックスタートを参照してください。

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

組織の Settings > Service users に移動します
Create service user をクリックします
わかりやすい名前を選びます (例: “CI Pipeline”, “Monitoring Bot”)
ロールを選択します:
- Admin — セッション、Knowledge、プレイブック、シークレット、設定を管理するためのフルアクセス権
- Member — Devin セッションの作成と管理、およびリソースの閲覧が可能

ほとんどの自動化には Member ロールを使用してください。連携が組織の設定や他のユーザーを管理する必要がある場合にのみ Admin を使用してください。

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

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

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 クイックスタートを参照してください。

次のステップ

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

はじめに

基本概念

Agentのライフサイクル

前提情報管理

環境管理

自動化

統合

アナリティクス

可観測性

セキュリティ向けDevin

インフラストラクチャ

アイデンティティとアクセス

構成

レガシーAPI v1

レガシーAPI v2

クイックスタート：Teams

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

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

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

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

セッションを一覧表示

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

Knowledge の管理

Teams ユーザーの権限

次のステップ

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

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

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

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

​セッションを一覧表示

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

​Knowledge の管理

​Teams ユーザーの権限

​次のステップ

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

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

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

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

セッションを一覧表示

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

Knowledge の管理

Teams ユーザーの権限

次のステップ