/api/v1/models/{model_id}/assetsRessource hochladen
Legt eine neue Ressource in einem Modell an und hängt in einem einzigen Multipart-Upload eine Datei an. Sendet die Kollaborations-Operationen AssetAdded und AssetFileAttached — Nutzerinnen und Nutzer im Browser sehen die neue Ressource in Echtzeit. Maximal 100 MB.
Übergeben Sie ?locale=de, um die Datei als Variante für diese Sprache statt als Standarddatei zu speichern. Üblicherweise laden Sie hier zuerst die Basissprache hoch und fügen weitere Sprachen dann derselben Ressource mit dem Endpunkt Attach Asset File hinzu — eine eigene Ressource je Sprache zerstört das Verhalten, dass eine einzige Referenz beide Sprachen bedient und auf das sich asset:-Links verlassen.
Die Antwort enthält zusätzlich ein file-Objekt, das die gerade geschriebene file_id und den Sprachplatz nennt, in dem sie gelandet ist.
Parameter
| Name | Typ | Pflichtfeld | Standard | Beschreibung |
|---|---|---|---|---|
model_id | String (UUID) | ✓ | [Ressource hochladen] UUID des Modells, zu dem die neue Ressource gehört. Pfadparameter. | |
file | Multipart file (max 100 MB) | ✓ | [Ressource hochladen] Die anzuhängende Datei. Multipart-Formularfeld — jedes Feld außer „label“ wird als Datei behandelt. Dateiname und Inhaltstyp werden aus den Multipart-Headern übernommen. | |
label | Multipart text | — | [Ressource hochladen] Anzeigename der Ressource. Multipart-Textfeld. Ohne Angabe wird der Dateiname der hochgeladenen Datei verwendet. | |
locale | String | — | [Ressource hochladen] Speichert die Datei als Variante für diese Sprache, zum Beispiel `de`. Lassen Sie den Parameter weg — oder übergeben Sie die Standardsprache des Modells —, um die Standarddatei zu speichern. Üblicherweise kommt die Standarddatei zuerst, weitere Sprachen fügen Sie derselben Ressource mit „Attach Asset File“ hinzu. |
Beispielantwort
{"id": "new-asset-uuid", "label": "Architecture Diagram", "description": null, "filename": "architecture.png", "content_type": "image/png", "size_bytes": 184320, "tags": [], "created_at": "2026-05-16T12:34:56Z", "updated_at": "2026-05-16T12:34:56Z", "file": {"asset_id": "new-asset-uuid", "file_id": "c3f1...", "filename": "architecture.png", "content_type": "image/png", "size_bytes": 184320, "locale": "default"}}Dieser Inhalt wurde kollaborativ mit KI erstellt.