REST API Änderungsprotokoll
Änderungen an der REST API v1 (/api/v1/).
2027
2027-10-27
TemplatePDF-Ressource — POST /api/v1/templatepdf/{pdfId}/preview/ ersetzt GET zum Erzeugen von PDF-Vorschauen mit vorausgefüllten Absenderfeldern. GET bleibt weiterhin unterstützt.
2026
2026-08-26
TemplatePDF-Ressource — Neuer Endpunkt: GET /api/v1/templatepdf/{pdfId}/preview/ — gibt eine PDF-Vorschau für das angegebene Template zurück.
2026-08-14
Element/Feld-Ressource — GET /api/v1/document/{id}/fields/ — hinzugefügter element_type Abfragefilterparameter. Siehe Get Document Fields.
2026-07-02
TemplatePDF-Ressource — Neuer Endpunkt: GET /api/v1/templatepdf/{id}/component-token/ — gibt ein Viewer-Komponententoken zurück zum Einbetten der PDF-Viewer-Komponente.
2026-07-01
Signer-Ressource — Neuer Endpunkt: GET /api/v1/signer/{id}/component-token/ — gibt ein Komponententoken zum Einbetten der Signaturkomponente zurück. Erfordert einen nicht-legacy API-Schlüssel und die Gruppe muss zur Komponentennutzung aktiviert sein.
2026-05-20
Dokument-Ressource — Signierer-Signierlinks, die in der API-Antwort zurückgegeben werden, werden jetzt als Links im Legacy-Format für die Rückwärtskompatibilität bei Batch-/Lobby-Signaturen erhalten.
2026-04-28
Authentifizierung — Ein neues API-Schlüsselschema ist jetzt verfügbar. Bestehende Schlüssel funktionieren weiterhin. Entwicklern wird dringend empfohlen, ein Upgrade durchzuführen — siehe developer.legalesign.com für Details.
2026-01-21
TemplatePDF-Ressource — DELETE /api/v1/templatepdf/{id}/delete/ — Löschung wurde für sichere Löschung aktualisiert. Gibt einen Fehler zurück, falls fehlgeschlagen (z.B. bei Aufbewahrungsrichtlinie mit sekundärer Genehmigung).
2026-01-06–07
Dokument-Ressource — Hinzugefügt wurde das boolesche Feld append_history bei Dokumentversand und Detailantwort. Wenn true, wird die Signierhistorie-Seite an das fertige PDF angehängt (entspricht dem bestehenden append_pdf-Verhalten).
Veraltet: sign_mouse, sign_type, sign_upload Felder in der Dokument-Ressource sind veraltet und werden in einer zukünftigen Version entfernt.
2025
2025-12-18–19
Dokument-Ressource — skip Parameter für Signierer beim Senden eines Dokuments hinzugefügt. Durch Setzen von skip: true in einer Signiererposition wird dieser Empfänger beim Versand ausgelassen. Zeugen, die einem übersprungenen Signierer folgen, werden ebenfalls automatisch übersprungen.
2025-10-30
Dokument-Ressource — Erstellung der Aufbewahrungsrichtlinie wurde vom API-Versand in den Signaturablauf verlagert.
2025-10-08
- Dokument-Ressource — Die
GET /api/v1/document/{id}/Antwort enthält jetzt einsigner_objectsArray zusätzlich zum bestehendensignersArray. Jedes Objekt enthält:firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Signer-Ressource —
roleFeld wurde der Signierer-Antwort hinzugefügt ("signer","approver"oder"witness").
2025-09-26
- Dokument-Ressource —
DELETE /api/v1/document/{id}/— optionaler Abfrageparameteremail=1hinzugefügt, um Benachrichtigungs-E-Mails bei Löschung zu senden. - TemplatePDF-Ressource —
hide_sender_fieldsParameter zum PDF-Bearbeitungsendpunkt hinzugefügt. - Element/Feld-Ressource —
pdftextundsignertextLookups akzeptieren nun UUID zusätzlich zum Labelnamen. - Signer-Ressource —
uuidFeld dem Signierer-Antwortobjekt hinzugefügt.
2025-09-04
Dokument-Ressource — Wenn beim Versand keine Nachricht angegeben wird, wird jetzt automatisch die Standardnachrichtvorlage der Gruppe verwendet.
2025-08-22
Dokument-Ressource — Beim Versand eines Dokuments wird die Quell-PDF jetzt vom Template in den Dokumentdatensatz kopiert.
2025-06-10
TemplatePDF-Ressource — Neuer Endpunkt: POST /api/v1/templatepdf/{id}/archive/ — archiviert eine Template-PDF.
2024
2024-10-17
Dokument-Ressource — Veralteter append_to Signierer-Parameter wurde entfernt. Dieser Parameter hatte keine Wirkung und wurde entfernt.
2024-08-21
- User-Ressource — API-erstellte Benutzer erhalten nun ein permanentes Passwort (kein temporäres, das zurückgesetzt werden muss).
- Dokument-Ressource — Admin-Element-Signiererwerte werden für Signiererindex 0 korrekt behandelt.
2024-08-20
- Dokument-Ressource —
convert_sender_to_signerundstrict_fieldsParameter akzeptieren jetzttrue/"true"/1(zuvor nur booleanTrue). - Signer/Element-Ressource —
signerFeld ist jetzt nullable;element_type: "admin"Elemente defaulten auf Signierer0. - Rollen — API-Rollen werden nach der Dokumenterstellung mit dem Console-Sync synchronisiert.
- Fehlermeldungen — Verbesserter Fehler, wenn Benutzer keine Organisationsverknüpfung hat.
2024-08-19
Gruppen-(Tab)-Ressource — POST /api/v1/group/ — name ist jetzt das einzige erforderliche Feld. xframe_allow ist jetzt ein optionaler Parameter.
2024-07-16
Dokument-Ressource — cc Parameter akzeptiert jetzt den Wert "default", um die Standard-CC-E-Mail-Liste der Gruppe zu verwenden.
2024-06-14
Dokument-Ressource — Hinzugefügt wurden die Felder pdf_password und pdf_password_type zur Dokumentdetailantwort.
2024-02-20
TemplatePDF-Ressource — GET /api/v1/templatepdf/{id}/ (PDF-Download) — returnAsJson Abfrageparameter hinzugefügt, um das PDF als base64-kodierte JSON-Antwort statt als Dateidownload zurückzugeben.
2024-02-09
TemplatePDF-Ressource — Tippfehler im returnAsJson Antwortfeld behoben: documet_uri → document_uri.
2024-01-26
TemplatePDF-Ressource — POST /api/v1/templatepdf/ — optionaler returnAsJson Abfrageparameter hinzugefügt. Wenn gesetzt, enthält der Antwortkörper { resource: { uid, status_uri, document_uri } } anstatt eines leeren 201.
2024-01-21
Dokument-Ressource — Leistungsverbesserung: GET /api/v1/document/ aktualisiert (schnellere Zählabfrage).
2023
2023-09-27
Dokument-Ressource — GET /api/v1/document/ — zwei neue Abfragefilterparameter hinzugefügt:
created_gt— filtert Dokumente, die nach einem bestimmten Datum/Zeit erstellt wurden (ISO 8601)modified_gt— filtert Dokumente, die nach einem bestimmten Datum/Zeit geändert wurden (ISO 8601)
Paginierungs-URLs next/previous enthalten jetzt korrekt alle aktiven Filterparameter.
2023-08-08
Dokument-Ressource — GET /api/v1/document/ — Filterparameter sentUserId hinzugefügt.
2023-07-07
User-Ressource — Admin-Benutzer können jetzt Sub-User via API erstellen.
2023-05-31
Dokument-Ressource — Zeugen werden nicht mehr in der Standardliste der Erinnerungsempfänger berücksichtigt.
2023-04-17
- Signer-Ressource — Feld
rejection_reasonzur Signierer-Antwort hinzugefügt. - Benennung — Konsistenzkorrekturen bei Feldnamen in der API.
2023-03-02
Webhooks — Maximale Länge des Feldes callback_url von 200 auf 500 Zeichen erweitert.
2023-01-17
Dokument-Ressource — Felder tag2 und tag3 hinzugefügt (zusätzlich zu vorhandenen tag/tag1) beim Dokumentversand und der Antwort.
2022
2022-11-14–15
Dokument-Ressource — Maximale Anzahl zulässiger Felder pro Dokument erhöht.
2022-11-02–03
Webhooks — Neue Webhook-Ereignistypen hinzugefügt. usercallback Items aktualisiert.
2022-09-09
Dokument-Ressource — Anforderungsparameter message_template hinzugefügt, um beim Versand eine Nachrichtenvorlage anzugeben.
2022-05-12
Element/Feld-Ressource — Feld no_pdf hinzugefügt: Option, ein Feld so zu markieren, dass es im finalen PDF nicht gerendert wird.
2022-04-20
- Dokument-Ressource —
roleist beim Signierer-Dictionary beim Versenden eines Dokuments mit TemplatePDF nicht mehr erforderlich. - Fehlermeldungen — Verbesserte Fehlerantwortnachrichten über die API hinweg.
2022-04-06
Element/Feld-Ressource — Validierungstyp regex (Typ 93) für Feldwerte hinzugefügt.
2022-02-24
Element/Feld-Ressource — Feld label_extra hinzugefügt.
2022-02-22
TemplatePDF-Ressource — Option force_download beim PDF-Entwurfabruf hinzugefügt.
2022-02-17
Dokument-Ressource — Unterstützung für reviewers beim Versenden eines Dokuments hinzugefügt.
2022-02-15
Dokument-Ressource — Unterstützung für das Feld honorifics beim Dokument-POST hinzugefügt.
2021
2021-11-30
Dokument-Ressource — Neuer Endpunkt: GET /api/v1/document/{id}/auditlog/ — gibt das Auditlog für ein Dokument zurück.
2021-10-31
Dokument-Ressource — Die Antwort von GET /api/v1/document/ enthält jetzt ein Feld tag.
2021-10-30
Dokument-Ressource — Die Antwort von GET /api/v1/document/ enthält jetzt ein Feld location.
2021-10-28
Dokument-Ressource — Unterstützung für Feldvalidierung beim Versenden von Dokumenten via API hinzugefügt.
2021-10-27
Dokument-Ressource — Neuer Endpunkt: GET /api/v1/document/{id}/fields/ — gibt Felddaten für ein Dokument zurück.
2021-10-25
Dokument-Ressource — Unterstützung für bundle hinzugefügt. Parameter convert_sender_to_signer beim Dokumentversand hinzugefügt.
2021-08-17
TemplatePDF-Ressource — Feld archive_upon_send zur Liste der Felder der TemplatePDF-Ressource hinzugefügt.