aYOUne

ay upload

ay upload

Lädt eine lokale Datei in die Documents-Collection des aktiven Customers hoch. Pflicht ist eine Target-Entity, an die das Document gehängt wird.

Syntax

ay upload <file> --target <id> [flags]

Flags

Flag Default Zweck
-s, --state <right> cms.downloads.edit Upload-Kontext / Access-Right
-t, --target <id> — (Pflicht) ObjectId der Ziel-Entity

Beispiele

# Software-Installer hochladen
ay upload ./installer.exe \
  --state cms.downloads.edit \
  --target 698d574...

# PDF einem Consumer-Datensatz anhängen
ay upload ./report.pdf \
  --state crm.documents.edit \
  --target 507f1f7...

# Receipt an Invoice
ay upload ./receipt.pdf \
  --state accounting.invoices.edit \
  --target 64a1b2c3...

Verhalten

  • Multipart-POST gegen config-api.ayoune.app/documents/upload.
  • Server vergibt _id, schreibt File-Metadata + Storage-Pfad.
  • Antwort enthält documentId, filename, size — bei --format json kompletter Output.

Fehlerfälle

  • HTTP 403 — --state matched kein Right des Users. Via ay access prüfen.
  • HTTP 413 — File > Customer-Quota. Customer-Limit hochsetzen.
  • HTTP 422 — Target-Entity existiert nicht oder gehört anderem Customer.

Siehe auch