Eine Datei hochladen
Legt eine Datei im Workspace ab, wie die Schaltfläche „Hochladen“ auf der Seite „Dateien“. Der Body ist die Datei selbst, weder JSON noch multipart, mit ihrem Typ in `Content-Type`.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /files
Legt eine Datei im Workspace ab, wie die Schaltfläche „Hochladen“ auf der Seite „Dateien“. Der Body ist die Datei selbst, weder JSON noch multipart, mit ihrem Typ in Content-Type.
Beispiel
Benötigt threads:write. Benennen Sie die Datei mit dem Query-Parameter filename oder mit einem URI-kodierten X-Filename-Header. Die Antwort ist ein 201 mit der Datei, und ihre ID lässt sich einem Versand als { fileId } anhängen.
curl -X POST "$OE/files?filename=price-list.pdf" -H "$AUTH" -H 'content-type: application/pdf' --data-binary @price-list.pdf{ "object": "file", "id": "file_0c4e7a91d2b84f63a5e19b7d", "filename": "price-list.pdf", "mimeType": "application/pdf", "sizeBytes": 248112, "direction": "uploaded", "threadId": null, "messageId": null, "deliveredTo": null, "usage": null, "deletable": true, "createdAt": "2026-09-24T09:12:40.000Z"}Ein Name wird bereinigt statt abgelehnt: Zeichen, die ein Dateiname nicht enthalten kann, werden zu _, und ein Name über 255 Zeichen wird gekürzt, wobei die Endung bleibt. Ein Content-Type, der kein MIME-Typ ist, wird als application/octet-stream gespeichert.
Kein Name ist ein 400 upload_no_name, ein Programm oder Skript ein 400 upload_dangerous, ein leerer Body ein 400 upload_empty und eine Datei über 100 MB ein 413 upload_too_large.
Ein Workspace nimmt 500 Uploads pro Stunde an, gelöschte eingerechnet, und hält 10 GB an Uploads zugleich. Darüber hinaus lautet die Antwort 429 upload_rate_limited oder 507 upload_storage_full. Ein 502 upload_failed heißt, dass der Speicher versagt hat, und ein neuer Versuch lohnt sich.
Ein Schlüssel, der jede Adresse erreicht, lädt in den ganzen Workspace hoch, mit deliveredTo null. Ein auf bestimmte Adressen oder Domains beschränkter Schlüssel lädt auf die erste Adresse hoch, die er hält, und einer, der keine hält, bekommt ein 403 upload_no_address.