Skip to main content
PATCH
cURL

Path Parameters

id
string<uuid>
required

Body

bytes_transferred
integer
Required range: x >= 0
completed_files
object[]

Upload only: [{filename, size, checksum}].

Response

200 - application/json

Read-only representation of a transfer.

Includes denormalized labels (project_name, repository_name, asset_content_title) so the client can render one row per transfer without extra round-trips. Transfers are visible only to the user who initiated them (GET /transfers/ lists the caller's own transfers), and the labels reflect what the initiator could see at initiation time — they remain readable even if the underlying access grant is later revoked. project_* and repository_* fields are nullable — an asset may have no owning project, and its storage allocation may have been detached — clients MUST handle null.

id
string<uuid>
required
read-only
asset_content_id
string<uuid>
required
read-only
type
enum<string>
required
  • upload - Upload
  • download - Download
Available options:
upload,
download
status
enum<string>
required
  • pending - Pending
  • claimed - Claimed
  • in_progress - In Progress
  • completed - Completed
  • failed - Failed
  • expired - Expired
Available options:
pending,
claimed,
in_progress,
completed,
failed,
expired
origin
enum<string>
required
  • user - User
  • system - System
Available options:
user,
system
bytes_transferred
integer
required
read-only
expires_at
string<date-time>
required
read-only
initiated_by_id
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
asset_content_title
string
required
read-only
project_id
string<uuid>
required
read-only
project_name
string
required
read-only
repository_id
string<uuid>
required
read-only
repository_name
string
required
read-only
total_bytes
integer
default:0
required
read-only
direction_supports_progress
boolean
required
read-only
executor
enum<string>
required
  • browser - Browser
  • client - Client (SDK endpoint)
Available options:
browser,
client
delivery_target
any
required
claimed_by_endpoint_id
string<uuid> | null
required
read-only
claimed_endpoint_name
string
required
read-only
lease_expires_at
string<date-time> | null
required
read-only