Zum Hauptinhalt springen
Diese Seite dokumentiert Änderungen, die speziell für die Devin-APIs (v1, v2 und v3) gelten. Versionshinweise zur Anwendung finden Sie unter Application Release Notes.

​
2026

​
März 2026
v3 API-Updates
  • Endpunkt zum Generieren von Session-Insights (11. März): Die Endpunkte POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate und POST /v3/enterprise/sessions/{devin_id}/insights/generate wurden hinzugefügt, um die On-Demand-Generierung von Session-Insights auszulösen. Gibt { "status": "started" } zurück, wenn die Generierung beginnt, oder { "status": "already_exists" }, wenn Insights bereits generiert wurden oder die Generierung bereits läuft. Fragen Sie den vorhandenen GET-Insights-Endpunkt ab, um die Ergebnisse abzurufen. Erfordert die Berechtigung ManageOrgSessions.
​
Februar 2026
v3 API-Updates
  • v3-Endpunkte in Produktion übernommen: Die folgenden Endpunktgruppen wurden von v3beta1 auf v3 (Prod) übernommen. Aktualisieren Sie Ihre Basis-URLs von /v3beta1/ auf /v3/ für diese Endpunkte:
    • Sessions (create, list, get, messages, archive, terminate, tags, insights) – sowohl im Enterprise- als auch im Organisationskontext
    • Knowledge-Notizen – sowohl im Enterprise- als auch im Organisationskontext
    • Playbooks – sowohl im Enterprise- als auch im Organisationskontext
    • Secrets – Organisationskontext
    • Schedules – Organisationskontext
    • Attachments – Organisationskontext
    • Audit Logs – sowohl im Enterprise- als auch im Organisationskontext
    • Consumption & Billing (Zyklen, tägliche Aufschlüsselungen, ACU limits) – Enterprise-Kontext
    • Metrics (DAU, WAU, MAU, PRs, Sessions, Suchen, aktive Nutzer, Nutzung) – Enterprise-Kontext
    • Organizations, Users, Members, Roles, IDP-Gruppen – Enterprise-Kontext
    • Git-Verbindungen & Berechtigungen – Enterprise-Kontext
    • Hypervisors, Queues, IP Access Lists, Org-Gruppenlimits – Enterprise-Kontext
    • Session Tags (Standard-Tags der Organisation) – Enterprise-Kontext
    Weiterhin in Beta (v3beta1): Repository-Indexierungsendpunkte, Endpunkte zur Bereitstellung von Service-Benutzern sowie Endpunkte für Guardrail-Verstöße bleiben auf v3beta1 und sind in der Dokumentation mit einem Beta-Tag gekennzeichnet.
  • Endpunkte für Guardrail-Verstöße: Endpunkte GET /v3beta1/enterprise/guardrail-violations und GET /v3beta1/enterprise/organizations/{org_id}/guardrail-violations zum Abfragen von Guardrail-Verstößen im gesamten Enterprise hinzugefügt. Gibt Details zu Verstößen zurück, einschließlich Guardrail-Typ, Begründung, Confidence-Score, ergriffener Aktion und der auslösenden Nachricht. Unterstützt Filter nach session_id und guardrail_id sowie Zeitbereichs- und cursor-basierte Paginierung. Verwenden Sie den Endpunkt pro Organisation, um nach Organisation zu filtern. Erfordert die Berechtigung ManageEnterpriseSettings.
  • Endpunkte für IP-Zugriffslisten (9. Feb): Endpunkte GET /v3beta1/enterprise/ip-access-list, PUT /v3beta1/enterprise/ip-access-list und DELETE /v3beta1/enterprise/ip-access-list zum Verwalten von Enterprise-IP-Allowlists hinzugefügt. Der PUT-Endpunkt ersetzt die gesamte Liste durch die angegebenen IP-Bereiche (CIDR-Notation wird unterstützt). Erfordert die Berechtigung ManageEnterpriseSettings.
  • Endpunkte für geplante Sessions (3. Feb): Endpunkte zur Verwaltung von Zeitplänen auf Organisationsebene hinzugefügt: POST /v3beta1/organizations/{org_id}/schedules zum Erstellen von Zeitplänen, GET /v3beta1/organizations/{org_id}/schedules zum Auflisten von Zeitplänen, GET /v3beta1/organizations/{org_id}/schedules/{schedule_id} zum Abrufen eines bestimmten Zeitplans, PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id} zum Aktualisieren von Zeitplänen und DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id} zum Löschen von Zeitplänen. Erfordert die Berechtigung ManageOrgSchedules.
​
Januar 2026
v3-API-Updates
  • ACU-Limit-Endpunkte (27. Jan.): Endpunkte für das ACU-Limit-Management auf Enterprise-Ebene für Devin-Sessions hinzugefügt. Devin-Endpunkte: GET /v3beta1/enterprise/consumption/acu-limits/devin zum Abrufen von Limits, PUT .../organizations/{org_id} zum Festlegen von Limits auf Organisationsebene und DELETE zum Entfernen von Limits. Erfordert die Berechtigung ManageBilling.
  • Endpunkte für Anhänge (27. Jan.): Organisationsweite Endpunkte für Anhänge hinzugefügt: POST /v3beta1/organizations/{org_id}/attachments zum Hochladen von Anhängen und GET /v3beta1/organizations/{org_id}/attachments/{uuid}/{name} zum Herunterladen von Anhängen. Der Upload erfordert die Berechtigung UseDevinSessions, der Download erfordert die Berechtigung ViewOrgSessions.
  • Queue-Endpoint (21. Jan.): Neuer GET /v3beta1/enterprise/queue-Endpunkt für Enterprise-Administratoren zur Überwachung des Zustands der Sitzungswarteschlange. Gibt die Gesamtzahl der wartenden Sitzungen und einen Statusindikator (normal, elevated oder high) zurück. Nützlich zum Einrichten von Warnmeldungen bei Kapazitätsproblemen. Erfordert die Berechtigung ViewAccountMetrics.
  • Session-Endpunkte (19. Jan.): Endpunkte GET /v3beta1/enterprise/sessions/{devin_id} und GET /v3beta1/organizations/{org_id}/sessions/{devin_id} hinzugefügt, um Details zu einer bestimmten Session abzurufen. Endpunkte POST /v3beta1/enterprise/sessions/{devin_id}/messages und POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/messages hinzugefügt, um Nachrichten an aktive Sessions zu senden (Sessions werden automatisch fortgesetzt, wenn sie angehalten wurden). Außerdem wurde der Filterparameter origins zu den Session-Listen-Endpunkten hinzugefügt, um nach dem Ursprung der Session zu filtern (webapp, slack, teams, api, linear, jira, other).
  • Parameter für Sortierreihenfolge in Audit-Logs (17. Jan): Den Enterprise- und Organisations-Audit-Log-Endpunkten wurde der Abfrageparameter order (asc oder desc, Standardwert desc) hinzugefügt, um die Sortierreihenfolge der Ergebnisse zu steuern.
  • Secrets-Router (16. Jan): Endpunkte für die organisationsweite Verwaltung von Secrets hinzugefügt: GET /v3beta1/organizations/{org_id}/secrets zum Auflisten von Secrets, POST /v3beta1/organizations/{org_id}/secrets zum Erstellen von Secrets und DELETE /v3beta1/organizations/{org_id}/secrets/{secret_id} zum Löschen von Secrets. Erfordert die Berechtigung ManageOrgSecrets.
  • Audit-Logs-Fix (15. Januar): Ein Fehler wurde behoben, durch den end_cursor in Antworten der Audit-Logs-API nicht zurückgegeben wurde, wenn Elemente auf der Seite vorhanden waren.
  • Provisionierung von Servicebenutzern (14. Jan.): Neue Endpunkte POST /v3beta1/enterprise/service-users und POST /v3beta1/organizations/{org_id}/service-users für die programmgesteuerte Bereitstellung neuer Servicebenutzer hinzugefügt. Verhindert Privilegieneskalation: Die Berechtigungen der Zielrolle müssen eine Teilmenge der Berechtigungen des Aufrufers sein, und ManageServiceUsers-Berechtigungen dürfen niemals vergeben werden. Hierfür ist jeweils die Berechtigung ManageAccountServiceUsers bzw. ManageOrgServiceUsers erforderlich.
  • Endpunkte für IDP-Gruppen auf Enterprise-Ebene (14. Jan.): Neu hinzugekommen sind GET /v3beta1/enterprise/idp-groups zum Auflisten der bei einem Enterprise-Konto registrierten IDP-Gruppen, POST /v3beta1/enterprise/idp-groups zur Sammelregistrierung von IDP-Gruppen (bis zu 100 auf einmal) und DELETE /v3beta1/enterprise/idp-groups/{idp_group_name} zum Entfernen einer registrierten IDP-Gruppe. Gruppen mit vorhandenen Rollenzuweisungen oder Benutzermitgliedschaften können nicht gelöscht werden. Erfordert die Berechtigung ManageAccountMembership.
  • Audit-Log-Aktionen (12. Jan.): Die Aktionstypen create_join_request, automatic_join_event und reject_join_request wurden zu Audit-Log-Antworten hinzugefügt.
  • Endpoint für aktive Nutzer (8. Jan): Neuer GET /v3beta1/enterprise/metrics/active-users-Endpoint zum Abrufen eindeutiger aktiver Nutzer für einen benutzerdefinierten Datumsbereich. Im Gegensatz zu den DAU/WAU/MAU-Endpoints, die nach Zeitraum aufgeschlüsselte Listen zurückgeben, liefert dieser Endpoint eine einzige Zahl eindeutiger aktiver Nutzer über den gesamten angegebenen Zeitraum. Unterstützt die Filterung nach Organisations-IDs und konfigurierbaren Aktivitätsschwellenwerten (min_sessions, min_searches).
  • Standardstatus für Hypervisoren (8. Jan): Der Endpunkt GET /v3beta1/enterprise/hypervisors filtert jetzt standardmäßig nach dem Status available, anstatt alle Hypervisoren zurückzugeben. Geben Sie status=all an, um Hypervisoren unabhängig von ihrem Status abzurufen.
  • Session-Secrets (5. Jan): Der Parameter session_secrets wurde zum Endpoint zur Erstellung von Sessions (POST /v3beta1/organizations/{org_id}/sessions) hinzugefügt. Session-Secrets sind temporäre Secrets, die nur innerhalb der aktuellen Session verfügbar sind und nicht in den Organisations-Secrets gespeichert werden.
  • Paginierungsproblem behoben (5. Jan.): Fehler in der v3 Enterprise Users API behoben, bei dem end_cursor nicht immer korrekt zurückgegeben wurde.
v2-API-Aktualisierungen
  • Fehlerbehebung beim Klonen von Repositories (20. Jan): Das Schema des Endpunkts POST /v2/enterprise/organizations/{org_id}/clone-repository wurde korrigiert. Das veraltete Format RepoSetupStepsT wurde entfernt und der Request-Body vereinfacht, indem nun flache Felder verwendet werden (pull_repo_commands, run_lint_commands, run_project_commands, update_dependencies_commands, repo_note, repo_path).
  • Git-Berechtigungs-URL-Felder (15. Jan): Die Felder group_prefix_url und repo_url wurden dem GitPermissionRequest-Schema hinzugefügt und bieten vollständige URLs als Alternativen zur pfadbasierten Zuordnung von Repositories und Gruppenpräfixen.
  • Rollenfeld für Organisationsmitglieder (8. Jan.): Das Feld org_role_name wurde der Antwort des Endpunkts GET /v2/enterprise/organizations/{org_id}/members hinzugefügt und zeigt die Rolle jedes Mitglieds innerhalb der Organisation an.
  • Option zur Erstellung von Organisationen (8. Jan.): Der boolesche Parameter add_creator_as_member (Standardwert true) wurde zu POST /v2/enterprise/organizations hinzugefügt und ermöglicht es Enterprise-Admins, Organisationen zu erstellen, ohne dass sie automatisch als Mitglied hinzugefügt werden.
  • Dokumentation zur Verbrauchszeitzone (7. Jan.): Dokumentation zum Zeitzonenverhalten für die Endpunkte des täglichen Verbrauchs hinzugefügt. Abrechnungszyklen verwenden Mitternacht PST (08:00:00 UTC) als Tagesgrenze.
v1-API-Updates
  • Update der Secret-Typen (16. Jan.): dictionary als anerkannten Secret-Typwert im Secrets-API-Schema hinzugefügt. Hinweis: Das Anlegen von Secrets vom Typ dictionary ist veraltet; verwende stattdessen cookie, key-value oder totp.

​
2025

​
Dezember 2025
v3 API-Updates
  • Org-Gruppen-Limits-Endpunkt (23. Dez.): Endpunkte GET /v3beta1/enterprise/org-group-limits und PUT /v3beta1/enterprise/org-group-limits zum Verwalten von Organisationsgruppen-Konfigurationen hinzugefügt. Gruppen weisen Mengen von Organisations-IDs optionalen maximalen Agent-Compute-Unit-Limits pro Abrechnungszyklus zu. Erfordert die Berechtigung ManageOrganizations. Dieses Feature muss von Ihrem Account-Team aktiviert werden.
  • Session-Archiv-Endpunkt (11. Dez.): Endpunkt POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive zum Archivieren von Sessions hinzugefügt. Außerdem wurde der Query-Parameter archive zu DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id} (Session beenden) und das Feld is_archived zu Session-Antworten hinzugefügt.
  • Entfernung des Order-Parameters (11. Dez.): Breaking Change: Der Query-Parameter order wurde aus dem Sessions-Listenendpunkt (GET /v3beta1/organizations/{org_id}/sessions) entfernt. Clients dürfen order nicht mehr senden; verwenden Sie stattdessen Cursor-basierte Paginierung mit den Parametern first/after.
  • Searches-Router (10. Dez.): Enterprise- und organisationsweite Search-Endpunkte unter GET /v3beta1/enterprise/searches und GET /v3beta1/organizations/{org_id}/searches zum Auflisten von Suchvorgängen mit Paginierung und Filterung hinzugefügt.
  • Verbesserungen bei Audit-Logs (10. Dez.): data-Objekt sowie die Felder service_user_name und user_email zu Audit-Log-Antworten hinzugefügt. update_git_permission als neuen Action-Typ hinzugefügt.
  • Unterstützung für Advanced Sessions (8. Dez.): Unterstützung für erweiterte Session-Modi (analyze, create, improve, batch, manage) mit neuen Request-Parametern hinzugefügt: advanced_mode, child_playbook_id, session_links und bypass_approval. Session-Antworten enthalten jetzt die Felder child_session_ids, parent_session_id und is_advanced.
  • Session-Tags-Router (5. Dez.): CRUD-Endpunkte unter /v3/beta/enterprise/organizations/{org_id}/tags hinzugefügt, um zulässige Session-Tags pro Organisation zu verwalten. Wenn die Tag-Validierung aktiviert ist, erzwingen Session-Erstellung und Tag-Updates, dass nur Tags aus der zulässigen Liste verwendet werden.
  • Enterprise-Sessions-Endpunkt (5. Dez.): GET /v3/beta/enterprise/sessions hinzugefügt, um Sessions im gesamten Enterprise mit optionalem org_ids-Filter aufzulisten.
  • Git-Berechtigungsupdates (5. Dez.): prefix_path-Feld zum Abgleichen von Repositories anhand eines Pfadpräfixes hinzugefügt. PUT- und DELETE-Endpunkte für das Bulk-Ersetzen oder Leeren aller Berechtigungen für eine Organisation hinzugefügt.
  • Session-Impersonation (5. Dez.): Parameter create_as_user_id zum Session-Erstellungsendpunkt hinzugefügt, sodass Service-Benutzer Sessions im Namen anderer Benutzer erstellen können.
  • Änderung der Hypervisors-Antwort (5. Dez.): Die Antwort des Hypervisors-Endpunkts gibt jetzt utilization_percentage statt max_slots und available_slots zurück.
  • Notes- und Playbooks-Router (1. Dez.): Enterprise- und organisationsweite Notes- und Playbooks-Management-Endpunkte zur v3 API hinzugefügt. Notes-Endpunkte erfordern die Berechtigung ManageAccountKnowledge, Playbooks-Endpunkte erfordern die Berechtigung ManageAccountPlaybooks.
v2 API-Updates
  • Org-Gruppen-Limits-Endpunkt (23. Dez.): Endpunkte GET /v2/enterprise/org-group-limits und PUT /v2/enterprise/org-group-limits zum Verwalten von Organisationsgruppen-Konfigurationen hinzugefügt. Gruppen weisen Mengen von Organisations-IDs optionalen maximalen Agent-Compute-Unit-Limits pro Abrechnungszyklus zu. Der PUT-Endpunkt ersetzt die gesamte Konfiguration (Gruppen, die nicht in der Anfrage enthalten sind, werden gelöscht). Dieses Feature muss von Ihrem Account-Team aktiviert werden.
  • Self-Endpunkt (23. Dez.): Endpunkt GET /v2/enterprise/self hinzugefügt, der Informationen über den authentifizierten API key bereitstellt, einschließlich der Key-ID, der zugehörigen Benutzer-ID, der E-Mail-Adresse des Benutzers und der Organisations-ID.
  • Messages-Feld für Sessions (11. Dez.): Feld messages zur v2-Sessions-API-Antwort hinzugefügt, das alle Session-Nachrichten bereitstellt, ähnlich wie in der v1 API.
  • Verbesserungen am Response-Schema (11. Dez.): Eigene Response-Schemas für Audit-Logs-, Snapshot- und Playbook-Endpunkte hinzugefügt, einschließlich AuditLogsResponse, EnterpriseSnapshotResponse und EnterprisePlaybookResponse.
v1 API-Updates
  • Abkündigung der Audit-Logs (5. Dez.): Der Endpunkt /v1/audit-logs ist veraltet; verwenden Sie stattdessen die v2- oder v3-Audit-Logs-Endpunkte.
​
November 2025
v2 Enterprise API-Updates
  • Update des Pagination-Limits (21. Nov.): Maximales Pagination-limit von 1000 auf 200 Elemente pro Anfrage reduziert, um Performance und Zuverlässigkeit zu verbessern. Das Standard-limit bleibt 100. Diese Änderung betrifft NICHT die v1 External API.
  • Sessions-Router (16. Nov.): Umfassende Sessions-Management-Endpunkte zur v2 API für Enterprise-Administratoren hinzugefügt.
  • Snapshots-API-Endpunkt (3. Nov.): Endpunkt zum programmatischen Abrufen von Snapshot-Details hinzugefügt.
v1 API-Updates
  • Endpunkt zum Beenden von Sessions (31. Okt.): Endpunkt hinzugefügt, um laufende Sessions programmatisch zu beenden.
​
Oktober 2025
v3 API-Launch (Beta)
  • API v3 Launch (23. Okt.): v3 API mit vollständiger RBAC-Unterstützung, Service-Benutzer-Authentifizierungsmodell und umfassendem Audit-Logging für Aktionen von Service-Benutzern gestartet.
v2 Enterprise API-Updates
  • Endpunkt zur Snapshot-Erstellung (30. Okt.): Neuer v2 Enterprise Organizations API-Endpunkt für Enterprise-Admins, um Repositories programmatisch zu klonen und Snapshots mit benutzerdefinierten Setup-Schritten und Startbefehlen zu erstellen.
  • Verbesserungen an der Playbooks-API (14. Okt.): API zum Veröffentlichen von Enterprise-Playbooks mit verbesserter Funktionalität für das programmatische Playbook-Management hinzugefügt.
​
September 2025
v2 Enterprise API-Updates
  • Roles-Router (25. Sep.): Enterprise-Rollen-Router mit fünf API-Endpunkten für die programmatische Verwaltung von Rollen hinzugefügt.
v1 API-Updates
  • Playbooks-API (6. Sep.): Umfassende Playbooks-API-Endpunkte zu v1 hinzugefügt, um Playbooks programmatisch zu erstellen, zu aktualisieren, aufzulisten und zu löschen.
  • Secrets-Endpunkt (5. Sep.): Neuen POST /v1/secrets-Endpunkt zum Erstellen von Secrets über die API hinzugefügt.
​
März 2025
v2 Enterprise API-Launch
  • API v2 Launch (23. März): Enterprise API v2 für Enterprise-Administratoren mit Funktionen für Organisationsverwaltung, Nutzungsnachverfolgung und Mitgliederverwaltung gestartet.

​
2024

​
Oktober 2024
Einführung der v1-API (26. Okt.)
  • REST-API für die programmgesteuerte Erstellung und Verwaltung von Sitzungen eingeführt
  • Endpunkte für Erstellung, Überwachung und Verwaltung von Sitzungen
  • Unterstützung für das Hoch- und Herunterladen von Dateianhängen
  • Einfache Authentifizierung mit API keys
  • Unterstützung für idempotente Sitzungserstellung
  • Anwendungsfälle: automatische Reviews von Pull Requests (PRs), Behebung von Lint-Fehlern, Migrationen

​
API-Versionsrichtlinie

​
Abwärtskompatibilität

Wir bemühen uns, innerhalb einer Hauptversion die Abwärtskompatibilität sicherzustellen. Nicht abwärtskompatible Änderungen werden:
  1. mindestens 7 Tage im Voraus angekündigt
  2. in diesen Versionshinweisen dokumentiert
  3. gegebenenfalls durch Migrationsleitfäden ergänzt

​
Abkündigungsprozess

Wenn wir eine API-Funktion abkündigen:
  1. Ankündigung: Wir kündigen die Abkündigung mit einem Zeitplan an
  2. Abkündigungszeitraum: Die Funktion bleibt verfügbar, ist aber als veraltet gekennzeichnet
  3. Entfernung: Die Funktion wird nach Ablauf des Abkündigungszeitraums entfernt

​
Versionsunterstützung

  • v1: Veraltet — wird in Kürze zugunsten der Organization API (v3) eingestellt
  • v2: Veraltet — wird in Kürze zugunsten der Enterprise API (v3) eingestellt
  • v3: Allgemein verfügbar, für alle neuen Integrationen empfohlen

​
Migration zur aktuellen API

Schritt-für-Schritt-Anleitungen zur Migration von v1 oder v2 finden Sie im Migrationsleitfaden.

​
Support

Bei Fragen zu API-Änderungen oder für Unterstützung bei der Migration schreiben Sie eine E-Mail an support@cognition.ai.