PeerTube

Send chunk for the resumable upload of a video

Live Test Server (live data - latest nightly version)

https://peertube2.cpy.re/api/v1

PUT

/videos/upload-resumable

VideoVideo Upload

Uses a resumable protocol to continue, pause or resume the upload of a video

Response Example

200 - Example 1

{
    "video": {
        "id": {},
        "shortUUID": {},
        "uuid": {}
    }
}

Request

Query Params

upload_id

string

required

Created session id to proceed with. If you didn't send chunks in the last 12 hours, it is
not valid anymore and you need to initialize a new upload.

Header Params

Content-Range

string

required

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first
262144 bytes (256 x 1024) in a 2,469,036 byte file.

Content-Length

number

required

Size of the chunk that the request is sending.

The chunk size must be a multiple of 256 KB, and unlike Google Resumable
doesn't mandate for chunks to have the same size throughout the upload sequence.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from
1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Body Params application/octet-stream

Not configured

Responses

🟢200last chunk received

application/json

Body

video

object

optional

object

optional

shortUUID

object

optional

uuid

object

optional

🔵308resume incomplete

🟠403video didn't pass upload filter

🟠404upload not found

🟠409chunk doesn't match range

🟠422video unreadable

🟠429too many concurrent requests

Modified at 2022-09-10 22:29:50

Initialize the resumable upload of a video

Delete a video