town.delve.video.getUploadStatus
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.
Details · query
| Kind | query |
|---|---|
| Authority | video.delve.town |
| Indexed |
Query
query · GETParameters
query stringminLength: 1maxLength: 256
Output
application/jsoncompletedJobId
stringPresent only when state is completed; may differ from jobId on deduplication.
minLength: 1maxLength: 256
failureReason
stringPresent only when state is failed.
maxLength: 1024
minLength: 1maxLength: 256
jobStatus
refPresent only when state is completed.
minimum: 1
maxLength: 32knownValues: created | finishing | completed | failed | aborted | expired
Errors
UploadNotFound
The job ID is unknown or aged out of retention; known terminal sessions remain readable and are never reported as not found.
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.
-
Get the processing status of a previously created upload. Only accessible by the DID that created the upload.
-
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 status details for a video processing job.
-
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.