Zum Hauptinhalt springen
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.

​
Erste Schritte

Schnellstart für Teams

Für Teams und Standardorganisationen. Erstellen Sie einen Servicebenutzer und führen Sie in wenigen Minuten Ihren ersten API-Aufruf aus.

Enterprise-Schnellstart

Für Enterprise-Kunden mit RBAC, Unterstützung für mehrere Organisationen und erweiterten Berechtigungen.
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.

​
API-Struktur

Die API ist in zwei Geltungsbereiche gegliedert:

​
Organisations-API

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.

​
Enterprise-API

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.

​
Sitzungszuordnung

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. 
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"
  }'
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.
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.
Sie können Benutzer-IDs entweder über den Endpoint List users oder in der Devin-UI unter den Einstellungen für Organisationsmitglieder finden.

​
Legacy-APIs (v1 und v2)

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.

​
Fehlerbehandlung

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

​
Support

Bei Fragen zur API oder um Probleme zu melden, senden Sie eine E-Mail an support@cognition.ai.