Subir un archivo
Guarda un archivo en el espacio de trabajo, como el botón Subir de la página Archivos. El cuerpo es el propio archivo, ni JSON ni multipart, con su tipo en `Content-Type`.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /files
Guarda un archivo en el espacio de trabajo, como el botón Subir de la página Archivos. El cuerpo es el propio archivo, ni JSON ni multipart, con su tipo en Content-Type.
Ejemplo
Necesita threads:write. Nombra el archivo con el parámetro de consulta filename o con una cabecera X-Filename codificada como URI. La respuesta es un 201 con el archivo, y su id se puede adjuntar a un envío como { fileId }.
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"}Un nombre se limpia en lugar de rechazarse: los caracteres que un nombre de archivo no admite pasan a ser _, y un nombre de más de 255 caracteres se recorta, conservando su extensión. Un Content-Type que no es un tipo MIME se guarda como application/octet-stream.
Sin nombre es un 400 upload_no_name, un programa o un script un 400 upload_dangerous, un cuerpo vacío un 400 upload_empty y un archivo de más de 100 MB un 413 upload_too_large.
Un espacio de trabajo acepta 500 subidas por hora, incluidas las eliminadas, y guarda 10 GB de archivos subidos a la vez. Por encima de eso la respuesta es un 429 upload_rate_limited o un 507 upload_storage_full. Un 502 upload_failed significa que falló el almacenamiento y vale la pena reintentarlo.
Una clave que alcanza todas las direcciones sube al espacio de trabajo entero, con deliveredTo en null. Una clave limitada a direcciones o dominios concretos sube a la primera dirección que tiene, y una que no tiene ninguna recibe un 403 upload_no_address.