複数の組織またはカスタムロールを利用している Enterprise 組織に所属している場合は、代わりに Enterprise クイックスタート を参照してください。
ステップ 1: サービスユーザーを作成する
- 組織の Settings > Devin API に移動し、サービスユーザー タブを開きます
- サービスユーザーをプロビジョニング をクリックします
- わかりやすい表示名を選びます (例: “CI Pipeline”, “Monitoring Bot”)
- Organization role ドロップダウンでロールを選択します。フォームには個別の権限チェックボックスはありません。サービスユーザーの権限は、選択したロールによって決まります。
- Admin — 組織の設定とメンバーシップを含むフルアクセス権
- Member — Devin セッションおよびほとんどの組織リソースを作成・管理できますが、組織の設定やメンバーシップは管理できません
- 有効期限 を選択します。デフォルトは 30 days で、ほかに 7 days、90 days、およびアカウントで許可されている場合は Never を選択できます。有効期限を過ぎるとサービスユーザーのAPIキーは使用できなくなるため、それまでに代わりのサービスユーザーをプロビジョニングしてください。有効期限を短くしておくと、キーが漏洩した場合に悪用される期間を短く抑えられます。
ステップ 2: APIキーをコピーする
- サービスユーザーをプロビジョニングすると、そのAPIキーがダイアログに表示されます
- すぐにキーをコピーします —
cog_で始まり、この画面以降は表示されません - 環境変数として安全に保存してください:
ステップ 3: 最初のAPIコールを行う
Devin セッションを作成します:セッションを自分のユーザーに紐付けたいですか? デフォルトでは、セッションはサービスユーザーに紐付けられます。特定のユーザーの代理としてセッションを作成し (そのユーザーのセッション一覧に表示されるようにする) には、リクエストボディに
"create_as_user_id": "user_abc123" を追加します。これには Admin ロール (ImpersonateOrgSessions 権限を含む) が必要です。詳細は Session attribution を参照してください。ステップ 4: よく使う操作
セッションを一覧表示
実行中のセッションにメッセージを送信する
Knowledge の管理
Teams ユーザーの権限
Teams 組織にはシンプルな権限モデルがあります。プレイブックはスキルへの移行が進められています。移行済みの Teams アカウントでは、
/playbooks への書き込みは対応するプレイブックのスキルに反映されます。2026年10月24日以降に作成され、プレイブックが存在しないアカウントでは、/playbooks エンドポイントは 410 を返します。次のステップ
- サイドバーで 組織 API のエンドポイントを確認する
- 一般的な連携パターンについては common flows を参照する
- authentication について詳しく学ぶ
- 定期的なタスク向けに スケジュールされた自動化 を設定する

