Zum Hauptinhalt springen

Release Notes der Sally API

Diese Release Notes listen jede Änderung an der Sally Public API v1.0, neueste zuerst. Jeder Eintrag ist als neu, geändert oder brechend markiert und sagt, was du in deiner Anbindung tun musst.

Brechend ist eine Änderung, die einen bestehenden Client brechen kann, etwa weil ein Feld wegfällt, ein Typ sich ändert oder das Versions-Präfix wechselt.

Hinweis

Version 1.0 ist noch nicht eingefroren, brechende Änderungen können hier also weiterhin auftauchen. Sobald sie eingefroren ist, schließt diese Liste und die nächste Version beginnt ihre eigene. Siehe Versionierung.

Anzeigen

20. Oktober 2026​

  • neu GET …/appointments/{appointmentId}/agenda liefert die geplante Agenda eines Termins, mit appointmentAgendaItemId, title, note und sortOrder je Punkt. Die Agenda gehört zum Online-Meeting, deshalb liefert der Termin jedes Teilnehmers dieselbe.
  • neu Zusammenfassungen tragen agendaResults, die ausgewertete Agenda mit einem Eintrag pro Punkt (agendaCoverage als discussed, touched oder notDiscussed, dazu summary, content und timeStamps), sowie isAgendaEvaluationOutdated. Für bestehende Anbindungen ändert sich nichts. Willst du die Agenda anzeigen, löse appointmentAgendaItemId über den Agenda-Endpunkt auf.
  • neu Meetingtemplates tragen isSmallTalkInclusionEnabled und isPrivateTopicsInclusionEnabled, ihre Abschnitte smallTalk und privateTopics (inherit, include oder exclude). Wertest du Templates aus, lies inherit als den Wert des Templates.

7. Oktober 2026​

  • geändert POST …/summaries/search sucht wortweise: Die Wörter des Begriffs werden ODER-verknüpft, Wörter ab vier Zeichen treffen auch innerhalb längerer Wörter und in gebeugten Formen, und Umlaut-Schreibweisen sind gleichwertig. In Tabellenabschnitten werden zusätzlich Personennamen, E-Mail-Adressen und Spaltennamen durchsucht, und snippet zeigt jetzt den Ausschnitt rund um den ersten Treffer. Ein Begriff mit mehreren Wörtern kann mehr Treffer liefern als bisher. Schick deshalb Stichwörter und prüfe Filter, die sich auf exakte Teilstrings verlassen haben. Siehe Zusammenfassungen abrufen.

6. Oktober 2026​

  • neu GET …/summaries/{recordingSummaryId}/document liefert eine Zusammenfassung als fertige Datei (pdf, docx, odt, txt oder md), dieselbe, die die Weboberfläche herunterlädt. Übergib format, optional languageCode. Siehe Zusammenfassungen abrufen.
  • neu GET …/recordings/{recordingId}/transcription/document liefert ein Transkript als fertige Datei (pdf, docx, xlsx, txt, md) oder als Untertitel (vtt, srt). Siehe Transkript abrufen.
  • neu Neue Fehlercodes für die beiden Datei-Endpunkte: UNKNOWN_DOCUMENT_FORMAT, UNKNOWN_LANGUAGE_CODE, SUMMARY_DOWNLOAD_PREVENTED, TRANSCRIPT_DOWNLOAD_PREVENTED, SUMMARY_HAS_NO_CONTENT und TRANSCRIPT_NOT_AVAILABLE. Diese beiden Endpunkte unterstützen ?fields= nicht. Siehe Fehler.
  • neu GET …/task-categories listet die Aufgabenkategorien auf, und Aufgaben tragen taskCategoryId, das du auch beim Anlegen und Ändern einer Aufgabe setzen kannst.
  • neu Beim Abschließen eines Uploads nimmt der Endpunkt choice (copy oder replace) entgegen, wenn der Termin schon eine Aufnahme hat. Ohne diese Angabe schlägt ein solcher Upload mit 409 und RECORDING_EXISTS_CHOICE_REQUIRED fehl. Sende choice, wenn du zu Terminen hochlädst, die schon eine Aufnahme haben können.
  • geändert sectionType hat die neuen Werte table, appointment und email, dazu die neuen Felder tableVariant, tableData, followUpMeetingStartTime, followUpMeetingEndTime, followUpMeetingParticipants und emailRecipients. Abschnitte von Meetingtemplates tragen tableVariant und tableColumns. Wenn dein Client sectionType gegen eine feste Liste prüft, lass die neuen Werte zu oder greif auf content zurück, das von jedem Abschnitt eine Markdown-Fassung enthält.
  • geändert Die Suche nach Zusammenfassungen findet auch Text in den Zellen strukturierter Tabellen.
  • geändert GET …/meetingtemplates liefert jetzt auch die persönlichen und die Team-Templates des Aufrufers, nicht nur die des gesamten Unternehmenskontos.
  • geändert Die Aufgabenfilter sind genauer beschrieben: my… umfasst jede Aufgabe, für die der Aufrufer verantwortlich ist oder die ihm gehört, myForwarded und allForwarded listen nur, was der Aufrufer an jemand anderen übergeben hat. Prüf, ob dein Filter weiterhin liefert, was du erwartest.

23. September 2026​

  • neu Jeder Endpunkt nimmt ?fields= entgegen und liefert dann nur die genannten Felder. Ohne Angabe bleibt alles wie bisher. Siehe Feldauswahl.

22. September 2026​

  • brechend Die Version wird jetzt als /v1.0 angesprochen. Das gleitende Präfix /v1 entfällt. Stell das Präfix aller Pfade in deinem Client um.
  • brechend GET /health trägt kein Versions-Präfix mehr und antwortet unter /health. Pass deinen Monitor an.
  • neu Aufnahmen tragen isTranscriptionCompleted, isTranscriptionSucceeded und transcriptionCompletionReason. Damit lässt sich ein beendeter Lauf von einem brauchbaren Transkript unterscheiden.
  • neu Zusammenfassungen tragen isSummarizationCompleted, isSummarizationSucceeded und summarizationCompletionReason.
  • geändert Webhooks: Das Ereignis manual lässt sich jetzt auswählen. Die zwei älteren Ereignisse bleiben lesbar, lassen sich aber nicht mehr setzen.
  • geändert Die Bearer-Anforderung steht an jeder dokumentierten Operation, damit erzeugte Clients das Token mitschicken.

10. September 2026​

  • geändert Das Anlegen von Webhooks nutzt jetzt dieselbe Skala wie der Rest des Systems.

8. September 2026​

  • neu Eine Aufnahme lässt sich mit POST …/recordings/from-url per URL übernehmen. Siehe Aufnahme hochladen.

7. September 2026​

  • neu Termine liefern den Beschreibungstext, das Ganztags-Kennzeichen und die iCal-Id.
  • brechend Tags werden nur noch per Id zugewiesen. Die Freitext-Form names entfällt. Leg fehlende Tags zuerst an und weise sie mit tagIds zu.

29. August 2026​

  • neu GET …/tags/colors listet die verfügbaren Tag-Farben.
  • neu Eine einzelne Zusammenfassung lässt sich per Id abrufen.
  • neu Die Abschnitte eines Meetingtemplates haben einen eigenen Endpunkt.
  • brechend languageCode ist der volle IETF-Sprach-Tag (de-DE), nicht mehr der Zwei-Buchstaben-Code. Pass Vergleiche und Zuordnungen in deinem Client an.
  • brechend Custom Insights sind aus den Antworten der Zusammenfassungen und aus der Suche entfernt.
  • geändert Vokabeleinträge liefern das immer wahre Feld isActive nicht mehr.