Zum Hauptinhalt springen
Diese Seite beschreibt häufige End-to-End-Workflows mit der Devin API. Jeder Workflow umfasst die vollständige Abfolge von API-Aufrufen mit Codebeispielen. Einzelheiten zu den jeweiligen Endpunkten finden Sie auf den entsprechenden Seiten der API-Referenz.

Einrichtung

Legen Sie diese Umgebungsvariablen fest, bevor Sie ein Beispiel ausführen:

Erste Schritte: vom API key bis zur ersten Sitzung

Der häufigste Workflow — authentifizieren Sie sich, ermitteln Sie Ihr Konto und erstellen Sie Ihre erste Sitzung.

Schritt 1: Überprüfen Sie Ihre Anmeldedaten

Service-Benutzer im org-Geltungsbereich können zu Schritt 3 wechseln — Sie kennen Ihre org-ID bereits von der Settings-Seite.
Antwort:

Schritt 2: Ihre Organisationen auflisten

Enterprise-Service-Benutzer können alle Organisationen auflisten:
Service-Benutzer im Org-Geltungsbereich kennen ihre Org-ID bereits (sie wird oben auf der Seite Settings > Devin API angezeigt, auf der der Service-Benutzer bereitgestellt wurde).

Schritt 3: Eine Sitzung erstellen

Antwort:

Schritt 4: Auf Ereignisse pollen

Überwachen Sie die Sitzung, indem Sie Nachrichten regelmäßig pollen:

Vollständiges Python-Beispiel


Anhänge einer Sitzung herunterladen

Laden Sie Dateien herunter, die in einer Sitzung erstellt wurden (Logs, Screenshots, generierter Code usw.).

Schritt 1: Sitzung abrufen

Schritt 2: Anhänge auflisten

Antwort:

Schritt 3: Herunterladen

Verwenden Sie für den Wert url keinen API-Schlüssel. Für diese URL ist eine Anmeldung in der Web-App erforderlich. Verwenden Sie den Download-Endpunkt mit den Werten attachment_id und name. Der Endpunkt gibt eine 307-Weiterleitung auf eine kurzlebige URL zurück. Folgen Sie daher Weiterleitungen:

Vollständiges Python-Beispiel


Verwaltung von Knowledge und Playbooks

Verwalten Sie den Kontext und die Anweisungen, die Devin sitzungsübergreifend verwendet.

Knowledge-Hinweis erstellen

Knowledge-Hinweise auflisten

Einen Knowledge-Hinweis aktualisieren

Einen Knowledge-Hinweis löschen

Ein Playbook erstellen

Die /playbooks-Endpunkte sind veraltet. Playbooks werden zu Fähigkeiten migriert. In einem bereits migrierten Konto schreibt diese Anfrage den Skill des Playbooks. Ein Konto, das am oder nach dem 24. Oktober 2026 erstellt wurde und keine Playbooks enthält, erhält von diesen Endpunkten 410. Siehe Playbooks werden zu Fähigkeiten migriert.

Vollständiges Beispiel in Python


Automatisierte Sitzungen planen

Erstellen Sie wiederkehrende Sitzungen mit einer Automatisierung, die über einen schedule:recurring-Trigger verfügt. Der Trigger erwartet eine rrule-Bedingung: eine iCalendar-RRULE, die in UTC ausgewertet wird (zum Beispiel FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=13;BYMINUTE=0 für Wochentage um 9 Uhr Eastern Time während der Sommerzeit). Erfordert die Berechtigung ManageOrgAutomations.
Die älteren /schedules-Endpunkte sind veraltet. Ab dem 24. September 2026 gibt POST /v3/organizations/{org_id}/schedules für Organisationen, die zu Automations migriert wurden, 403 zurück. Siehe die API-Versionshinweise.

Eine zeitgesteuerte Automatisierung erstellen

Für eine einmalige Ausführung verwenden Sie ein DTSTART mit COUNT=1, zum Beispiel DTSTART:20260915T170000Z\nRRULE:FREQ=DAILY;COUNT=1. Die Automatisierung wird einmal ausgelöst und deaktiviert sich anschließend selbst.

Auflisten, Update und Löschen

Vollständiges Python-Beispiel


Eine Aufgabe von überall an Devin übergeben

Da die Sessions API mit einer einzigen Anfrage eine Cloud-Devin-Sitzung erstellt, kann jedes Tool, Skript oder jeder Coding-Agent Arbeit an Devin “übergeben”, indem das aktuelle Repo, der Branch und nicht committete Änderungen im Prompt mitgegeben werden, sodass die Cloud-Sitzung dort anknüpft, wo Sie aufgehört haben.

Sitzung mit Repo-Kontext erstellen

Die Cloud-Sitzung klont das Repo, wendet den Kontext aus deinem Prompt an und läuft in ihrer eigenen VM mit einer Shell, einem Browser und vollständigem Repo-Zugriff. Du kannst sie verfolgen, indem du Nachrichten pollst oder in der Devin Web-App.
git diff HEAD kann nicht committete Secrets enthalten — API-Schlüssel, Tokens oder Änderungen an .env — und der Prompt wird in die Cloud-Sitzung hochgeladen. Prüfe deinen Diff und committe, stash oder entferne sensible Änderungen, bevor du übergibst.
Du willst das nicht selbst einrichten? Exportiere einen API-Schlüssel für die Devin API als DEVIN_API_KEY in deiner Shell und bitte dann deinen Coding-Agent, anhand dieses Ablaufs eine Devin-Sitzung zu erstellen. Siehe An Devin übergeben.

Fehlerbehandlung

Alle obigen Beispiele sollten im Produktiveinsatz eine Fehlerbehandlung enthalten. Hier ist ein wiederverwendbares Muster:

Support

Benötigen Sie Hilfe?

Bei Fragen zur API oder um issues zu melden, schreiben Sie an support@cognition.ai