Carregar um ficheiro
Guarda um ficheiro no espaço de trabalho, como o botão Enviar da página Ficheiros. O corpo é o próprio ficheiro, nem JSON nem multipart, com o seu tipo em `Content-Type`.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /files
Guarda um ficheiro no espaço de trabalho, como o botão Enviar da página Ficheiros. O corpo é o próprio ficheiro, nem JSON nem multipart, com o seu tipo em Content-Type.
Exemplo
Precisa de threads:write. Dê o nome ao ficheiro com o parâmetro de consulta filename, ou com um cabeçalho X-Filename codificado em URI. A resposta é um 201 com o ficheiro, e o seu id pode ser anexado a um envio 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"}Um nome é limpo em vez de recusado: os caracteres que um nome de ficheiro não pode ter passam a _, e um nome com mais de 255 caracteres é cortado, mantendo a extensão. Um Content-Type que não é um tipo MIME é guardado como application/octet-stream.
Sem nome é um 400 upload_no_name, um programa ou um script um 400 upload_dangerous, um corpo vazio um 400 upload_empty, e um ficheiro com mais de 100 MB um 413 upload_too_large.
Um espaço de trabalho aceita 500 carregamentos por hora, incluindo os eliminados, e guarda 10 GB de ficheiros carregados de cada vez. Acima disso, a resposta é um 429 upload_rate_limited ou um 507 upload_storage_full. Um 502 upload_failed significa que o armazenamento falhou, e vale a pena tentar de novo.
Uma chave que chega a todos os endereços carrega para o espaço de trabalho inteiro, com deliveredTo a null. Uma chave limitada a determinados endereços ou domínios carrega para o primeiro endereço que tem, e uma que não tem nenhum recebe um 403 upload_no_address.