Was sich ändert
Schritt 1: Dienstbenutzer erstellen
Ersetzen Sie Ihren veralteten API-Schlüssel durch einen Dienstbenutzer:- Gehen Sie zu Settings > Devin API und öffnen Sie die Registerkarte Dienstbenutzer
- Klicken Sie auf Provision Dienstbenutzer, weisen Sie eine geeignete Rolle zu und wählen Sie eine Ablaufzeit (standardmäßig 30 Tage)
- Kopieren Sie den nach der Provisionierung angezeigten API-Schlüssel (beginnt mit
cog_) - Aktualisieren Sie Ihre Integration, damit sie den neuen API-Schlüssel verwendet
Ihre veralteten API-Schlüssel funktionieren während der Deprecation-Phase weiterhin. Sie können die Migration schrittweise durchführen.
Schritt 2: Endpunkt-URLs aktualisieren
Sitzungsendpunkte
Knowledge-Endpunkte
Playbook-Endpunkte
Die
/playbooks-Endpunkte sind in allen API-Versionen veraltet. Playbooks werden zu Fähigkeiten migriert. Erstellen Sie neue Anweisungen als Fähigkeiten auf der Seite Anpassen. Ein Konto, das ab dem 24. Oktober 2026 erstellt wurde und keine Playbooks hat, erhält von diesen Endpunkten den Statuscode 410. Weitere Informationen finden Sie unter Playbooks werden zu Fähigkeiten migriert.Secrets-Endpunkte
Nur für Enterprise verfügbare Endpunkte (neu)
Diese Endpunkte haben keine v1-/v2-Entsprechung — sie sind nur in der aktuellen API-Version verfügbar:GET /v3/enterprise/organizations— Organisationen auflistenGET /v3/enterprise/audit-logs— Audit-LogsGET /v3/enterprise/consumption/*— Nutzungs- und AbrechnungsdatenGET /v3/enterprise/metrics/*— NutzungsmetrikenGET /v3/enterprise/members/users— BenutzerverwaltungGET /v3/enterprise/roles— Rollenverwaltung- Bereitstellung von Servicebenutzern, IP-Zugriffslisten, ACU-Limits und mehr
Schritt 3: Paginierung aktualisieren
Die aktuelle API verwendet cursor-basierte Paginierung anstelle einer offset-basierten Paginierung:Schritt 4: Umgang mit Änderungen am Antwortformat
Statuswerte für Sitzungen
Die aktuelle API liefert detailliertere Statusinformationen. Weitere Details zum vollständigen Schema finden Sie in der Endpoint-Referenz.Fehlerantworten
Die aktuelle API gibt Fehler im Format RFC 9457 mit dem Content-Typeapplication/problem+json zurück. Der Body enthält die Member type, title und status. Optional kann er zusätzlich die Member detail, instance, errors und error_code enthalten.
Die Legacy-APIs geben einen JSON-Body mit einem detail-Member zurück. Bei 422-Antworten der aktuellen API ist detail eine Zeichenfolge, und das Member errors enthält die Fehler auf Feldebene.
Zeitplan für die Außerbetriebnahme
Unter Settings > Devin API werden veraltete Schlüssel auf der Registerkarte API-Schlüssel (legacy) aufgeführt. Unter Enterprise settings > Devin API finden Sie sie auf der Registerkarte Legacy API, auf der ein Hinweisbanner zur Außerbetriebnahme angezeigt wird. Während der Übergangsphase:- Jetzt: Veraltete API-Schlüssel funktionieren weiterhin. Neue Organisationen haben möglicherweise keinen Zugriff mehr auf die Erstellung solcher Schlüssel.
- Deprecation-Phase: Sowohl veraltete Schlüssel als auch Service-User-Tokens funktionieren parallel.
- Ende der Lebensdauer: Veraltete API-Schlüssel werden bald entfernt. Prüfen Sie regelmäßig Ihre Devin-Einstellungen auf entsprechende Ankündigungen.

