> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート：Teams

> Teams または標準組織のユーザーとして Devin API の利用を開始する

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

<Note>
  複数の組織、カスタムロール、または SSO (シングルサインオン) を利用している Enterprise 組織に所属している場合は、代わりに [Enterprise クイックスタート](/ja/api-reference/getting-started/enterprise-quickstart) を参照してください。
</Note>

<div id="step-1-create-a-service-user">
  ## ステップ 1: サービスユーザーを作成する
</div>

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

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

<div id="step-2-generate-an-api-key">
  ## ステップ 2: APIキーを生成する
</div>

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

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<div id="step-3-make-your-first-api-call">
  ## ステップ 3: 最初のAPIコールを行う
</div>

Devin セッションを作成します:

```bash theme={null}
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"}'
```

<Tip>
  組織 ID は **Settings → Service Users** ページで確認できます。
</Tip>

<Note>
  **セッションを自分のユーザーに紐付けたいですか？** デフォルトでは、セッションはサービスユーザーに紐付けられます。特定のユーザーの代理としてセッションを作成し (そのユーザーのセッション一覧に表示されるようにする) には、リクエストボディに `"create_as_user_id": "user_abc123"` を追加します。これには **Admin** ロール (`ImpersonateOrgSessions` 権限を含む) が必要です。詳細は [Session attribution](/ja/api-reference/overview#session-attribution) を参照してください。
</Note>

<div id="step-4-common-operations">
  ## ステップ 4: よく使う操作
</div>

<div id="list-your-sessions">
  ### セッションを一覧表示
</div>

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="send-a-message-to-a-running-session">
  ### 実行中のセッションにメッセージを送信する
</div>

```bash theme={null}
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"}'
```

<div id="manage-knowledge">
  ### Knowledge の管理
</div>

```bash theme={null}
# 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..."}'
```

<div id="permissions-for-teams-users">
  ## Teams ユーザーの権限
</div>

Teams 組織にはシンプルな権限モデルがあります。

| ロール        | セッションを作成できる | リソースを管理できる                   | 設定を管理できる |
| ---------- | ----------- | ---------------------------- | -------- |
| **Member** | はい          | はい (Knowledge、プレイブック、シークレット) | いいえ      |
| **Admin**  | はい          | はい                           | はい       |

よりきめ細かなロールベースのアクセス制御 (RBAC) については、[Enterprise クイックスタート](/ja/api-reference/getting-started/enterprise-quickstart)を参照してください。

<div id="next-steps">
  ## 次のステップ
</div>

* サイドバーで **組織 API** のエンドポイントを確認する
* 一般的な連携パターンについては [common flows](/ja/api-reference/common-flows) を参照する
* [authentication](/ja/api-reference/authentication) について詳しく学ぶ
* 定期的なタスク向けに [scheduled sessions](/ja/api-reference/v3/schedules/organizations-schedules) を設定する