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

# Schnellstart: Enterprise

> Erste Schritte mit der Devin API als Enterprise-Benutzer mit RBAC und Unterstützung für mehrere Organisationen

In dieser Anleitung erfahren Sie, wie Sie den API-Zugriff für **Enterprise-Organisationen** mit benutzerdefinierten Rollen, RBAC und Unterstützung für mehrere Organisationen einrichten.

<Note>
  Wenn Sie einen Teams-Tarif mit nur einer Organisation nutzen und keine benutzerdefinierten Rollen benötigen, ist der [Teams-Schnellstart](/de/api-reference/getting-started/teams-quickstart) einfacher.
</Note>

<Note>
  Wenn Sie ein **Devin Enterprise**-Kunde mit einer dedizierten Bereitstellung sind, müssen Sie `api.devin.ai` in allen API-URLs durch die benutzerdefinierte API-Domain Ihrer Organisation ersetzen (z. B. `api.your-company.devinenterprise.com`). Wenden Sie sich an Ihren Devin-Administrator oder den Cognition-Support, falls Sie sich bezüglich Ihrer API-Domain nicht sicher sind.
</Note>

<div id="understanding-service-user-scopes">
  ## Geltungsbereiche von Servicebenutzern verstehen
</div>

Enterprise-Kunden können Servicebenutzer auf zwei Ebenen erstellen:

| Geltungsbereich  | Basis-URL                      | Anwendungsfall                                                                   |
| ---------------- | ------------------------------ | -------------------------------------------------------------------------------- |
| **Enterprise**   | `/v3/enterprise/*`             | organisationsübergreifende Verwaltung, Analysen, Audit-Logs, Mitgliedsverwaltung |
| **Organization** | `/v3/organizations/{org_id}/*` | Sessions, Knowledge, Playbooks, Secrets innerhalb einer einzelnen Organisation   |

Ein Enterprise-Servicebenutzer mit Berechtigungen auf Enterprise-Ebene erbt automatisch die entsprechenden Berechtigungen auf Organisationsebene in **allen** Organisationen.

<div id="step-1-create-a-service-user">
  ## Schritt 1: Dienstbenutzer erstellen
</div>

<div id="enterprise-service-user-cross-org-access">
  ### Enterprise-Servicebenutzer (organisationsübergreifender Zugriff)
</div>

1. Wechseln Sie zu **Enterprise settings > Service users**
2. Klicken Sie auf **Create service user**
3. Wählen Sie einen Namen (z. B. „Analytics Dashboard“, „Org Provisioning Bot“)
4. Weisen Sie eine Enterprise-Rolle mit den Berechtigungen zu, die Ihre Integration benötigt

<div id="organization-service-user-single-org-access">
  ### Servicebenutzer auf Organisationsebene (Zugriff auf eine einzelne Organisation)
</div>

1. Gehe in der Zielorganisation zu **Settings > Service users**
2. Klicke auf **Create service user**
3. Wähle einen Namen und weise eine Rolle auf Organisationsebene zu

<Tip>
  Folge dem **Prinzip der geringsten Berechtigung**: Erstelle auf eine Organisation beschränkte Servicebenutzer, wenn deine Integration nur Zugriff auf eine einzige Organisation benötigt. Verwende Enterprise-Servicebenutzer nur für organisationsübergreifende Workflows.
</Tip>

<div id="step-2-generate-an-api-key">
  ## Schritt 2: API key generieren
</div>

1. Nachdem Sie den Servicebenutzer erstellt haben, klicken Sie auf **Generate API key**
2. Kopieren Sie den API key sofort — er beginnt mit `cog_` und wird Ihnen nicht erneut angezeigt
3. Speichern Sie ihn sicher als Umgebungsvariable:

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

<div id="step-3-make-your-first-api-call">
  ## Schritt 3: Ersten API-Aufruf ausführen
</div>

<div id="enterprise-endpoint-example">
  ### Beispiel für einen Enterprise-Endpunkt
</div>

Listen Sie alle Organisationen in Ihrem Enterprise-Konto auf:

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

<div id="organization-endpoint-example">
  ### Beispiel für einen Organisations-Endpunkt
</div>

Erstellen Sie eine Devin-Session in einer bestimmten Organisation:

```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": "Implement the feature described in JIRA-123"}'
```

<div id="permissions-and-rbac">
  ## Berechtigungen und RBAC
</div>

Jeder API-Endpunkt ist durch eine spezifische Berechtigung geschützt. Die erforderliche Berechtigung ist auf der API-Referenzseite des jeweiligen Endpunkts dokumentiert. Berechtigungen sind in zwei Geltungsbereiche aufgeteilt:

* **Enterprise-Berechtigungen** — steuern `/v3/enterprise/*`-Endpunkte (z. B. `ManageOrganizations`, `ManageBilling`, `ViewAccountMetrics`)
* **Organisationsberechtigungen** — steuern `/v3/organizations/{org_id}/*`-Endpunkte (z. B. `UseDevinSessions`, `ManageOrgSecrets`, `ManageOrgPlaybooks`)

Ein Enterprise-Servicebenutzer mit einer Enterprise-weiten Berechtigung erbt automatisch die entsprechende Organisationsberechtigung für alle Organisationen. Zum Beispiel gewährt `ViewAccountSessions` die Berechtigung `ViewOrgSessions` in jeder Organisation.

Die vollständige Referenz zu allen Berechtigungen finden Sie in der [Dokumentation zu Berechtigungen und RBAC](/de/api-reference/v3/overview#enterprise-permissions).

<div id="common-enterprise-workflows">
  ## Typische Enterprise-Workflows
</div>

<div id="monitor-consumption-across-orgs">
  ### Nutzung über alle Organisationen hinweg überwachen
</div>

```bash theme={null}
# Tägliche Verbrauchsaufschlüsselung abrufen (verwendet Unix-Zeitstempel — Beispiel: 1. Jan. bis 31. Jan. 2025)
curl "https://api.devin.ai/v3/enterprise/consumption/daily?time_after=1735689600&time_before=1738368000" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="audit-log-retrieval">
  ### Abrufen von Audit-Logs
</div>

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

<div id="manage-users-across-organizations">
  ### Benutzer organisationsübergreifend verwalten
</div>

```bash theme={null}
# Enterprise-Benutzer auflisten
curl "https://api.devin.ai/v3/enterprise/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Benutzer in einer bestimmten Organisation auflisten
curl "https://api.devin.ai/v3/enterprise/organizations/$DEVIN_ORG_ID/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="next-steps">
  ## Nächste Schritte
</div>

* Durchsuchen Sie die vollständige [Referenz zu API-Berechtigungen](/de/api-reference/v3/overview)
* Informieren Sie sich ausführlich über die [Authentifizierung](/de/api-reference/authentication)
* Richten Sie die [Paginierung](/de/api-reference/concepts/pagination) für große Ergebnismengen ein
* Lesen Sie den [Migrationsleitfaden](/de/api-reference/getting-started/migration-guide), wenn Sie von v1/v2 wechseln