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 settingsClaim fileSearch toolsCreate checkoutRetrieve a fileGet file infoList filesDelete a fileFiles from a runUpload delegation
PreviousFiles from a run
PricingDashboard

Upload delegation

Create a short-lived upload for a worker that should not hold your full API key.

Tool

beecargo_create_upload_delegation

Advanced only. Prefer beecargo_upload for normal agent uploads. Use this when a separate worker must put the bytes, but must not keep your API key. You get a short-lived upload URL and a delegation token; the worker uploads, then completes the job with that token.

Authentication

API key required. Anonymous callers cannot create delegations.

Parameters

ParameterTypeRequiredDescription
nameStringYesFile name to store (max 240 characters)
sizeBytesNumberYesExact size of the file in bytes
contentTypeStringNoMIME type of the file
folderIdStringNoOptional folder to place the file in
visibilityunlisted | publicNoShare visibility after the upload completes
ttlStringNoOptional time-to-live for the finished file
onceBooleanNoWhen true, the share can be downloaded only once
runIdStringNoOptional pipeline run id for later listing with run artifacts
immutableBooleanNoWhen true, the finished file cannot be changed or casually deleted
upstreamFileIdsString[]NoOptional parent file ids this upload depends on (lineage)

Usage notes

  • API: POST https://api.beecargo.net/files/upload-delegations, then complete with /files/upload-delegations/complete (multipart helpers exist for large files).
  • The upload URL and delegation token expire quickly. Do not treat them as lasting share links.
  • After completion you still get a normal share link (/d/{shortId}). Hand that to humans.
  • For most agents, beecargo_upload with a public url is simpler and enough.