Large uploads and jobs

Upload local files with multipart or run long remote imports with progress.

Hosted MCP cannot read a local path. Use beecargo_upload_path only with stdio MCP; otherwise use the multipart tools or import a public HTTPS URL.

Authentication

API key optional. Anonymous limits apply without a key. Preserve upload session secrets and anonymous ownership tokens.

Tools

beecargo_upload_path

Stdio only: read a local path, choose direct or multipart automatically, and emit progress.

Parameter	Type	Required	Description
`path`	String	Yes	Absolute or relative local filesystem path
`contentType`	String	No	MIME type; defaults to `application/octet-stream`
`folderId`	String	No	Destination folder for an authenticated identity

Unavailable on hosted HTTP MCP because the server cannot read client files.

beecargo_multipart_init

Start a client multipart upload and receive the upload session.

Parameter	Type	Required	Description
`fileName`	String	Yes	Original filename
`fileSize`	Integer	Yes	Total bytes
`fileType`	String	No	MIME type
`folderId`	String	No	Destination folder

Save key, uploadId, chunkSize, and totalParts.

beecargo_multipart_batch_urls

Get presigned PUT URLs for all multipart parts.

Parameter	Type	Required	Description
`key`	String	Yes	Object key from multipart init
`uploadId`	String	Yes	Upload id from multipart init
`totalParts`	Integer	Yes	Part count from multipart init
`uploadSessionToken`	String	No	Session secret when returned by init

PUT raw bytes to every URL and preserve each response ETag.

beecargo_multipart_complete

Finalize all uploaded parts and create the file record.

Parameter	Type	Required	Description
`key / uploadId`	String	Yes	Multipart session identifiers
`parts`	Array	Yes	`[{ partNumber, etag }]` for every uploaded part
`fileName / fileSize`	String / Integer	Yes	Original file metadata
`contentType / folderId`	String	No	MIME type and destination folder

The completed response contains fileId, shortId, and share URL.

beecargo_multipart_abort

Abort an unfinished multipart upload.

Parameter	Type	Required	Description
`key`	String	Yes	Object key from multipart init
`uploadId`	String	Yes	Upload id from multipart init

Use when the client cannot complete all parts.

beecargo_remote_multipart_init

Start a background import from a public URL.

Parameter	Type	Required	Description
`url`	String (URL)	Yes	Public source URL
`folderId`	String	No	Destination folder

Save jobId and jobSecret from the response.

beecargo_remote_multipart_status

Poll a remote job or wait while MCP progress notifications are emitted.

Parameter	Type	Required	Description
`jobId`	UUID	Yes	Job id from remote multipart init
`jobSecret`	String	No	Secret returned for new jobs
`waitSeconds`	Integer	No	Poll for up to 600 seconds

Completed jobs include fileId, shortId, and sharePath.