town.delve.video.finishUpload
Finish 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.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | video.delve.town |
| Indexed |
Procedure
procedure · POSTInput
application/jsonminLength: 1maxLength: 256
Output
application/jsonThe processing job to poll with getJobStatus; on deduplication this may differ from the input jobId.
minLength: 1maxLength: 256
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 finalization began.
MissingParts
Not all parts are recorded; the error message lists the missing part numbers.
UploadNotReady
A finish is in progress; check getUploadStatus and retry.
UnsupportedContentType
The assembled object's detected content type is not supported.
UploadFailed
The session is known to have failed; the error carries its failure reason.
UploadAborted
The session is known to have been aborted.
ServiceOverloaded
The service is draining or temporarily at capacity; retry later.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
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.
-
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.uploadPart
procedureUpload 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.
-
io.atcr.hold.completeUpload
procedureFinalize a multipart upload and move the assembled blob to its final location.