Upload file to Remote File Manager

Upload file to Remote File Manager
Stable

Request

Upload file through SCAPI server to REMOTE_FILE_MANAGER bucket. Files are automatically deleted after 1 day.

Security

apiKey

Path

enterprise_idstringrequired

A UUID string identifying this enterprise.

Bodymultipart/form-datarequired

filestring, (binary)required

The file to upload (max 50MB)

filenamestring

Custom filename (optional, defaults to uploaded file name)

content_typestring

MIME type of the file (optional, auto-detected)

cURL

curl -i -X POST \
  'https://develop-api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/content/remote-file/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F file=string \
  -F filename=string \
  -F content_type=string

Responses

File uploaded successfully

Bodyapplication/json

file_keystring

Unique storage key for the file

Example:"123/files/document_abc123.pdf"

bucketstring

Storage bucket name

Example:"REMOTE_FILE_MANAGER"

file_sizeinteger

Size of uploaded file in bytes

Example:1048576

content_typestring

Detected/validated MIME type

Example:"application/pdf"

auto_delete_after_minutesinteger

When file will be auto-deleted

Example:1440

download_urlstring

Pre-signed URL for downloading the file

Example:"https://s3.amazonaws.com/REMOTE_FILE_MANAGER/123/files/document_abc123.pdf?AWSAccessKeyId=..."

download_expires_ininteger

Download URL expiration time in seconds

Example:3600

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
}