Skip to main content
POST
/
files
/
upload-url
cURL
curl -X POST https://app.mavera.io/api/v1/files/upload-url \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "image.png",
    "file_type": "image/png",
    "file_size": 524288,
    "workspace_id": "ws_abc123"
  }'
{
  "object": "upload_url",
  "upload_url": "<string>",
  "public_url": "<string>",
  "key": "<string>",
  "expires_in": 123,
  "method": "PUT",
  "headers": {
    "Content-Type": "<string>",
    "x-amz-checksum-sha256": "<string>"
  },
  "next_step": {
    "description": "<string>",
    "endpoint": "<string>",
    "body": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavera.io/llms.txt

Use this file to discover all available pages before exploring further.

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