Get Upload Url

Get upload specification for uploading a file to a folder

Parameters

Parameter	Type	Required	Description
`folder_id`	`string`	Required	ID of the folder to upload to
`file_name`	`string`	Required	Name of the file being uploaded
`file_size`	`number`	Optional	Size of the file in bytes (optional but recommended)
`batch_id`	`string`	Optional	Batch ID for multi-file uploads
`batch_last`	`boolean`	Optional	Is this the last file in the batch?
`can_resume`	`boolean`	Optional	Enable resumable uploads (default true)
`start_over`	`boolean`	Optional	If true, start a new upload even if resumable upload exists
`overwrite`	`boolean`	Optional	If true, overwrite existing file with same name
`title`	`string`	Optional	Display title for the file (defaults to file_name)
`details`	`string`	Optional	Description/details for the file
`notify`	`boolean`	Optional	Send notification emails on upload completion

Examples

MCP Tool Call

{
  "name": "sharefile_getUploadUrl",
  "arguments": {
    "folder_id": "example",
    "file_name": "example",
    "file_size": 12345,
    "batch_id": "example",
    "batch_last": true,
    "can_resume": true,
    "start_over": true,
    "overwrite": true,
    "title": "example",
    "details": "example",
    "notify": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/getUploadUrl \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "folder_id": "example",
  "file_name": "example",
  "file_size": 12345,
  "batch_id": "example",
  "batch_last": true,
  "can_resume": true,
  "start_over": true,
  "overwrite": true,
  "title": "example",
  "details": "example",
  "notify": true
}'