Zum Hauptinhalt springen
Diese Anleitung hilft Ihnen, bestehende Integrationen von API v1 oder v2 auf die aktuellen Organisations- und Enterprise-APIs zu migrieren. Die Legacy-APIs (v1 und v2) funktionieren während der Deprecation-Phase weiterhin, aber alle neuen Funktionen stehen nur in der aktuellen API zur Verfügung.

Was sich ändert

Schritt 1: Dienstbenutzer erstellen

Ersetzen Sie Ihren veralteten API-Schlüssel durch einen Dienstbenutzer:
  1. Gehen Sie zu Settings > Devin API und öffnen Sie die Registerkarte Dienstbenutzer
  2. Klicken Sie auf Provision Dienstbenutzer, weisen Sie eine geeignete Rolle zu und wählen Sie eine Ablaufzeit (standardmäßig 30 Tage)
  3. Kopieren Sie den nach der Provisionierung angezeigten API-Schlüssel (beginnt mit cog_)
  4. 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 auflisten
  • GET /v3/enterprise/audit-logs — Audit-Logs
  • GET /v3/enterprise/consumption/* — Nutzungs- und Abrechnungsdaten
  • GET /v3/enterprise/metrics/* — Nutzungsmetriken
  • GET /v3/enterprise/members/users — Benutzerverwaltung
  • GET /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:
Siehe Paginierung für Details.

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-Type application/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.
Wir empfehlen, so bald wie möglich auf Dienstbenutzer zu migrieren, um von rollenbasierter Zugriffskontrolle, Sitzungszuordnung und neuen Funktionen zu profitieren.

Benötigen Sie Hilfe?

Wenn während der Migration Probleme auftreten, wenden Sie sich über Ihren üblichen Devin Support-Kanal an uns oder kontaktieren Sie uns unter support@cognition.ai.