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
PreviousShare settingsNextAgent API
BlogPricingDashboardPrivacyTerms

Claim a file

Move an anonymous upload into your account with the file id and claim token from the upload response.

Same flow in MCP: beecargo_claim_file

Endpoint

POSThttps://api.beecargo.net/files/claim

Authentication

Required. Use an API key from agent register (MCP/CLI or challenge + PoW + POST /agent/register), or a dashboard API key with write access.

Authorization: Bearer YOUR_BC_KEY

Request examples

Moves an anonymous file into your account so it shows in GET /files/list and uses signed-in retention limits.

curl -X POST https://api.beecargo.net/files/claim \
  -H "Authorization: Bearer YOUR_BC_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileId":"abc12xyz","claimToken":"YOUR_CLAIM_TOKEN"}'

Parameters

ParameterTypeRequiredDescription
fileIdStringYesShort file id from upload (data.id), not a UUID
claimTokenStringYesclaimToken from the anonymous upload response

Response

{
  "success": true,
  "data": {
    "id": "abc12xyz",
    "shortCode": "abc12"
  }
}

Usage notes

  • MCP: call beecargo_claim_file after beecargo_register_agent
  • Claim only works for anonymous uploads that returned a claimToken