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.

Repository @delve.town did:plc:qzqct2rrq4u2gmy5g3mjxske namespace authority
Details · procedure
Kindprocedure
Authorityvideo.delve.town
Indexed

Procedure

procedure · POST

Input

application/json

jobId

requiredstring
  • minLength: 1
  • maxLength: 256

Output

application/json

completedJobId

requiredstring

The processing job to poll with getJobStatus; on deduplication this may differ from the input jobId.

  • minLength: 1
  • maxLength: 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 match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Abort 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.

  • 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.

  • Finalize a multipart upload and move the assembled blob to its final location.