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

# API-Übersicht

> Erfahre, wie du Devin über unsere REST-APIs programmatisch nutzen kannst

Die Devin-API ermöglicht es dir, Devin in deine Anwendungen zu integrieren, Workflows zu automatisieren und leistungsstarke Tools zu entwickeln. Verwende **Service-Benutzer** mit rollenbasierter Zugriffskontrolle für sicheren, nachvollziehbaren API-Zugriff.

<div id="getting-started">
  ## Erste Schritte
</div>

<CardGroup cols={2}>
  <Card title="Schnellstart für Teams" icon="rocket" href="/de/api-reference/getting-started/teams-quickstart">
    Für Teams und Standardorganisationen. Erstellen Sie einen Servicebenutzer und führen Sie in wenigen Minuten Ihren ersten API-Aufruf aus.
  </Card>

  <Card title="Enterprise-Schnellstart" icon="building" href="/de/api-reference/getting-started/enterprise-quickstart">
    Für Enterprise-Kunden mit RBAC, Unterstützung für mehrere Organisationen und erweiterten Berechtigungen.
  </Card>
</CardGroup>

<Tip>
  **Welchen Einstieg sollte ich wählen?** Die meisten Kunden sollten mit dem Schnellstart für Teams beginnen. Wählen Sie den Enterprise-Schnellstart, wenn Sie mehrere Organisationen verwalten, Single Sign-On (SSO) verwenden oder benutzerdefinierte Rollen und RBAC benötigen.
</Tip>

<div id="api-structure">
  ## API-Struktur
</div>

Die API ist in zwei Geltungsbereiche gegliedert:

<div id="organization-api">
  ### Organisations-API
</div>

**Basis-URL:** `https://api.devin.ai/v3/organizations/*`

Zum Verwalten von Ressourcen innerhalb einer einzelnen Organisation – etwa Sessions, Knowledge, Playbooks, Secrets und mehr. Hier starten die meisten Integrationen.

<div id="enterprise-api">
  ### Enterprise-API
</div>

**Basis-URL:** `https://api.devin.ai/v3/enterprise/*`

Für organisationsübergreifendes Management – Analytics, Audit-Logs, Benutzerverwaltung, Abrechnung und Infrastruktur. Verfügbar für Enterprise-Kunden.

Beide Scopes verwenden Anmeldedaten eines Service-Benutzers (Präfix `cog_`). Weitere Informationen zur Einrichtung finden Sie unter [Authentication](/de/api-reference/authentication).

<div id="session-attribution">
  ## Sitzungszuordnung
</div>

Servicebenutzer sind eigenständige Identitäten, die sich von menschlichen Benutzern unterscheiden, aber Sie können **Sitzungen im Namen beliebiger Benutzer** in Ihrer Organisation mit dem Parameter `create_as_user_id` erstellen. Das bedeutet, dass Sitzungen in der Sitzungsliste dieses Benutzers erscheinen und zu dessen Nutzung gezählt werden – so, als hätte der Benutzer sie selbst erstellt.

```bash theme={null}
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": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
```

<Tip>
  **Nutzen Sie bisher persönliche API keys?** In v1/v2 haben persönliche API keys automatisch Sitzungen in Ihrem Benutzerkontext erstellt. Mit v3 verwenden Sie dafür einen Service User plus `create_as_user_id` – mit dem zusätzlichen Vorteil von RBAC, Audit Trails und zentralem Key-Management. Die Rolle des Service Users muss die Berechtigung `ImpersonateOrgSessions` enthalten.
</Tip>

<Note>
  **Personal Access Tokens (PATs) sind bald verfügbar.** PATs ermöglichen es Ihnen, sich mit der v3 API direkt als Ihr Benutzerkonto zu authentifizieren – kein Service User oder `create_as_user_id` erforderlich. Sitzungen werden dann automatisch Ihnen zugeordnet. Informationen zur Verfügbarkeit folgen.
</Note>

Sie können Benutzer-IDs entweder über den Endpoint [List users](/de/api-reference/v3/users/organizations-members-users) oder in der Devin-UI unter den Einstellungen für Organisationsmitglieder finden.

<div id="legacy-apis-v1-and-v2">
  ## Legacy-APIs (v1 und v2)
</div>

Die v1- und v2-APIs funktionieren während des Abkündigungszeitraums weiterhin, erhalten jedoch keine neuen Funktionen. Wir empfehlen die Migration auf die aktuelle API für rollenbasierte Zugriffskontrolle, Sitzungszuordnung und neue Funktionen.

* [v1-API-Dokumentation](/de/api-reference/v1/overview) — Sitzungsverwaltung mit Legacy API keys
* [v2-API-Dokumentation](/de/api-reference/v2/overview) — Enterprise-Management mit Legacy API keys
* [Migrationsleitfaden](/de/api-reference/getting-started/migration-guide) — Schritt-für-Schritt-Migration von v1/v2

***

<div id="error-handling">
  ## Fehlerbehandlung
</div>

Alle APIs verwenden standardisierte HTTP-Statuscodes:

* `200 OK`: Erfolgreiche Anfrage
* `201 Created`: Ressource erfolgreich erstellt
* `400 Bad Request`: Ungültige Anfrageparameter
* `401 Unauthorized`: Fehlender oder ungültiger API key
* `403 Forbidden`: Unzureichende Berechtigungen
* `404 Not Found`: Ressource nicht gefunden
* `429 Too Many Requests`: Anfragelimit überschritten
* `500 Internal Server Error`: Serverfehler

<div id="support">
  ## Support
</div>

Bei Fragen zur API oder um Probleme zu melden, senden Sie eine E-Mail an [support@cognition.ai](mailto:support@cognition.ai).