Skip to main content

ChunkedUploadSessionDto

The reserved chunked upload: where the parts are sent, how much was declared and when the reservation lapses. No content of the file is described here.

NameTypeDescriptionNotes
idStringThe identifier of the reserved upload, repeated in the path of every call that follows it - the chunk uploads, the finalize and the abort. It is thirty-two hexadecimal characters without separators, and it is the only thing the server checks, so anyone holding it can write into this upload.[optional] [example: 1b6a2ee1f2a04c6f9bd2cbf0e0f23a54] [nullable]
pathList (int32)The chain of folders leading to the destination, outermost first and the destination itself last, with folders the caller cannot read left out. An answer that reports a stored part carries the destination folder alone instead of the whole chain.[optional] [example: [1, 5, 12]] [nullable]
createdDate (date-time)The moment the upload was reserved, in UTC.[optional] [example: 2026-09-11T10:30:00Z]
expiredDate (date-time)The moment the reservation lapses and the parts buffered for it are dropped, in UTC. It is a gap rather than a deadline for the whole transfer: every accepted part pushes it twelve hours past that part, so only a long silence loses the upload.[optional] [example: 2026-09-11T22:30:00Z]
locationStringThe absolute address of the separate chunk handler that also accepts the parts of this upload, kept for clients written against it. A caller working through this API does not need it and sends the parts to the session operations instead.[optional] [example: https://example.com/ChunkedUploader.ashx?uid=1b6a2ee1f2a04c6f9bd2cbf0e0f23a54] [nullable]
bytes_totalLong (int64)The size in bytes that was declared when the upload was reserved, echoed back. It is what the arriving parts are counted against to decide the file is complete, not the amount received so far.[optional] [example: 10485760]