Skip to main content
POST
cURL

Body

content_id
string<uuid>
required
type
enum<string>
required
  • upload - upload
  • download - download
Available options:
upload,
download
files
string[]

Upload only: list of filenames to transfer.

expires_in
integer
default:86400

TTL in seconds (default 86400 = 1 day).

Required range: 60 <= x <= 604800
supported_protocols
string[]

Preferred transfer protocols, e.g. ['s3']. Accepted but not yet used in credential selection.

origin
enum<string>
default:user

Transfer source. 'system' is used for internal fetches (e.g. README auto-load) and is filtered out of the tracker list by default.

  • user - user
  • system - system
Available options:
user,
system

Response

201 - application/json
transfer_id
string<uuid>
required
credentials
object
required
endpoint
string
required
prefix
string
required
files
object[]
required
expires_at
string<date-time>
required