Files

Import file from public URL

Same publish fields as direct upload (including openShare / shareShortId). Send Idempotency-Key for safe retries.

post/files/remote-upload

Request

  • Base URL: https://api.beecargo.net
  • URL: https://api.beecargo.net/files/remote-upload
  • Auth: none declared

Headers

Idempotency-Keystring

Request body

urlstring uri required
folderIdstring uuid nullable
visibility'unlisted' | 'public'
directboolean

Pro: start download when the /d share opens

retention'ttl' | 'forever'
expiresAtstring date-time

Exact expiry when retention is ttl

ttlstring

Keep-time preset from now, such as 1h, 24h, or 7d

onceboolean

When true, the share can be downloaded only once

maxDownloadsinteger

Max downloads (ignored when once is true)

protectboolean

Create unlock code and private delivery link

handoffMessagestring

Optional delivery-link note

runIdstring

Optional pipeline id; list later via GET /files/list?runId=

openShareboolean

Authenticated: open a growable multi-file Shipment; response shortId is the share link. Use shareShortId on later uploads.

shareShortIdstring

Authenticated: attach this upload to an existing growable Shipment from a prior openShare

Response

Import success

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.