Skip to main content
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

​
v3 API-Deprecations
  • Schedules-Endpunkte veraltet (10. Sept.): Die Endpunkte für Zeitpläne von Organisationen (GET/POST /v3/organizations/{org_id}/schedules sowie GET/PATCH/DELETE /v3/organizations/{org_id}/schedules/{schedule_id}) sind veraltet und werden durch Automatisierungen ersetzt. Erstellen Sie geplante Arbeiten als Automatisierung mit einem schedule:recurring-Trigger (eine iCalendar-RRULE, ausgewertet in UTC) und einer start_session-Aktion. Ab dem 24. September 2026 gibt POST /v3/organizations/{org_id}/schedules für Organisationen, die zu Automatisierungen migriert wurden, 403 zurück; die Endpunkte zum Lesen, Aktualisieren und Löschen funktionieren für bestehende Zeitpläne weiterhin. Organisationen, die noch migriert werden, können bis zum Abschluss ihrer Migration weiterhin Zeitpläne erstellen. Bestehende Zeitpläne werden in einer späteren Phase in Automatisierungen umgewandelt; die GET-Antwort eines umgewandelten Zeitplans verweist auf die ersetzende Automatisierung. Die Terraform-Ressource devin_schedule ist veraltet und wird durch devin_automation ersetzt.
​
v2 API-Updatesv3 API-Updates
  • Neue Endpunkte für Automatisierungen: Endpunkte für Automatisierungen im Org-Geltungsbereich wurden zur v3 API hinzugefügt:
    • GET /v3/organizations/{org_id}/automations — Automatisierungen auflisten (Filter für Suche, Ersteller, aktiviert, Ereignistyp, Agent-Typ und Metadaten)
    • POST /v3/organizations/{org_id}/automations — eine Automatisierung erstellen
    • GET /v3/organizations/{org_id}/automations/{automation_id} — eine Automatisierung abrufen
    • PATCH /v3/organizations/{org_id}/automations/{automation_id} — eine Automatisierung aktualisieren (elementweise Merge-Semantik)
    • DELETE /v3/organizations/{org_id}/automations/{automation_id} — eine Automatisierung als gelöscht markieren
    • GET /v3/organizations/{org_id}/automations/schemas — unterstützte Trigger-Ereignisschemas, Bedingungsoperatoren und Antwortverben
    • GET /v3/organizations/{org_id}/automations/templates — integrierte Vorlagen für Automatisierungen
    Lesevorgänge erfordern ViewOrgAutomations, Schreibvorgänge erfordern ManageOrgAutomations. Automatisierungen müssen für die Organisation aktiviert sein.
​
v3 API-Updates
  • Endpunkt zum Hinzufügen von IPs zur IP-Zugriffsliste: POST /v3/enterprise/ip-access-list wurde hinzugefügt, um IP-Bereiche an die Enterprise-IP-Zugriffsliste anzuhängen, ohne vorhandene Einträge zu ersetzen. Im Gegensatz zu PUT /v3/enterprise/ip-access-list (das die gesamte Liste ersetzt) führt dieser Endpunkt die bereitgestellten Bereiche mit der aktuellen Liste zusammen. Erfordert die Berechtigung ManageEnterpriseSettings.
  • Endpunkt zum Aktualisieren von Git-Berechtigungen: PATCH /v3/enterprise/organizations/{org_id}/git-providers/permissions/{git_permission_id} wurde hinzugefügt, um eine vorhandene Git-Berechtigung zu aktualisieren (z. B. durch Umschalten von read_only). Erfordert die Berechtigung ManageGitIntegrations.
  • Endpunkte zum Lesen von Membern im Org-Geltungsbereich (Beta): GET /v3beta1/organizations/{org_id}/members/users, GET /v3beta1/organizations/{org_id}/members/users/{user_id} und GET /v3beta1/organizations/{org_id}/members/idp-users wurden hinzugefügt, um Member einer Organization mithilfe eines Service-Benutzers im Org-Geltungsbereich aufzulisten und abzurufen. Unterstützt cursorbasierte Paginierung (after, first) und Filterung nach email. Erfordert die Berechtigung ViewOrgMembership auf Organisationsebene.
  • Devin-Lite-Modus für die Sitzungserstellung: Der Parameter devin_mode in POST /v3/organizations/{org_id}/sessions akzeptiert jetzt zusätzlich zu "normal" und "fast" auch "lite" (Devin Lite). Für Fast und Lite gelten dieselben Feature-Flag- und Enterprise-Agent-Preview-Einschränkungen wie für die Web-App.
​
v3 API-Updates
  • Devin-Modus-Parameter für die Sitzungserstellung (21. Mai): Der Parameter devin_mode wurde zu POST /v3/organizations/{org_id}/sessions hinzugefügt. Akzeptiert "normal" (Standard-Agent-Modus) oder "fast" (Fast Mode). Wird er weggelassen, verwendet die Sitzung den Standardmodus der Organisation. Für Fast Mode gelten dieselben Feature-Flag- und Enterprise-Agent-Preview-Einschränkungen wie in der Web-App.
  • Endpunkt für Repositorys einer Git-Verbindung (18. Mai): GET /v3/enterprise/git-providers/connections/{connection_id}/repositories zum Auflisten der Repositorys, die einer bestimmten Enterprise-Git-Verbindung zur Verfügung stehen, wurde hinzugefügt. Unterstützt Filterung über filter_name sowie cursorbasierte Paginierung (after, first). Erfordert die Berechtigung ManageGitIntegrations.
​
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 zum Auslösen der bedarfsgesteuerten Generierung von Session Insights hinzugefügt. Gibt { "status": "started" } zurück, wenn die Generierung beginnt, oder { "status": "already_exists" }, wenn Insights bereits generiert wurden oder gerade generiert werden. Fragen Sie den vorhandenen GET-Insights-Endpunkt regelmäßig ab, um die Ergebnisse abzurufen. Erfordert die Berechtigung ManageOrgSessions.
​
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:
    • Sitzungen (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, Sitzungen, Suchen, aktive Nutzer, Nutzung) – Enterprise-Kontext
    • Organizations, Users, Members, Roles, IDP-Gruppen – Enterprise-Kontext
    • Git-Verbindungen & Berechtigungen – Enterprise-Kontext
    • Hypervisors, Queues, IP-Zugriffslisten, 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 cursorbasierte 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 Sitzungen (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.
​
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

​
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.
  • Sitzungs-Archiv-Endpunkt (11. Dez.): Endpunkt POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive zum Archivieren von Sitzungen hinzugefügt. Außerdem wurde der Query-Parameter archive zu DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id} (Sitzung beenden) und das Feld is_archived zu Sitzungs-Antworten hinzugefügt.
  • Entfernung des Order-Parameters (11. Dez.): Breaking Change: Der Query-Parameter order wurde aus dem Sitzungs-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 Sitzungen (8. Dez.): Neue Request-Parameter für erweiterte Sitzungs-Workflows hinzugefügt: child_playbook_id, session_links und bypass_approval. Sitzungs-Antworten enthalten jetzt die Felder child_session_ids, parent_session_id und is_advanced.
  • Sitzungs-Tags-Router (5. Dez.): CRUD-Endpunkte unter /v3/beta/enterprise/organizations/{org_id}/tags hinzugefügt, um zulässige Sitzungs-Tags pro Organisation zu verwalten. Wenn die Tag-Validierung aktiviert ist, erzwingen Sitzungs-Erstellung und Tag-Updates, dass nur Tags aus der zulässigen Liste verwendet werden.
  • Enterprise-Sitzungen-Endpunkt (5. Dez.): GET /v3/beta/enterprise/sessions hinzugefügt, um Sitzungen 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.
  • Sitzungs-Impersonation (5. Dez.): Parameter create_as_user_id zum Sitzungs-Erstellungsendpunkt hinzugefügt, sodass Service-Nutzer Sitzungen im Namen anderer Nutzer 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 Nutzer-ID, der E-Mail-Adresse des Nutzers und der Organisations-ID.
  • Messages-Feld für Sitzungen (11. Dez.): Feld messages zur v2-Sitzungs-API-Antwort hinzugefügt, das alle Sitzungs-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.
​
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.
​
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.
​
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.
​
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

​
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.