Beecargo

Get set up

  • ○Sign in
  • ○Connect your agent
  • ○Share a file

API

OverviewUpload a fileRemote uploadShare settingsClaim a fileAgent APIWebhooksRetrieve a fileGet file infoList files & foldersDelete a file

MCP

OverviewRegister an agentUpload a fileUpload statusRemote uploadLarge uploads & jobsFoldersShare settingsSeller payoutsBuy a priced shareClaim fileSearch toolsCreate checkoutRetrieve a fileGet file infoList filesDelete a fileFiles from a runUpload delegation
PreviousRegister an agentNextUpload status
BlogPricingDashboardPrivacyTerms

Upload a file

Upload via public URL, small base64 payload, or local path (stdio MCP). Same tier limits as the web app and REST API.

Same flow over HTTP: POST /files/upload

Tool

beecargo_upload

Provide exactly one source: url (public HTTPS), contentBase64 (under 4MB on hosted MCP), or path (stdio only; auto multipart up to your tier max). Use background: true for large/slow URLs, then beecargo_upload_status.

Authentication

API key optional. Anonymous uploads use anonymous limits and return claimToken and deletionToken.

Parameters

ParameterTypeRequiredDescription
urlStringOne of url | contentBase64 | pathPublic HTTPS URL Beecargo fetches server-side
contentBase64StringOne of url | contentBase64 | pathSmall file as base64 (hosted MCP body limit applies)
pathStringstdio onlyLocal file path (stdio MCP; not available on hosted HTTP)
fileNameStringWith contentBase64Original file name
backgroundBooleanNoAsync remote job; poll with beecargo_upload_status
waitSecondsNumberNoWhen background is true, wait up to N seconds for completion
folderIdStringNoOptional folder UUID (signed-in users only)
visibilityunlisted | publicNoPublic needs a claimed username on the account
directBooleanNoPro: start download when the /d share opens
retentionttl | foreverNoPublic Pro shares may use forever
expiresAtString (ISO)NoExact expiry when retention is ttl
ttlStringNoKeep-time preset from now, such as 1h, 24h, or 7d
onceBooleanNoWhen true, the share can be downloaded only once
maxDownloadsNumberNoMax downloads allowed (ignored when once is true)
protectBooleanNoCreate an unlock code and private delivery link (returned once)
handoffMessageStringNoOptional note on the delivery link, max 480 characters
runIdStringNoOptional pipeline id so you can list related files later with beecargo_list_files (runId)
openShareBooleanNoOpen a growable multi-file Shipment for this upload (returns shareShortId). Use shareShortId on later uploads to add files to the same link.
shareShortIdStringNoAttach this upload to an existing growable Shipment from a prior openShare upload (same /d/{shortId})
idempotencyKeyStringNoSafe retries: same key + same body returns the first result

Usage notes

  • Anonymous: 1GB/file. Free signed-in: 5GB/file, 10GB concurrent storage. Pro: 35GB/file, 100GB included concurrent storage.
  • Hosted HTTP cannot read your disk; use url or small contentBase64, or stdio/CLI for local files.
  • Publish options (ttl, once, protect, runId, openShare, …) can be set on upload; you can also change many of them later with share settings.
  • For several outputs from one agent run, reuse the same runId, then list them at /docs/mcp/run-artifacts. For one human share link with many files, use openShare then shareShortId.
  • For safe retries on write tools, pass optional idempotencyKey (same as the HTTP Idempotency-Key header).
  • REST API still exposes /files/multipart/* and /files/remote-upload for advanced integrators.