town.delve.video.abortUpload

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.

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

Present only when state is completed.

  • minLength: 1
  • maxLength: 256

Present only when state is failed.

  • maxLength: 1024

state

requiredstring
  • maxLength: 32
  • knownValues: aborted | completed | failed | expired

Errors

UploadNotFound

The job ID is unknown or aged out of retention; known terminal sessions return their outcome and are never reported as not found.

UploadNotReady

A finish is in progress; check getUploadStatus and retry.

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.

  • Cancel a multipart upload and cleanup any temporary data.

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