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

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

  1. 組織の Settings > Devin API に移動し、サービスユーザー タブを開きます
  2. サービスユーザーをプロビジョニング をクリックします
  3. わかりやすい表示名を選びます (例: “CI Pipeline”, “Monitoring Bot”)
  4. Organization role ドロップダウンでロールを選択します。フォームには個別の権限チェックボックスはありません。サービスユーザーの権限は、選択したロールによって決まります。
    • Admin — 組織の設定とメンバーシップを含むフルアクセス権
    • Member — Devin セッションおよびほとんどの組織リソースを作成・管理できますが、組織の設定やメンバーシップは管理できません
  5. 有効期限 を選択します。デフォルトは 30 days で、ほかに 7 days、90 days、およびアカウントで許可されている場合は Never を選択できます。有効期限を過ぎるとサービスユーザーのAPIキーは使用できなくなるため、それまでに代わりのサービスユーザーをプロビジョニングしてください。有効期限を短くしておくと、キーが漏洩した場合に悪用される期間を短く抑えられます。
ほとんどの自動化には Member ロールを使用してください。連携が組織の設定や他のユーザーを管理する必要がある場合にのみ Admin を使用してください。

ステップ 2: APIキーをコピーする

  1. サービスユーザーをプロビジョニングすると、そのAPIキーがダイアログに表示されます
  2. すぐにキーをコピーします — cog_ で始まり、この画面以降は表示されません
  3. 環境変数として安全に保存してください:

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

Devin セッションを作成します:
組織 ID は Settings → Devin API ページの上部で確認できます。
セッションを自分のユーザーに紐付けたいですか? デフォルトでは、セッションはサービスユーザーに紐付けられます。特定のユーザーの代理としてセッションを作成し (そのユーザーのセッション一覧に表示されるようにする) には、リクエストボディに "create_as_user_id": "user_abc123" を追加します。これには Admin ロール (ImpersonateOrgSessions 権限を含む) が必要です。詳細は Session attribution を参照してください。

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

セッションを一覧表示

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

Knowledge の管理

Teams ユーザーの権限

Teams 組織にはシンプルな権限モデルがあります。
プレイブックはスキルへの移行が進められています。移行済みの Teams アカウントでは、/playbooks への書き込みは対応するプレイブックのスキルに反映されます。2026年10月24日以降に作成され、プレイブックが存在しないアカウントでは、/playbooks エンドポイントは 410 を返します。
よりきめ細かなロールベースのアクセス制御 (RBAC) については、Enterprise クイックスタートを参照してください。

次のステップ