> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 権限と RBAC
> Devin API の権限リファレンス
すべての API エンドポイントは、呼び出し元のサービスユーザーのロールに割り当てられた特定の権限によって制御されています。各エンドポイントに必要な権限は、そのエンドポイントごとの API リファレンスページに記載されています。このページでは、スコープ別にすべての権限の概要を示します。
**ベース URL:**
* `https://api.devin.ai/v3/organizations/*` — 単一の組織をスコープとするエンドポイント
* `https://api.devin.ai/v3/enterprise/*` — Enterprise レベルの権限が必要なエンドポイント
専用デプロイメントをご利用の **Devin Enterprise** 契約のお客様は、`api.devin.ai` をカスタム API ドメイン (例: `api.your-company.devinenterprise.com`) に置き換えてください。セットアップの詳細については、[Enterprise クイックスタート](/ja/api-reference/getting-started/enterprise-quickstart) を参照してください。
組織 ID は **Settings → Service Users** ページで確認できます。
一部の Enterprise エンドポイントは、
`/v3/enterprise/organizations/{org_id}/...` (たとえば監査ログやタグ) といったパスを使って特定の組織に対して動作します。
`org_id` パラメーターを含んでいても、**Enterprise レベル**の権限が必要です。
## Enterprise 権限
| Permission | 制御対象 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ReadAccountMeta` | 自分自身 (デフォルトですべてのサービスユーザーに付与) |
| `ManageEnterpriseSettings` | 組織 タグ |
| `ManageOrganizations` | 組織 の CRUD、組織 グループ数の上限 |
| `ManageAccountMembership` | ロール、Enterprise ユーザー、Enterprise IdP グループ、Enterprise サービスユーザーのメンバーシップ、Enterprise IdP グループ登録 |
| `ViewAccountMembership` | ロール、Enterprise ユーザー、IdP グループ、サービスユーザーの一覧表示 (読み取り専用、`ManageAccountMembership` でも付与) |
| `ManageAccountServiceUsers` | サービスユーザーのプロビジョニング (Enterprise) |
| `ManageAccountKnowledge` | Knowledge ノート (Enterprise) |
| `ManageAccountPlaybooks` | Playbook (Enterprise) |
| `ViewGitIntegrations` | Git 接続と接続先リポジトリ (読み取り専用、`ManageGitIntegrations` でも付与) |
| `ManageGitIntegrations` | Git 統合の作成、編集、削除。`ViewGitIntegrations` も付与 |
| `ViewRepoPermissions` | Git 権限 (読み取り専用、`ManageRepoPermissions` でも付与) |
| `ManageRepoPermissions` | Git 権限の作成、置換、更新、削除 |
| `ManageBilling` | ACU上限 |
| `ViewAccountAuditLogs` | 監査ログ (Enterprise、読み取り専用) |
| `ViewAccountConsumption` | 消費量サイクル、日次の消費量の内訳 (Enterprise プランのみ) |
| `ViewAccountMetrics` | 利用状況メトリクス (DAU/WAU/MAU、PR (プルリクエスト) 、セッション、検索、アクティブユーザー) 、キューのステータス |
| `ViewEnterpriseInfraDetails` | ハイパーバイザー |
| `ViewAccountSessions` | セッションの一覧と詳細 (Enterprise、読み取り専用) |
| `ManageAccountSessions` | セッションへのメッセージの送信 (Enterprise) |
| `ViewAccountCodeScans` | [コードスキャン](/ja/api-reference/v3/code-scans/enterprise-code-scans-list)、[プロファイル](/ja/api-reference/v3/code-scans/enterprise-code-scans-profiles)、[プロファイルの詳細](/ja/api-reference/v3/code-scans/enterprise-code-scans-profile)、[検出結果](/ja/api-reference/v3/code-scans/enterprise-code-scans-findings)、[メトリクス](/ja/api-reference/v3/code-scans/enterprise-code-scans-metrics) (Enterprise、読み取り専用) |
| `UseAccountCodeScans` | [コードスキャンを開始](/ja/api-reference/v3/code-scans/enterprise-code-scans-start)、[取り込みスキャンを開始](/ja/api-reference/v3/code-scans/enterprise-code-scans-start-ingestion)、[検出結果を修復](/ja/api-reference/v3/code-scans/enterprise-code-scans-remediate) (Enterprise) |
## 組織権限
| Permission | Controls |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ManageOrgSecrets` | シークレットの CRUD |
| `ManageOrgKnowledge` | Knowledge ノート (組織) |
| `ManageOrgPlaybooks` | Playbook (組織) |
| `ManageOrgServiceUsers` | サービスユーザーのプロビジョニング (組織) |
| `ManageOrgSchedules` | スケジュールされたセッション |
| `ViewOrgAutomations` | 自動化の一覧および詳細 (組織、読み取り専用) |
| `ManageOrgAutomations` | 自動化の作成、編集、削除 |
| `UsePersonalAutomations` | 個人用の自動化 (`run_as: creator`) |
| `ViewOrgConsumption` | 日次の消費量の内訳 (組織、Enterprise プランのみ) |
| `ViewOrgSessions` | セッションの一覧と詳細 (組織、読み取り専用) |
| `ManageOrgSessions` | メッセージの送信、セッションの終了およびアーカイブ |
| `UseDevinSessions` | セッションの作成 |
| `ImpersonateOrgSessions` | 他のユーザーになり代わってセッションを作成 (`create_as_user_id`) |
| `ViewCodeScans` | [コードスキャン](/ja/api-reference/v3/code-scans/organizations-code-scans-list)、[プロファイル](/ja/api-reference/v3/code-scans/organizations-code-scans-profiles)および[プロファイルの詳細](/ja/api-reference/v3/code-scans/organizations-code-scans-profile)、[検出結果](/ja/api-reference/v3/code-scans/organizations-code-scans-findings)および[メトリクス](/ja/api-reference/v3/code-scans/organizations-code-scans-metrics) (組織、読み取り専用) |
| `UseCodeScans` | [コードスキャンを開始](/ja/api-reference/v3/code-scans/organizations-code-scans-start)、[取り込みスキャンを開始](/ja/api-reference/v3/code-scans/organizations-code-scans-start-ingestion)および[検出結果を修復](/ja/api-reference/v3/code-scans/organizations-code-scans-remediate) (組織) |
## 権限の継承
**Enterprise サービスユーザー** は `/v3/enterprise/*` エンドポイントで認証を行い、すべての組織をまたいで操作できます。Enterprise レベルのロールが割り当てられ、各ロールに対応する組織レベルの権限を、すべての組織で自動的に継承します (たとえば、`ViewAccountSessions` はすべての組織で `ViewOrgSessions` を付与します) 。
**Organization サービスユーザー** は単一の組織のみにスコープが限定され、`/v3/organizations/{org_id}/*` エンドポイントでのみ認証されます。これらのユーザーには組織レベルのロールが割り当てられます。
## サービスユーザーの作成
サービスユーザーは Devin の UI から作成できます。
1. **Enterprise サービスユーザー**: Enterprise settings → Service Users
2. **Organization サービスユーザー**: Organization settings → Service Users
セットアップ手順については、[Teams クイックスタート](/ja/api-reference/getting-started/teams-quickstart) または [Enterprise クイックスタート](/ja/api-reference/getting-started/enterprise-quickstart) を参照してください。