Video Upload

Send chunk for the resumable replacement of a video

PUT

https://peertube2.cpy.re/api/v1/videos/{id}/source/replace-resumable

PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video

curl -X PUT 'https://peertube2.cpy.re/api/v1/videos/42/source/replace-resumable?upload_id=string' \
  -H 'Content-Range: bytes 0-262143/2469036' \
  -H 'Content-Length: 262144' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch('https://peertube2.cpy.re/api/v1/videos/42/source/replace-resumable?upload_id=string', {
  method: 'PUT',
  headers: {
    'Content-Range': 'bytes 0-262143/2469036',
    'Content-Length': '262144',
    'Authorization': 'Bearer YOUR_TOKEN',
  },
});

const data = await response.text();

import requests

response = requests.put(
    'https://peertube2.cpy.re/api/v1/videos/42/source/replace-resumable?upload_id=string',
    headers={
        'Content-Range': 'bytes 0-262143/2469036',
        'Content-Length': '262144',
        'Authorization': 'Bearer YOUR_TOKEN',
    },
)
print(response.text)

Request Body

"<binary>"

Body

application/octet-stream

string<binary>

Parameters

idid | UUIDv4 | shortUUIDrequiredpath

The object id, uuid or short uuid

upload_idstringrequiredquery

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

Content-Rangestringrequiredheader

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.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Content-Lengthnumberrequiredheader

Size of the chunk that the request is sending.

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.

Response

204No Content

last chunk received: successful operation

308Permanent Redirect

resume incomplete

Response headers

Content-Lengthnumberheader

400Bad Request

chunk is smaller than client.videos.resumableUpload.minChunkSize of the server config or 1/10,000 of the file size (and is not the last one)

403Forbidden

video didn't pass file replacement filter

404Not Found

replace upload not found

409Conflict

chunk doesn't match range

422Unprocessable Entity

video unreadable

429Too Many Requests

too many concurrent requests

503Service Unavailable

upload is already being processed

Response headers

Authorization

OAuth2oauth2

Authenticating via OAuth requires the following steps:

Have an activated account
Generate an access token for that account at /api/v1/users/token.
Make requests with the Authorization: Bearer <token> header
Profit, depending on the role assigned to the account

Note that the access token is valid for 1 day and is given along with a refresh token valid for 2 weeks.

Docs by Sourcey