town.delve.video.uploadPart
Upload one part. Parts are idempotent and may be retried or re-sent while the session is created. Each expected length is derived from the upload size and part size, and Content-Length must match exactly. ETags are never exposed to clients.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | video.delve.town |
| Indexed |
Procedure
procedure · POSTParameters
query stringminLength: 1maxLength: 256
minimum: 1
Input
application/octet-streamOutput
application/jsonminimum: 1
Errors
UploadNotFound
The job ID is unknown or aged out of retention; known terminal sessions are never reported as not found.
UploadExpired
The upload session expired before completion.
InvalidPartNumber
The part number is outside the upload's valid part range.
PartSizeMismatch
Content-Length does not exactly match the expected size for this part.
UploadNotReady
A finish is in progress; check getUploadStatus and retry.
UploadFailed
The session is known to have failed; the error carries its failure reason.
UploadAborted
The session is known to have been aborted.
UploadAlreadyCompleted
The session is known to have already completed.
ServiceOverloaded
The service is draining or temporarily at capacity; retry on another worker.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
town.delve.video.finishUpload
procedureFinish an upload. This call is idempotent and safe to retry. On deduplication completedJobId may differ from the input jobId; poll getJobStatus with completedJobId. Probe-based validation failures surface later as JOB_STATE_FAILED from getJobStatus, not as errors from this call.
-
town.delve.video.startUpload
procedureStart a multipart video upload. The declared size is exact, while optional media properties are advisory and used only for early failure; the authoritative probe runs asynchronously after upload.
-
Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.
-
town.delve.video.abortUpload
procedureAbort an upload only while it is created, releasing its quota reservation immediately. Terminal sessions are unchanged and return their terminal outcome. A finishing session returns UploadNotReady.
-
io.atcr.hold.getPartUploadUrl
procedureGet a presigned URL or endpoint info for uploading a specific part of a multipart upload.