Upload file to Remote File Manager
Uploads a file to the Remote File Manager bucket for temporary storage.
Accepts a multipart file upload up to 50MB and returns a file_key, bucket name, size, content type, and a pre-signed download_url. Files uploaded here are automatically deleted after 1 day, so this is intended for short-lived transfers rather than long-term content storage.
About Upload File to Remote File Manager
The Remote File Manager bucket is a temporary staging area distinct from Esper's main Content management system. Because files here are auto-deleted after 1440 minutes (1 day), it's best suited for short-lived use cases such as generating a one-time download link or briefly staging a file for another workflow, rather than for files devices need to reference long-term.
Key Fields / Request Body
file — the file to upload, required, maximum 50MB
filename — an optional custom filename; defaults to the uploaded file's name
content_type — an optional MIME type override, auto-detected if omitted
Common Use Cases
Generating a short-lived, shareable download link for a file
Staging a file temporarily for a downstream automation step
Best Practices
Do not rely on this endpoint for files that need to persist beyond 1 day; use the Content API for anything longer-lived
Capture the file_key immediately, since it is required to generate additional download URLs later
Workflow
POST the file as multipart form data to this endpoint
Capture the returned file_key and download_url
Use the generate_download_url endpoint with the file_key if you need a new pre-signed URL after the original expires
Path parameters
A UUID string identifying this enterprise.
Response
File uploaded successfully
Example response
{
"file_key": "123/files/document_abc123.pdf",
"bucket": "REMOTE_FILE_MANAGER",
"file_size": 1048576,
"content_type": "application/pdf",
"auto_delete_after_minutes": 1440,
"download_url": "https://s3.amazonaws.com/REMOTE_FILE_MANAGER/123/files/document_abc123.pdf?AWSAccessKeyId=...",
"download_expires_in": 3600
}