town.delve.video.startUpload

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.

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

Procedure

procedure · POST

Input

application/json

durationMs

integer

Advisory, non-authoritative duration used only for early failure; the authoritative probe runs asynchronously after upload.

height

integer

Advisory, non-authoritative height used only for early failure; the authoritative probe runs asynchronously after upload.

mimeType

requiredstring

Declared MIME type of the video.

  • minLength: 3
  • maxLength: 255

name

string

Optional client-provided file name.

  • maxLength: 256

sizeBytes

requiredinteger

Exact byte size of the complete upload-ready video file before it is split into parts.

  • minimum: 1

width

integer

Advisory, non-authoritative width used only for early failure; the authoritative probe runs asynchronously after upload.

Output

application/json

expiresAt

requiredstring · datetime

jobId

requiredstring
  • minLength: 1
  • maxLength: 256

partCount

requiredinteger

partSizeBytes

requiredinteger

Errors

UnsupportedContentType

The declared MIME type is not supported.

VideoTooLarge

The exact file size exceeds the per-file cap or remaining daily byte allowance.

VideoTooLong

The advisory declared duration exceeds the limit.

BadAspectRatio

The advisory declared dimensions have an unsupported aspect ratio.

DailyLimitExceeded

The daily video or byte allowance, including active reservations, is exhausted.

TooManyOpenUploads

The account has reached its open multipart upload limit.

UploadForbidden

The account is not permitted to upload video.

ServiceOverloaded

The service is draining, at capacity, or temporarily unable to create the multipart upload.

Similar lexicons

semantic match

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

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

  • place.stream.media.createUpload

    procedure not from the namespace authority

    Start a resumable upload of arbitrary media content. Returns a TUS upload URL and a short-lived bearer token used to authenticate subsequent chunk requests (no DPoP required on chunks). The DID of the authenticated user is recorded against the upload; on completion a VOD processing task is enqueued.