Beecargo

INTRODUCTION

Welcome

API

Overview
  • Upload a file
  • Remote upload
  • Claim a file
  • Agent API
  • Retrieve a file
  • Get file info
  • List files & folders
  • Delete a file

MCP

Overview

LEGAL

PrivacyTermsAcceptable useCookiesRefundsDMCA
PreviousRemote uploadNextAgent API

Claim a file

Attach an anonymous upload to your account using fileId and claimToken from the upload response.


Endpoint

POST https://api.beecargo.net/files/claim

Authentication

Required. Use Bearer bc_* from POST /agent/register or a dashboard API key with write scope.

Authorization: Bearer YOUR_BC_KEY

Request examples

Moves an anonymous file into your account so it appears in GET /files/list and uses authenticated 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 response (data.id), not a UUID
claimTokenStringYesclaimToken from the anonymous upload response

Response

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

Usage notes

  • MCP equivalent: beecargo_claim_file after beecargo_register_agent
  • Claim is only valid for anonymous uploads that returned a claimToken