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.

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

Procedure

procedure · POST

Parameters

query string

jobId

requiredstring
  • minLength: 1
  • maxLength: 256

partNumber

requiredinteger
  • minimum: 1

Input

application/octet-stream

Output

application/json

partNumber

requiredinteger
  • minimum: 1

sizeBytes

requiredinteger

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 match

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

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

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

  • 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 a presigned URL or endpoint info for uploading a specific part of a multipart upload.