Zum Hauptinhalt springen
Diese Anleitung hilft Ihnen, bestehende Integrationen von API v1 oder v2 auf die aktuellen Organization- 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

Bereichv1/v2 (Legacy)Aktuelle API
AuthentifizierungAPI keys (beginnen mit apk_user_ oder apk_)Service-User-Tokens (beginnen mit cog_)
Basis-URL/v1/*, /v2/*/v3/organizations/*, /v3/enterprise/*
PaginierungOffset-basiert (offset + limit)Cursor-basiert (first + after)
GeltungsbereichFlach – alle Endpunkte auf einer EbeneOrganisationsbezogen und Enterprise-bezogen
BerechtigungenAuf Schlüssel-Ebene (alles oder nichts)Rollenbasiert mit granularen Berechtigungen

​
Schritt 1: Dienstbenutzer erstellen

Ersetzen Sie Ihren bisherigen API key durch einen Dienstbenutzer:
  1. Gehen Sie zu Settings > Service users
  2. Erstellen Sie einen Dienstbenutzer mit einer geeigneten Rolle
  3. Generieren Sie einen API key (beginnt mit cog_)
  4. Aktualisieren Sie Ihre Integration, damit sie den neuen API key verwendet
# Vorher (veralteter API key)
curl -H "Authorization: Bearer apk_user_YOUR_LEGACY_KEY" ...

# Nachher (Service-User-Token)
curl -H "Authorization: Bearer cog_YOUR_SERVICE_USER_KEY" ...
Ihre Legacy-API keys funktionieren während der Auslaufphase weiterhin. Sie können die Migration schrittweise durchführen.

​
Schritt 2: Endpunkt-URLs aktualisieren

​
Session-Endpunkte

Operationv1-EndpunktAktueller Endpunkt
Session erstellenPOST /v1/sessionsPOST /v3/organizations/sessions
Sessions auflistenGET /v1/sessionsGET /v3/organizations/sessions
Session abrufenGET /v1/session/{session_id}GET /v3/organizations/sessions/{devin_id}
Nachricht sendenPOST /v1/session/{session_id}/messagePOST /v3/organizations/sessions/{devin_id}/messages
Session archivieren—POST /v3/organizations/sessions/{devin_id}/archive
Session löschen—DELETE /v3/organizations/sessions/{devin_id}

​
Knowledge-Endpunkte

Operationv1-EndpunktAktueller Endpunkt
Knowledge auflistenGET /v1/knowledgeGET /v3/organizations/knowledge/notes
Knowledge erstellenPOST /v1/knowledgePOST /v3/organizations/knowledge/notes
Knowledge aktualisierenPUT /v1/knowledge/{note_id}PUT /v3/organizations/knowledge/notes/{note_id}
Knowledge löschenDELETE /v1/knowledge/{note_id}DELETE /v3/organizations/knowledge/notes/{note_id}

​
Playbook-Endpunkte

Operationv1/v2-EndpunktAktueller Endpunkt
Playbooks auflistenGET /v1/playbooksGET /v3/organizations/playbooks
Playbook erstellenPOST /v1/playbooksPOST /v3/organizations/playbooks
Playbook abrufenGET /v1/playbooks/{playbook_id}GET /v3/organizations/playbooks/{playbook_id}
Playbook aktualisierenPUT /v1/playbooks/{playbook_id}PUT /v3/organizations/playbooks/{playbook_id}
Playbook löschenDELETE /v1/playbooks/{playbook_id}DELETE /v3/organizations/playbooks/{playbook_id}

​
Secrets-Endpunkte

Operationv1-EndpunktAktueller Endpunkt
Secrets auflistenGET /v1/secretsGET /v3/organizations/secrets
Secret erstellenPOST /v1/secretsPOST /v3/organizations/secrets
Secret löschenDELETE /v1/secrets/{secret_id}DELETE /v3/organizations/secrets/{secret_id}

​
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 von Offset-Paginierung: 
# Vorher (v1/v2 offset-basiert)
curl "https://api.devin.ai/v1/sessions?offset=0&limit=25"

# Nachher (cursor-basiert)
curl "https://api.devin.ai/v3/organizations/sessions?first=25"
# Dann `end_cursor` aus der Antwort für die nächste Seite verwenden:
curl "https://api.devin.ai/v3/organizations/sessions?first=25&after=CURSOR_VALUE"
Weitere Informationen finden Sie unter Pagination.

​
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

Das Fehlerformat ist einheitlich: HTTP-Statuscode + JSON-Objekt mit Fehlerdetails.

​
Zeitplan für die Außerbetriebnahme

Veraltete API keys zeigen ein Hinweisbanner zur Außerbetriebnahme in den Devin-Einstellungen an. Während der Übergangsphase:
  • Jetzt: Veraltete API keys funktionieren weiterhin. Neue Organisationen haben möglicherweise keinen Zugriff mehr auf die Erstellung solcher Schlüssel.
  • Außerbetriebnahmezeitraum: Sowohl veraltete Schlüssel als auch Servicebenutzer-Tokens funktionieren parallel.
  • Ende der Lebensdauer: Veraltete API keys werden bald entfernt. Prüfen Sie regelmäßig Ihre Devin-Einstellungen auf entsprechende Ankündigungen.
Wir empfehlen, so bald wie möglich auf Servicebenutzer 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.