Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json
file_name
string
required

Name of the file to upload

file_type
string
required

MIME type of the file (e.g., 'image/png', 'application/pdf')

file_size
integer
required

File size in bytes. Maximum 10MB for regular files, 2GB for video files.

Required range: x >= 1
workspace_id
string
required

Workspace to upload the file to

checksum
string

SHA256 checksum of the file for integrity verification (optional)

folder_id
string

Optional folder ID to organize the file

Response

Presigned upload URL generated

Response containing the presigned upload URL and instructions

object
enum<string>
Available options:
upload_url
upload_url
string<uri>

Presigned URL for uploading the file (PUT request)

public_url
string<uri>

Public URL where the file will be accessible after upload

key
string

Storage key for the file

expires_in
integer

Seconds until the upload URL expires (3600 = 1 hour)

method
enum<string>

HTTP method to use for uploading

Available options:
PUT
headers
object

Headers to include when uploading to the presigned URL

next_step
object

Instructions for completing the upload