> ## 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.

# Berechtigungen & RBAC

> Berechtigungsreferenz für die Devin API

Jeder API-Endpunkt mit Ausnahme von [`GET /v3/self`](/de/api-reference/v3/self/self) ist durch eine spezifische Berechtigung geschützt. Ein [Service-Benutzer](/de/api-reference/authentication#service-users-recommended-for-automation) erhält seine Berechtigungen über die ihm zugewiesene Rolle; ein [persönliches Zugriffstoken](/de/api-reference/personal-access-tokens) hat die Berechtigungen des Nutzers, der es erstellt hat. Die erforderliche Berechtigung für jeden Endpunkt ist auf seiner jeweiligen API-Referenzseite dokumentiert. Diese Seite bietet eine Zusammenfassung aller Berechtigungen nach Geltungsbereich.

**Basis-URLs:**

* `https://api.devin.ai/v3/organizations/*` — Endpunkte mit Geltungsbereich für eine einzelne Organisation
* `https://api.devin.ai/v3/enterprise/*` — Endpunkte, die Berechtigungen auf Enterprise-Ebene erfordern

<Note>
  **Devin Enterprise**-Kunden mit einer dedizierten Bereitstellung sollten `api.devin.ai` durch ihre eigene API-Domain ersetzen (z. B. `api.your-company.devinenterprise.com`). Weitere Details zur Einrichtung finden Sie im [Enterprise-Schnellstart](/de/api-reference/getting-started/enterprise-quickstart).
</Note>

<Tip>
  Ihre Organisations-ID finden Sie oben auf der Seite **Settings → Devin API**.
</Tip>

<Note>
  Einige Enterprise-Endpunkte beziehen sich auf bestimmte Organisationen und verwenden Pfade wie
  `/v3/enterprise/organizations/{org_id}/...` (zum Beispiel Audit-Logs und Tags).
  Auch wenn sie einen `org_id`-Parameter enthalten, erfordern sie **Berechtigungen auf Enterprise-Ebene**.
</Note>

<h2 id="enterprise-permissions">
  Enterprise-Berechtigungen
</h2>

| Berechtigung | Umfasst |
| - | - |
| `ManageEnterpriseSettings` | Organisationstags |
| `ViewOrganizations` | Organisationen auflisten und abrufen, Grenzwerte für Organisationsgruppen abrufen (schreibgeschützt; wird auch durch `ManageOrganizations` gewährt) |
| `ManageOrganizations` | Organisationen erstellen, aktualisieren und löschen, Grenzwerte für Organisationsgruppen aktualisieren; gewährt außerdem `ViewOrganizations` |
| `ManageAccountMembership` | Rollen, Enterprise-Benutzer, Enterprise-IdP-Gruppen, Mitgliedschaft von Enterprise-Service-Benutzern, Registrierung von Enterprise-IdP-Gruppen |
| `ViewAccountMembership` | Rollen, Enterprise-Benutzer, IdP-Gruppen und Service-Benutzer auflisten (schreibgeschützt; wird auch durch `ManageAccountMembership` gewährt) |
| `ManageAccountServiceUsers` | Bereitstellung von Service-Benutzern (Enterprise) |
| `UseAccountTools` | Knowledge-Notizen, Knowledge-Ordner und Playbooks auflisten und abrufen (Enterprise, schreibgeschützt; wird für Knowledge auch durch `ManageAccountKnowledge` und für Playbooks durch `ManageAccountPlaybooks` gewährt) |
| `ManageAccountKnowledge` | Knowledge-Notizen erstellen, aktualisieren und löschen (Enterprise); gewährt außerdem Lesezugriff |
| `ManageAccountPlaybooks` | Playbooks erstellen, aktualisieren und löschen (Enterprise); gewährt außerdem Lesezugriff |
| `ViewGitIntegrations` | Git-Verbindungen und Verbindungs-Repositorys (schreibgeschützt; wird auch durch `ManageGitIntegrations` gewährt) |
| `ManageGitIntegrations` | Git-Integrationen erstellen, bearbeiten und löschen; gewährt außerdem `ViewGitIntegrations` |
| `ViewRepoPermissions` | Git-Berechtigungen (schreibgeschützt; wird auch durch `ManageRepoPermissions` gewährt) |
| `ManageRepoPermissions` | Git-Berechtigungen erstellen, ersetzen, aktualisieren und löschen |
| `ManageBilling` | ACU-Limits |
| `ViewAccountAuditLogs` | Audit-Logs (Enterprise, schreibgeschützt) |
| `ViewAccountConsumption` | Verbrauchszyklen, tägliche Verbrauchsaufschlüsselungen (nur Enterprise-Plan) |
| `ViewAccountMetrics` | Nutzungsmetriken (DAU/WAU/MAU, PRs, Sitzungen, Suchvorgänge, aktive Benutzer), Warteschlangenstatus |
| `ViewEnterpriseInfraDetails` | Hypervisoren |
| `ViewAccountSessions` | Sitzungsliste und -detail (Enterprise, schreibgeschützt) |
| `ManageAccountSessions` | Nachrichten an Sitzungen senden (Enterprise) |
| `ViewAccountCodeScans` | [Code-Scans](/de/api-reference/v3/code-scans/enterprise-code-scans-list), [Profile](/de/api-reference/v3/code-scans/enterprise-code-scans-profiles) und [Profildetails](/de/api-reference/v3/code-scans/enterprise-code-scans-profile), [Befunde](/de/api-reference/v3/code-scans/enterprise-code-scans-findings) und [Metriken](/de/api-reference/v3/code-scans/enterprise-code-scans-metrics) (Enterprise, schreibgeschützt) |
| `UseAccountCodeScans` | [Code-Scans starten](/de/api-reference/v3/code-scans/enterprise-code-scans-start), [Ingestion-Scans starten](/de/api-reference/v3/code-scans/enterprise-code-scans-start-ingestion) und [Befunde beheben](/de/api-reference/v3/code-scans/enterprise-code-scans-remediate) (Enterprise) |

<h2 id="organization-permissions">
  Organisationsberechtigungen
</h2>

| Berechtigung | Umfassen |
| - | - |
| `ManageOrgSecrets` | Secrets (CRUD) |
| `ManageOrgSettings` | [Standardplattform der Organisation festlegen](/de/api-reference/v3/organization-settings/put-organization-default-platform) |
| `ManageOrgKnowledge` | Knowledge-Notizen erstellen, aktualisieren und löschen (Organisation) |
| `ManageOrgPlaybooks` | Playbooks erstellen, aktualisieren und löschen (Organisation) |
| `ManageOrgServiceUsers` | Bereitstellung von Service-Benutzern (Organisation) |
| `ManageOrgSchedules` | Geplante Sitzungen |
| `ViewOrgAutomations` | Automatisierungsliste und -detail (Organisation, schreibgeschützt) |
| `ManageOrgAutomations` | Automatisierungen erstellen, bearbeiten und löschen |
| `UsePersonalAutomations` | Persönliche Automatisierungen (`run_as: creator`) |
| `ViewOrgConsumption` | Tägliche Verbrauchsaufschlüsselungen (Organisation, alle Pläne) |
| `ViewOrgSessions` | Sitzungsliste und -detail (Organisation, schreibgeschützt) |
| `ManageOrgSessions` | Nachrichten senden, Sitzungen beenden und archivieren |
| `UseDevinSessions` | Sitzungen erstellen; Knowledge-Notizen, Knowledge-Ordner und Playbooks auflisten und abrufen (Organisation, schreibgeschützt) |
| `ImpersonateOrgSessions` | Sitzungen im Namen anderer Nutzer erstellen (`create_as_user_id`) |
| `ViewCodeScans` | [Code-Scans](/de/api-reference/v3/code-scans/organizations-code-scans-list), [Profile](/de/api-reference/v3/code-scans/organizations-code-scans-profiles) und [Profildetails](/de/api-reference/v3/code-scans/organizations-code-scans-profile), [Befunde](/de/api-reference/v3/code-scans/organizations-code-scans-findings) und [Metriken](/de/api-reference/v3/code-scans/organizations-code-scans-metrics) (Organisation, schreibgeschützt) |
| `UseCodeScans` | [Code-Scans starten](/de/api-reference/v3/code-scans/organizations-code-scans-start), [Ingestion-Scans starten](/de/api-reference/v3/code-scans/organizations-code-scans-start-ingestion) und [Befunde beheben](/de/api-reference/v3/code-scans/organizations-code-scans-remediate) (Organisation) |

<h2 id="permission-inheritance">
  Vererbung von Berechtigungen
</h2>

**Enterprise-Servicebenutzer** authentifizieren sich an `/v3/enterprise/*`-Endpunkten und können über alle Organisationen hinweg arbeiten. Ihnen werden Rollen auf Enterprise-Ebene zugewiesen, und sie erben automatisch die entsprechenden Berechtigungen auf Orgebene in jeder Organisation (zum Beispiel gewährt `ViewAccountSessions` die Berechtigung `ViewOrgSessions` in allen Organisationen).

**Organisationsservicebenutzer** sind auf eine einzelne Organisation beschränkt und authentifizieren sich ausschließlich an `/v3/organizations/{org_id}/*`-Endpunkten. Ihnen werden Rollen auf Orgebene zugewiesen.

<h2 id="creating-service-users">
  Service-Benutzer erstellen
</h2>

Service-Benutzer werden über die Devin UI erstellt:

1. **Enterprise-Service-Benutzer**: Enterprise settings → Devin API (Tab **Service users**)
2. **Organisation-Service-Benutzer**: Organization settings → Devin API (Tab **Service users**)

Weitere Informationen zur Einrichtung finden Sie in der [Schnellstartanleitung für Teams](/de/api-reference/getting-started/teams-quickstart) oder der [Enterprise-Schnellstart](/de/api-reference/getting-started/enterprise-quickstart).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.