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 クイックスタート を参照してください。一部の Enterprise エンドポイントは、
/v3/enterprise/organizations/{org_id}/...(たとえば監査ログやタグ)といったパスを使って特定の組織に対して動作します。
org_id パラメーターを含んでいても、Enterprise レベルの権限が必要です。Enterprise 権限
| Permission | 制御対象 |
|---|---|
ReadAccountMeta | 自分自身(デフォルトですべてのサービスユーザーに付与) |
ManageEnterpriseSettings | 監査ログ、Organization タグ |
ManageOrganizations | Organization の CRUD、Organization グループ数の上限 |
ManageAccountMembership | ロール、Enterprise ユーザー、Enterprise IdP グループ、Enterprise サービスユーザーのメンバーシップ、Enterprise IdP グループ登録 |
ManageAccountServiceUsers | サービスユーザーのプロビジョニング(Enterprise) |
ManageAccountKnowledge | Knowledge ノート(Enterprise) |
ManageAccountPlaybooks | Playbook(Enterprise) |
ManageGitIntegrations | Git 接続、Git 権限 |
ManageBilling | 利用サイクル、日次の利用内訳 |
ViewAccountMetrics | 利用状況メトリクス(DAU/WAU/MAU、PR(プルリクエスト)、セッション、検索、アクティブユーザー)、キューのステータス |
ViewEnterpriseInfraDetails | ハイパーバイザー |
ViewAccountSessions | セッションの一覧と詳細(Enterprise、読み取り専用) |
ManageAccountSessions | セッションへのメッセージの送信(Enterprise) |
組織権限
| Permission | Controls |
|---|---|
ManageOrgSecrets | シークレットの CRUD |
ManageOrgKnowledge | Knowledge ノート(組織) |
ManageOrgPlaybooks | Playbook(組織) |
ManageOrgServiceUsers | サービスユーザーのプロビジョニング(組織) |
ManageOrgSchedules | スケジュールされたセッション |
ViewOrgSessions | セッションの一覧および詳細(組織、読み取り専用) |
ManageOrgSessions | メッセージの送信、セッションの終了およびアーカイブ |
UseDevinSessions | セッションの作成 |
ImpersonateOrgSessions | 他のユーザーになり代わってセッションを作成(create_as_user_id) |
権限の継承
/v3/enterprise/* エンドポイントで認証を行い、すべての組織をまたいで操作できます。Enterprise レベルのロールが割り当てられ、各ロールに対応する組織レベルの権限を、すべての組織で自動的に継承します(たとえば、ViewAccountSessions はすべての組織で ViewOrgSessions を付与します)。
Organization サービスユーザー は単一の組織のみにスコープが限定され、/v3/organizations/{org_id}/* エンドポイントでのみ認証されます。これらのユーザーには組織レベルのロールが割り当てられます。
サービスユーザーの作成
- Enterprise サービスユーザー: Enterprise settings → Service Users
- Organization サービスユーザー: Organization settings → Service Users
