Ressourcendatei anhängen

Hängt eine Datei an eine bereits bestehende Ressource oder ersetzt sie. Die Ressource behält ihre ID, sodass eine asset:-Referenz, die bereits in einer Beschreibung oder auf einer veröffentlichten Seite steht, gültig bleibt — genau deshalb ist dies der richtige Weg, ein aktualisiertes Bild erneut zu veröffentlichen.

Übergeben Sie ?locale=de, um die Variante für diese Sprache zu schreiben und die anderen Sprachen unberührt zu lassen; ohne den Parameter wird die Standarddatei ersetzt. Eine Ressource kann je Sprache eine Datei halten, und eine einzige asset:-Referenz löst dann für jede Leserin und jeden Leser die passende auf.

Jeder Upload speichert eine neue Datei, statt die vorherige zu überschreiben — eine ältere Modellversion öffnet also weiterhin die Datei, mit der sie gespeichert wurde. Maximal 100 MB. Gibt 404 zurück, wenn die Ressource nicht existiert — legen Sie sie zuerst an, mit create_asset oder dem Endpunkt Upload Asset.

AuthentifizierungBearer mpt_... or OAuth JWT

Plan-AnforderungPro+

Parameter

Name	Typ	Pflichtfeld	Beschreibung
`asset_id`	`String (UUID)`	✓	[Ressourcendatei anhängen] UUID der bestehenden Ressource, an die die Datei gehängt wird. Pfadparameter. Gibt 404 zurück, wenn es im Modell keine solche Ressource gibt — dieser Endpunkt legt niemals eine an.
`file`	`Multipart file (max 100 MB)`	✓	[Ressourcendatei anhängen] Die anzuhängende Datei. Multipart-Formularfeld — jedes Feld außer „label“ wird als Datei behandelt. Dateiname und Inhaltstyp werden aus den Multipart-Headern übernommen.
`locale`	`String`	—	[Ressourcendatei anhängen] Schreibt die Datei als Variante für diese Sprache, zum Beispiel `de`, und lässt die anderen Sprachen unberührt. Lassen Sie den Parameter weg — oder übergeben Sie die Standardsprache des Modells —, um die Standarddatei zu ersetzen.
`model_id`	`String (UUID)`	✓	[Ressourcendatei anhängen] UUID des Modells, zu dem die Ressource gehört. Pfadparameter.

Beispielantwort

{"asset_id": "7b12...", "file_id": "9d4e...", "filename": "architecture-de.png", "content_type": "image/png", "size_bytes": 192104, "locale": "de"}