Files-API

Datei-Uploads auflisten und verwalten, die mit deinen Formularen verknüpft sind.

Mit der Files-API listest du die Datei-Uploads deines Kontos auf. Dateien entstehen, wenn Teilnehmer Datei-Upload-Fragen übermitteln oder wenn du im Formular-Builder Medien (Bilder, Videos) hochlädst.

Alle Antwort-Bodys verwenden Feldnamen in snake_case.

Endpoints

GET/api/v1/files

Dateien auflisten

GET/api/v1/files

Gibt eine paginierte Liste der Datei-Uploads des authentifizierten Nutzers zurück. Enthält sowohl Builder-Medien-Uploads (dem Nutzer gehörend) als auch Teilnehmer-Datei-Uploads (verknüpft mit den Formularen des Nutzers).

Query-Parameter

pageinteger

Seitennummer (Standard: 1)

per_pageinteger

Ergebnisse pro Seite (Standard: 50)

Antwortfelder

idstring

Eindeutige Datei-Upload-ID

blob_urlstring

Öffentliche URL für den Zugriff auf die Datei

original_namestring

Ursprünglicher Dateiname, wie vom Nutzer hochgeladen

uuid_namestring

UUID-basierter Dateiname im Blob-Speicher

sizeinteger

Dateigröße in Bytes

content_typestring

MIME-Typ der Datei (z. B. "image/png", "application/pdf")

form_idstring or null

Das Formular, mit dem diese Datei verknüpft ist (bei Teilnehmer-Uploads)

user_idstring or null

Der Nutzer, der diese Datei hochgeladen hat (bei Builder-Medien). null bei Teilnehmer-Uploads.

created_atstring

ISO-8601-Zeitstempel des Uploads

Dateikategorien

Dateien fallen je nach den Feldern user_id und form_id in zwei Kategorien:

Kategorie	`user_id`	`form_id`	Beschreibung
Builder-Medien	Gesetzt	null oder gesetzt	Bilder, Videos oder Dokumente, die du im Formular-Builder hochgeladen hast (z. B. Fragebilder, Logos)
Teilnehmer-Uploads	null	Gesetzt	Dateien, die Teilnehmer über Datei-Upload-Fragen übermittelt haben

Speicherlimits

Der Dateispeicher wird pro Konto erfasst. Deine aktuelle Nutzung kannst du über die User-API prüfen. Speicherlimits variieren je nach Plan-Stufe. Wird ein Formular gelöscht, werden die zugehörigen Teilnehmer-Datei-Uploads bereinigt und der Speicher asynchron zurückgewonnen.

Antwort

json

{
  "files": [
    {
      "id": "668a1b2c3d4e5f6a7b8c9d01",
      "blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/a1b2c3d4.pdf",
      "original_name": "project-proposal.pdf",
      "uuid_name": "a1b2c3d4.pdf",
      "size": 245760,
      "content_type": "application/pdf",
      "form_id": "665a1b2c3d4e5f6a7b8c9d0e",
      "user_id": null,
      "created_at": "2026-02-25T14:30:00.000Z"
    },
    {
      "id": "668a1b2c3d4e5f6a7b8c9d02",
      "blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/e5f6a7b8.png",
      "original_name": "hero-banner.png",
      "uuid_name": "e5f6a7b8.png",
      "size": 1048576,
      "content_type": "image/png",
      "form_id": null,
      "user_id": "665a0a1b2c3d4e5f6a7b8c9d",
      "created_at": "2026-02-20T10:15:00.000Z"
    }
  ],
  "total": 38,
  "page": 1,
  "per_page": 50
}

Codebeispiele

bash

curl -X GET "https://api.nueform.io/api/v1/files?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Fehlerantworten

Standard-Fehlerantworten, die dieser Endpunkt zurückgibt.

Fehlercodes

401Unauthorized

Fehlender oder ungültiger API-Schlüssel

500Server Error

Interner Serverfehler

Fehlerbeispiel

json

{
  "error": "Unauthorized"
}

Zuletzt aktualisiert: 20. Juli 2026