Reports status or progress for one of the caller's transfers.

Behavior: Records the reported state. Reporting the in-progress state for the
direction is a progress update; reporting a final state ends the transfer.

Throttling: Progress reports representing very little change since the last one
are accepted and discarded rather than written. Clients may report as often as they like;
this endpoint decides what is worth storing.

Upload progress: Ignored for uploads. The server counts bytes itself as each
part is confirmed, so upload progress does not depend on the client staying alive.

Final states: A transfer that has already finished cannot be reopened, and a
late report against one is ignored rather than treated as an error. Use requeue to retry.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^uploads|downloads$

Either uploads or downloads.

uuid
required

The transfer id.

Body Params

The reported state and progress.

A client-reported status or progress change for one transfer.

string
enum

The lifecycle state of a single asset transfer, in either direction.

Allowed:
float | null

Gets or sets percent complete, 0 to 100. Only read for an in-progress status.

int64 | null

Gets or sets bytes moved so far, when the client tracks it.

int64 | null

Gets or sets the total file size in bytes, when known to the client.

string | null

Gets or sets the failure reason. Only read alongside Nomad.Common.Enums.AssetTransferStatuses.Error.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json