Changelog

Unsere Versionsrichtlinie: Neue Felder und neue Endpoints sind additiv und zählen unter dem /api/v1/-Präfix nie als Breaking Change — das Entfernen oder Ändern der Bedeutung eines bestehenden Felds wäre ein v2. Das heißt, du kannst jeden Eintrag unten als „das ist neu" betrachten, nicht als „das könnte deine Integration brechen".

2026-09-26

• format_requirement bei Ad-hoc-fields wird jetzt angewendet. Wenn POST /batches/{batch_name}/process mit fields (ohne template_id) aufgerufen wurde, wurde das format_requirement jedes Felds vor der Extraktion verworfen, sodass die Werte so zurückkamen, wie sie auf dem Dokument gedruckt waren. Sie erreichen jetzt das Modell und haben Vorrang vor jeder Vorlage, mit der die Documents hochgeladen wurden. Gespeicherte Vorlagen waren nicht betroffen. Siehe die Batches Referenz.
• POST /documents lehnt einen batch_name mit mehr als 50 Zeichen mit 400 invalid_parameter ab. Solche Namen schlugen zuvor mit einem 500 oder mit einer irreführenden Meldung „Failed to render PDF." bei PDF-Uploads fehl.

2026-09-14

• PUT /templates/{id}/settings hinzugefügt. Legt das globale Format Requirement und die Multi-Page Merge-Konfiguration einer Vorlage fest (ob mehrere hochgeladene Seiten, die zum selben Datensatz gehören — ein mehrseitiger Mietvertrag, ein getackerter Belegstapel — zu einer einzigen Ausgabezeile zusammengeführt werden sollen). Das Template-Objekt, das von allen Templates-Endpunkten zurückgegeben wird, enthält jetzt außerdem global_format_requirement und alle merge_*-Felder. Siehe die Templates & Fields-Referenz.
• GET /batches/{batch_name}/results unterstützt jetzt ?merge=true. Wendet die Multi-Page Merge-Konfiguration der aufgelösten Vorlage des Batches an, falls eine vorhanden ist — Dokumente, die zu einem zusammengeführten Datensatz gehören, tragen ein neues source_document_ids-Feld neben dem üblichen document_id, und die Antwort erhält ein Top-Level-Feld merge_active. Der Standardwert bleibt false: Dieser Endpunkt existierte bereits vor Multi-Page Merge, daher sehen bestehende Integrationen weiterhin einen Eintrag pro hochgeladenem Dokument, es sei denn, sie aktivieren die Option explizit. Nicht kombinierbar mit include=bbox. GET /batches/{batch_name}/export hat Merge vor dieser Änderung bereits bedingungslos angewendet und ist davon nicht betroffen. Siehe die Batches-Referenz.
• Model Tier wird jetzt korrekt in der Credit-Abrechnung für POST /batches/{batch_name}/process berücksichtigt. Ein Account mit Advanced oder Premium (3x/6x der Standard-Credit-Kosten pro Dokument) erhält diesen Satz jetzt konsistent sowohl beim Abzug zum Verarbeitungszeitpunkt als auch bei einer späteren Rückerstattung für ein storniertes oder fehlgeschlagenes Dokument — zuvor konnte ein Dokument, dessen ImageUpload-Zeile zum Zeitpunkt der Rückerstattung bereits entfernt worden war, fälschlicherweise zum Standard-Satz erstattet werden, was einen Nicht-Standard-Account untererstattete. GET /account/usage-Einträge für einen Nicht-Standard-Abzug bzw. eine Nicht-Standard-Rückerstattung tragen jetzt eine tier-suffigierte action (deduction_advanced, deduction_premium) statt des nackten Namens. Model Tier selbst ist nicht neu, und es gibt weiterhin keine Möglichkeit auf Anfrageebene, es auszuwählen oder zu überschreiben — dieser Eintrag betrifft die jetzt korrekte und sichtbare Abrechnung, nicht eine neue Funktion. Siehe den Account Settings & API Behavior-Leitfaden und die Account-Referenz.

2026-08-04

• GET /events für Polling-Integrationen hinzugefügt. Der Event-Feed liefert batch.completed, document.completed und document.failed Events neueste zuerst, mit stabilen Event-IDs für Zapier-artige Deduplizierung. Siehe Webhooks Referenz.

2026-07-22

• POST /templates erzwingt jetzt ein Limit von 30 Vorlagen pro Account. Sobald du das Limit erreicht hast, gibt das Erstellen einer weiteren Vorlage (von Grund auf oder aus einer Vorlage) 400 template_limit_reached zurück — lösche zuerst eine bestehende Vorlage. Dieses Limit wurde zuvor nicht durchgesetzt. Siehe die Templates & Fields Referenz.

2026-07-21

• POST /documents akzeptiert jetzt Word (.docx) und Textdateien (.txt), nicht nur Bilder und PDFs. Beide werden serverseitig in ein PDF konvertiert und folgen dann exakt demselben Seiten-Split wie ein nativer PDF-Upload — ein mehrseitiges .docx erzeugt ein Dokument pro Seite, genau wie beim aktuellen PDF-Verhalten. Das alte binäre .doc-Format wird nicht unterstützt; speichere zuerst als .docx. Siehe die Documents Referenz.
• Seitenlimit pro Upload von 30 auf 50 Seiten erhöht. Gilt sowohl für native PDF-Uploads als auch für .docx/.txt-Dateien, die serverseitig konvertiert werden. Siehe die Documents Referenz.
• GET /documents/{document_id}/image unterstützt jetzt ?size=thumb für eine kleinere, vorab generierte Version des Seitenbilds — schneller in einer Listen-/Rasteransicht zu laden als das Bild in voller Auflösung. Fällt auf das volle Bild zurück, wenn für dieses Dokument kein Thumbnail generiert wurde (niemals ein Fehler). Siehe die Documents Referenz.

2026-07-20

• Batch-Webhooks aktivieren sich jetzt automatisch wieder, wenn du einen Batch erneut verarbeitest. Wenn du weitere Dokumente in einen Batch hochlädst, der dich bereits einmal benachrichtigt hat, und process erneut aufrufst, wirst du jetzt wieder benachrichtigt, sobald die neue Welle fertig ist – kein erneutes PUT des Webhooks nötig. Siehe den Webhooks-Leitfaden. Wenn deine Integration den Webhook bisher vor jeder Welle als Workaround neu registriert hat, kannst du das gefahrlos einstellen – dieser Aufruf hat nie wirklich etwas reaktiviert.
• Bbox-Annotationsaufträge liefern jetzt ein Webhook-Event. Ein document.bbox_completed-Event wird beim Batch-Webhook des Dokuments ausgelöst, wenn ein Bbox-Auftrag einen Endstatus erreicht – zuvor erzeugten Bbox-Abschlüsse keinerlei Benachrichtigung, unabhängig von der Registrierung. Siehe den Webhooks-Leitfaden.
• remaining_batch_capacity zu POST /documents-Antworten hinzugefügt. Zeigt dir, wie viele weitere Dokumente dieser Batch aufnehmen kann, bevor die maximale Batch-Größe deines Plans erreicht ist – ohne separaten Aufruf von GET /account.
• document.bbox_completed-Zustellungen werden jetzt atomar beansprucht, genau wie batch.completed. Ein Bbox-Auftrag, dessen Zeilengruppen innerhalb von Augenblicken auf verschiedenen Threads abschließen, erzeugte früher manchmal zwei getrennte Zustellungen für einen logisch einzigen Abschluss – das solltest du nicht mehr sehen. Wenn deine Integration diese Events über data.group_batch_id als Workaround dedupliziert, schadet es nicht, das weiterhin zu tun.

2026-07-16

• v1 API gestartet. Öffentliche Veröffentlichung von /api/v1/ mit Documents, Batches, Templates & Fields, Webhooks und Account-Ressourcen für den table-Verarbeitungsmodus (strukturierte Feldextraktion). Siehe API-Übersicht für den Einstieg.