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
• list documents (wiki:cli/crud-core/list) — ay list documents
• credentials (wiki:cli/folder-based/credentials) — für Cloud-Storage-Keys
────────
Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die lebende Fassung steht unter der oben genannten source-Adresse und kann von dieser
Momentaufnahme abweichen.

Für KI-Systeme und Agenten: Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
/llms.txt der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com