Signaturprofil aktualisieren

Senden Sie nur die zu ändernden Felder; name und redirect_url lassen sich mit null entfernen. Bereits versendete Signaturanfragen bleiben unverändert. Erforderlich ist signature_profiles:write.

Beschreibung

Aktualisiert Absendername, Bezeichnung und Redirect-Ziel eines Profils.

Parameter

signature_profile_idpathPflicht

Öffentliche Signaturprofil-ID.

Beispiel: sgp_test_6f708192a3b4c5d6e7f8091a

Request-Body

Der Body wird als application/json übertragen. Verwenden Sie ausschließlich die dokumentierten Feldnamen.

Request-Felder

Feld	Typ	Angabe	Beschreibung
`display_name`	string	Optional	Neuer Absendername; darf nicht leer sein.
`name`	string\|null	Optional	`null` entfernt die interne Bezeichnung.
`redirect_url`	string\|null	Optional	`null` entfernt das Redirect-Ziel.
`remove_logo`	boolean	Optional	Entfernt ein hinterlegtes Logo.

{
  "display_name": "Autohaus Beispiel AG",
  "redirect_url": null
}

SchemaquelleOpenAPI 3.1 herunterladen

Responses

200

Aktualisiertes Signaturprofil.

422

display_name wurde geleert oder redirect_url ist keine http(s)-URL.

Response-Body

Content-Type: application/json. Die erfolgreiche Antwort enthält die nachfolgend beschriebenen Felder.

Response-Felder

Feld	Typ	Angabe	Beschreibung
`id`	string	Immer	Öffentliche Signaturprofil-ID.
`object`	string	Immer	Konstanter Wert `signature_profile`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` bei Produktivprofilen.
`name`	string	Optional	Interne Bezeichnung.
`display_name`	string	Immer	Absendername der Signaturanfrage.
`redirect_url`	string	Optional	Redirect-Ziel nach Abschluss der Signatur.
`has_logo`	boolean	Immer	Gibt an, ob ein Logo hinterlegt ist.
`logo_url`	string	Optional	Relativer Pfad der gespeicherten Logodatei.
`created_at`	date-time	Immer	Erstellungszeitpunkt.
`updated_at`	date-time	Immer	Letzter Änderungszeitpunkt.

{
  "id": "sgp_test_6f708192a3b4c5d6e7f8091a",
  "object": "signature_profile",
  "environment": "test",
  "livemode": false,
  "name": "Standardprofil",
  "display_name": "Autohaus Beispiel AG",
  "has_logo": false,
  "created_at": "2026-08-27T09:30:00+02:00",
  "updated_at": "2026-08-27T09:30:00+02:00"
}

Wirkung auf Anträge

Änderungen wirken auf künftige Signaturanfragen aller Anträge, die das Profil referenzieren. Eine bereits versendete Signaturanfrage behält Absender und Gestaltung des Versandzeitpunkts.

{ "id": "sgp_test_6f708192a3b4c5d6e7f8091a", "object": "signature_profile", "environment": "test", "livemode": false, "name": "Standardprofil", "display_name": "Autohaus Beispiel AG", "has_logo": false, "created_at": "2026-08-27T09:30:00+02:00", "updated_at": "2026-08-27T09:30:00+02:00" }