Datei-Upload

Dateien über den separaten Upload-Endpunkt hochladen.

Dateien werden über einen separaten Upload-Endpunkt hochgeladen. Das Formular macht das automatisch – dieser Endpunkt kann aber auch direkt genutzt werden.

Endpunkt

POST /api/embed/upload
Content-Type: multipart/form-data

Form-Felder

Feld	Pflicht	Beschreibung
`sessionId`	Ja*	Session-ID (alternativ: `token` + `orgId`)
`orgId`	Ja	Organisations-UUID
`templateIdentifier`	Bedingt	Vorlage-ID (nur bei Token-Auth nötig)
`fieldKey`	Ja	Schlüssel des Datei-Feldes, z.B. `"anhang"`
`files`	Ja	Die Datei(en)

Limits

Max. 20 Dateien pro Upload
Max. 50 MB pro Datei

Antwort (200)

{
  "ok": true,
  "files": [
    {
      "name": "foto.jpg",
      "path": "org-id/anoXYZ/anhang/abc.jpg",
      "url": "https://...signedUrl...",
      "size": 245000,
      "type": "image/jpeg"
    }
  ]
}

Feld	Beschreibung
`name`	Originaler Dateiname
`path`	Speicherpfad im Storage
`url`	Signierte URL (1 Jahr gültig)
`size`	Dateigröße in Bytes
`type`	MIME-Type

Die zurückgegebenen Dateiobjekte werden als Wert in values gespeichert. Beim Submit enthält das file-Feld ein Array dieser Objekte.

Zwischenspeicherung Webhooks