> ## Documentation Index > Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt > Use this file to discover all available pages before exploring further. # API-Versionshinweise > Verfolgen Sie Änderungen, neue Funktionen und Verbesserungen an Devin-APIs 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](/de/release-notes/overview).
## 2026
**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** * **Parameter für den Devin-Modus bei der 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-Modus). Wenn er weggelassen wird, verwendet die Sitzung den Standardmodus der Organisation. Für den Fast-Modus gelten dieselben Feature-Flag- und Enterprise-Agent-Preview-Einschränkungen wie für die Web-App. * **Endpunkt für Repositorys von Git-Verbindungen (18. Mai)**: `GET /v3/enterprise/git-providers/connections/{connection_id}/repositories` wurde hinzugefügt, um die für eine bestimmte Enterprise-Git-Verbindung verfügbaren Repositorys aufzulisten. Unterstützt die Filterung nach `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 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`. **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](/de/api-reference/getting-started/migration-guide).
## Support
Bei Fragen zu API-Änderungen oder für Unterstützung bei der Migration schreiben Sie eine E-Mail an [support@cognition.ai](mailto:support@cognition.ai).