---
title: "ay upload"
source: "https://ayoune.com/de/docs/cli/commands/commands-crud-core/upload"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "de"
retrieved: "2026-08-27T21:23:32.596Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `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

```bash
# 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