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

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.