PeerTube (8.3.0)
Download OpenAPI specification:
URL: https://joinpeertube.org License: AGPLv3.0
The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite HTTP/REST library for your programming language to use PeerTube.
See the REST API quick start for a few examples of using the PeerTube API.
When you sign up for an account on a PeerTube instance, you are given the possibility to generate sessions on it, and authenticate there using an access token. Only one access token can currently be used at a time.
Accounts are given permissions based on their role. There are three roles on PeerTube: Administrator, Moderator, and User. See the roles guide for a detail of their permissions.
The API uses standard HTTP status codes to indicate the success or failure of the API call, completed by a RFC7807-compliant response body.
HTTP 1.1 404 Not Found
Content-Type: application/problem+json; charset=utf-8
{
"detail": "Video not found",
"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}
We provide error type (following RFC7807) and code (internal PeerTube code) values for a growing number of cases,
but it is still optional. Types are used to disambiguate errors that bear the same status code
and are non-obvious:
HTTP 1.1 403 Forbidden
Content-Type: application/problem+json; charset=utf-8
{
"detail": "Cannot get this video regarding follow constraints",
"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
"status": 403,
"title": "Forbidden",
"type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints"
}
Here a 403 error could otherwise mean that the video is private or blocklisted.
Example:
HTTP 1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8
{
"detail": "Incorrect request parameters: id",
"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
"instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180",
"invalid-params": {
"id": {
"location": "params",
"msg": "Invalid value",
"param": "id",
"value": "9c9de5e8-0a1e-484a-b099-e80766180"
}
},
"status": 400,
"title": "Bad Request",
"type": "about:blank"
}
Where id is the name of the field concerned by the error, within the route definition.
invalid-params.<field>.location can be either 'params', 'body', 'header', 'query' or 'cookies'.
invalid-params.<field>.value reports the value that didn't pass validation whose invalid-params.<field>.msg is about.
The requested remote resource cannot be accessed because the instance does not follow its origin.
Saving live replays is disabled on this instance, so a live cannot be created or updated with saveReplay enabled.
Not returned by PeerTube anymore: permanent lives can save replays.
The instance has reached its maximum number of simultaneous live streams.
The authentication or token request is malformed: missing grant_type, malformed Authorization header,
access token sent using more than one method, or sent in the query string.
The grant_type is not supported. PeerTube supports password and refresh_token.
The user requested an export including video files, but the total size of their videos is above the maximum allowed by the instance for such exports. Request an export without video files instead.
We are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators:
Endpoint (prefix: /api/v1) |
Calls | Time frame |
|---|---|---|
/* |
50 | 10 seconds |
POST /users/token |
15 | 5 minutes |
POST /users/register |
2* | 5 minutes |
POST /users/ask-send-verify-email |
3 | 5 minutes |
Depending on the endpoint, *failed requests are not taken into account. A service
limit is announced by a 429 Too Many Requests status code.
You can get details about the current state of your rate limit by reading the following headers:
| Header | Description |
|---|---|
X-RateLimit-Limit |
Number of max requests allowed in the current time period |
X-RateLimit-Remaining |
Number of remaining requests in the current time period |
X-RateLimit-Reset |
Timestamp of end of current time period as UNIX timestamp |
Retry-After |
Seconds to delay after the first 429 is received |
This API features Cross-Origin Resource Sharing (CORS), allowing cross-domain communication from the browser for some routes:
| Endpoint |
|------------------------- ---|
| /api/* |
| /download/* |
| /lazy-static/* |
| /.well-known/webfinger |
In addition, all routes serving ActivityPub are CORS-enabled for all origins.
Get private Web Video file
PeerTube >= 6.0
Authorizations:
OAuth2
path Parameters
| filename required | string Filename |
query Parameters
| videoFileToken | string Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header. |
Responses
Get private HLS video file
Authorizations:
OAuth2
path Parameters
| filename required | string Filename |
query Parameters
| reinjectVideoFileToken | boolean Ask the server to reinject videoFileToken in URLs in m3u8 playlist |
| videoFileToken | string Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header. |
Responses
Download video file
Generate a mp4 container that contains at most 1 video stream and at most 1 audio stream. Mainly used to merge the HLS audio only video file and the HLS video only resolution file.
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
query Parameters
| videoFileIds required | Array of integers streams of video files to mux in the output |
| videoFileToken | string Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header. |
Responses
Comments on videos feeds
path Parameters
| format required | string Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1" format expected (we focus on making |
query Parameters
| accountId | string limit listing comments to videos of a specific account |
| accountName | string limit listing comments to videos of a specific account |
| isLocal | boolean PeerTube >= 9.0 Display only comments of local or remote accounts |
| onLocalVideo | boolean PeerTube >= 9.0 Display only comments of local or remote videos |
| videoChannelId | string limit listing comments to videos of a specific video channel |
| videoChannelName | string limit listing comments to videos of a specific video channel |
| videoId | string limit listing comments to a specific video |
Responses
Response samples
- 200
Content type
<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>PeerTube Nightly</title> <link>https://peertube2.cpy.re</link> <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description> <lastBuildDate>Sat, 17 Oct 2026 03:04:00 GMT</lastBuildDate> <docs>https://validator.w3.org/feed/docs/rss2.html</docs> <generator>PeerTube - https://peertube2.cpy.re</generator> <image> <title>PeerTube Nightly</title> <url>https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png</url> <link>https://peertube2.cpy.re</link> </image> <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright> <atom:link href="https://peertube2.cpy.re/feeds/video-comments.xml?scope=local" rel="self" type="application/rss+xml"/> <item> <title><![CDATA[“Vous condamnez les violences ?“ - Rock'n'Roll_φapy 🔻]]></title> <link>https://peertube2.cpy.re/w/vpZPHveF4XoNGVx5363Bt3;threadId=195560</link> <guid>https://peertube2.cpy.re/w/vpZPHveF4XoNGVx5363Bt3;threadId=195560</guid> <pubDate>Fri, 16 Oct 2026 17:04:44 GMT</pubDate> <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/a/blast/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> Il me parait évident, si <a href="https://mastodon.social/tags/JLM" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>JLM</span></a> et <a href="https://mastodon.social/tags/LFI" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>LFI</span></a> l'emportent, qu'il faudra une commission d'enquête sur la répression du mouvement lycéen, avec à la clef la condamnation de *tous* les responsables, jusqu'au ministre, voire au delà. On a inculpé et jugé le Sarkopipo, essentiellement pour des délits financiers. On devrait pouvoir inculper, et *lourdement* condamner, NuNez, voire Macron, pour les dommages humains qu'ils ont délibérément provoqués, et leurs atteintes multiples à l'ordre démocratique.</p>]]></content:encoded> <dc:creator>Rock'n'Roll_φapy 🔻</dc:creator> </item> <item> <title><![CDATA[OVERGROWN - Blender Feature Film (Teaser) - Shakira]]></title> <link>https://peertube2.cpy.re/w/gaGB17Qu1F5tXZyXN6idEQ;threadId=195559</link> <guid>https://peertube2.cpy.re/w/gaGB17Qu1F5tXZyXN6idEQ;threadId=195559</guid> <pubDate>Fri, 16 Oct 2026 15:55:41 GMT</pubDate> <content:encoded><![CDATA[<p>Video not playing</p> ]]></content:encoded> <dc:creator>Shakira</dc:creator> </item> <item> <title><![CDATA[critical-making-community - ReparaturBau]]></title> <link>https://peertube2.cpy.re/w/grx1VwbjwRbG9yZTbZ6mh6;threadId=195558</link> <guid>https://peertube2.cpy.re/w/grx1VwbjwRbG9yZTbZ6mh6;threadId=195558</guid> <pubDate>Fri, 16 Oct 2026 12:51:07 GMT</pubDate> <content:encoded><![CDATA[<p><span><a href="https://tube.tchncs.de/a/vow/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>vow</span></a></span> </p><p>nächste Jahr sind wir (hoffentlich) auch dabei</p>]]></content:encoded> <dc:creator>ReparaturBau</dc:creator> </item> <item> <title><![CDATA[critical-making-community - Verbund offener Werkstätten]]></title> <link>https://peertube2.cpy.re/w/chuEowjQrSnXS8HFvAwUDg;threadId=195556</link> <guid>https://peertube2.cpy.re/w/chuEowjQrSnXS8HFvAwUDg;threadId=195556</guid> <pubDate>Fri, 16 Oct 2026 12:39:36 GMT</pubDate> <content:encoded><![CDATA[<p>@aiquez@troet.cafe na klar , was denkst du denn *-)</p> ]]></content:encoded> <dc:creator>Verbund offener Werkstätten</dc:creator> </item> <item> <title><![CDATA[critical-making-community - aiquez]]></title> <link>https://peertube2.cpy.re/w/chuEowjQrSnXS8HFvAwUDg;threadId=195556</link> <guid>https://peertube2.cpy.re/w/chuEowjQrSnXS8HFvAwUDg;threadId=195556</guid> <pubDate>Fri, 16 Oct 2026 12:34:42 GMT</pubDate> <content:encoded><![CDATA[<p><span><a href="https://tube.tchncs.de/a/vow/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>vow</span></a></span> </p><p>super, dass ihr so was macht ! </p><p>weiter so !</p>]]></content:encoded> <dc:creator>aiquez</dc:creator> </item> <item> <title><![CDATA[Framework Laptop 12 (2026) Review: The Linux MacBook Neo alternative? - boredsquirrel]]></title> <link>https://peertube2.cpy.re/w/xwshW4b2g36A9HVoL2bz4H;threadId=195554</link> <guid>https://peertube2.cpy.re/w/xwshW4b2g36A9HVoL2bz4H;threadId=195554</guid> <pubDate>Fri, 16 Oct 2026 12:29:07 GMT</pubDate> <content:encoded><![CDATA[<p><span><a href="https://tilvids.com/a/thelinuxexperiment/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>thelinuxexperiment</span></a></span></p><p>This laptop is for students so the main question is, how loud is the keyboard? A 12th gen Framework 13 is near unusable because of the tiny loud fan, good that they fixed that!</p><p>14h of batterylife with web streaming and video playback is pretty insane!</p><p>The thing with the mic at 100% is a missing internal <a href="https://tux.social/tags/alsa" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>alsa</span></a> / soundcard config afaik. Microphones should be good at 100%, but Linux distros lack most soundcard configs.</p><p>Someone correct me if I am wrong on the details there.</p>]]></content:encoded> <dc:creator>boredsquirrel</dc:creator> </item> <item> <title><![CDATA[critical-making-community - Verbund offener Werkstätten]]></title> <link>https://peertube2.cpy.re/w/grx1VwbjwRbG9yZTbZ6mh6;threadId=195555</link> <guid>https://peertube2.cpy.re/w/grx1VwbjwRbG9yZTbZ6mh6;threadId=195555</guid> <pubDate>Fri, 16 Oct 2026 12:21:03 GMT</pubDate> <content:encoded><![CDATA[<p>bald gibt es noch mehr videos aus dem #vow .. stay tuned #peertube4vow</p> ]]></content:encoded> <dc:creator>Verbund offener Werkstätten</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195544</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195544</guid> <pubDate>Fri, 16 Oct 2026 11:45:40 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam i had to dodge juuuust a bit earlier than i thought</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195537</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195537</guid> <pubDate>Fri, 16 Oct 2026 11:45:09 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam feels good, precise. lets fights feel very fair. my fault if i die.</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195546</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195546</guid> <pubDate>Fri, 16 Oct 2026 11:44:26 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam lolo i still get lost in the menu too. they're chatty XD</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195543</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195543</guid> <pubDate>Fri, 16 Oct 2026 11:43:35 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam haha that's ok, that's what VODs are for!</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Framework Laptop 12 (2026) Review: The Linux MacBook Neo alternative? - boredsquirrel]]></title> <link>https://peertube2.cpy.re/w/xwshW4b2g36A9HVoL2bz4H;threadId=195547</link> <guid>https://peertube2.cpy.re/w/xwshW4b2g36A9HVoL2bz4H;threadId=195547</guid> <pubDate>Fri, 16 Oct 2026 11:36:10 GMT</pubDate> <content:encoded><![CDATA[<p><span><a href="https://tilvids.com/a/thelinuxexperiment/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>thelinuxexperiment</span></a></span></p><p>Pretty cool laptop! I am not a fan of the plastic really, would prefer metal with plastic case that you can replace. But 900€ nowadays is pretty good I guess.</p><p>For me it just has too few ports. Their port system is kinda useless, just add more of them! My Chromebook has basically the same amount of them...</p><p>Also coreboot support would be huge, instead of giving laptops to fascists</p>]]></content:encoded> <dc:creator>boredsquirrel</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195546</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195546</guid> <pubDate>Fri, 16 Oct 2026 11:28:13 GMT</pubDate> <content:encoded><![CDATA[<p>i keep cracking up, you read a screen of text and go, "Yeah, okay!"</p> <p>And then you press enter and then ANOTHER screen comes up with a wall of text</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195545</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195545</guid> <pubDate>Fri, 16 Oct 2026 11:27:27 GMT</pubDate> <content:encoded><![CDATA[<p>it's very SotN, in a good way</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195544</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195544</guid> <pubDate>Fri, 16 Oct 2026 11:26:10 GMT</pubDate> <content:encoded><![CDATA[<p>well done adapting on that first boss</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195543</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195543</guid> <pubDate>Fri, 16 Oct 2026 11:26:05 GMT</pubDate> <content:encoded><![CDATA[<p>game is interesting...i'm watching it and it just makes me feel tired. I don't know if i have something like this in me right now lol</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</guid> <pubDate>Fri, 16 Oct 2026 11:25:22 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam i shouldn't need 25 mods for this one. XD</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - Nico198X]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</guid> <pubDate>Fri, 16 Oct 2026 11:24:52 GMT</pubDate> <content:encoded><![CDATA[<p>@didacticjam DEF! feels good to control while still having some of that Castlevania weight.</p> ]]></content:encoded> <dc:creator>Nico198X</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195538</guid> <pubDate>Fri, 16 Oct 2026 11:23:06 GMT</pubDate> <content:encoded><![CDATA[<p>you can almost feel that this is what bloodstained THOUHGT They were makign</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> <item> <title><![CDATA[Castlevania: Belmont's Curse (p1) - DidacticJam]]></title> <link>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195537</link> <guid>https://peertube2.cpy.re/w/uix3pqbMtqtBmJ6wZ5Gc4m;threadId=195537</guid> <pubDate>Fri, 16 Oct 2026 11:22:56 GMT</pubDate> <content:encoded><![CDATA[<p>game looks hella snappy</p> ]]></content:encoded> <dc:creator>DidacticJam</dc:creator> </item> </channel> </rss>
Common videos feeds
path Parameters
| format required | string Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1" format expected (we focus on making |
query Parameters
| accountId | string limit listing to a specific account |
| accountName | string limit listing to a specific account |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| sort | string Example: sort=-createdAt Sort column |
| videoChannelId | string limit listing to a specific video channel |
| videoChannelName | string limit listing to a specific video channel |
Responses
Response samples
- 200
Content type
<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" xmlns:podcast="https://podcastindex.org/namespace/1.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>PeerTube Nightly</title> <link>https://peertube2.cpy.re</link> <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description> <lastBuildDate>Sat, 17 Oct 2026 03:04:25 GMT</lastBuildDate> <docs>https://validator.w3.org/feed/docs/rss2.html</docs> <generator>PeerTube - https://peertube2.cpy.re</generator> <image> <title>PeerTube Nightly</title> <url>https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png</url> <link>https://peertube2.cpy.re</link> </image> <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright> <atom:link href="https://peertube2.cpy.re/feeds/videos.xml?scope=local" rel="self" type="application/rss+xml"/> <item> <title><![CDATA[Octobre 2026 - le Rékap' Jeux de société]]></title> <link>https://peertube2.cpy.re/w/9RG9daZwyiLgLZCLGaCSo2</link> <guid>https://peertube2.cpy.re/w/9RG9daZwyiLgLZCLGaCSo2</guid> <pubDate>Fri, 16 Oct 2026 21:46:09 GMT</pubDate> <description><![CDATA[Le Zla & Sesterio vous présentent leur rékap' mensuel avec les jeux qu’ils ont pu découvrir au cours des dernières semaines. 00:00:00 Intro 00:00:26 L'actu 00:09:33 Les jeux du mois 00:09:49 - djSet monte le son 00:16:11 - Guillotine ...]]></description> <content:encoded><![CDATA[<p>Le Zla & Sesterio vous présentent leur rékap' mensuel avec les jeux qu’ils ont pu découvrir au cours des dernières semaines.</p> <p>00:00:00 Intro<br /> 00:00:26 L'actu<br /> 00:09:33 Les jeux du mois<br /> 00:09:49 - djSet monte le son<br /> 00:16:11 - Guillotine<br /> 00:19:27 - Minikin City<br /> 00:25:56 - dnup<br /> 00:31:25 - mes trucs préférés<br /> 00:33:15 - Journey Horizon<br /> 00:34:24 - Life of the Amazonia<br /> 00:37:35 - Aurealis<br /> 00:42:58 - Tembo<br /> 00:47:00 Disgression : les règles de jeux<br /> 00:53:24 - Greun'z<br /> 01:00:27 - Tax the rich<br /> 01:03:59 - Odysseus<br /> 01:10:47 - Boss Fighters QR<br /> 01:11:12 - apparté : fantasy Reamls Mythes Grecs<br /> 01:12:02 - suite Boss Fighters<br /> 01:14:39 - DéfiCosmos<br /> 01:19:01 La Hype<br /> 01:24:12 Le Hors-jeux<br /> 01:24:41 - Ted Lasso Saison 4<br /> 01:26:30 - Friday Night lights<br /> 01:33:01 - The Gentlemen<br /> 01:35:25 Conclusion</p> <p>La prochaine GameNight, treizième édition, aura lieu le vendredi 04 Décembre 2026 ! Toutes les infos sont sur notre site : <a href="https://k-ludique.fr/" target="_blank" rel="noopener noreferrer">https://k-ludique.fr/</a></p> <p>Découvrez notre univers</p> <ul> <li>Jeux Politiks : <a href="https://www.youtube.com/shorts/y3wIUbneF9E" target="_blank" rel="noopener noreferrer">https://www.youtube.com/shorts/y3wIUbneF9E</a></li> <li>Le K du Coop : <a href="https://www.youtube.com/watch?v=bPS2dxIHNEs" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=bPS2dxIHNEs</a></li> </ul> <p>Rejoignez la communauté du K Ludique sur le site de notre partenaire <a href="https://kekosa.fr" target="_blank" rel="noopener noreferrer">https://kekosa.fr</a> gérez votre ludothèque et donnez votre avis sur vos jeux de société favoris et bien plus.</p> <p>Suivez-nous sur les réseaux sociaux :<br /> Discord : <a href="https://discord.gg/WffsxVX" target="_blank" rel="noopener noreferrer">https://discord.gg/WffsxVX</a><br /> Twitch : <a href="https://www.twitch.tv/lekludique" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/lekludique</a><br /> Facebook : <a href="https://www.facebook.com/LeKLudique/" target="_blank" rel="noopener noreferrer">https://www.facebook.com/LeKLudique/</a><br /> Instagram : <a href="https://www.instagram.com/lekludique/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/lekludique/</a><br /> TikTok : <a href="https://www.tiktok.com/@lekludique" target="_blank" rel="noopener noreferrer">https://www.tiktok.com/@lekludique</a></p> <p>#j2s #jeudesociété #jeux #jeudesociete #jds #boardgames</p> <p>Musique par Alex Kizenkov <a href="https://pixabay.com/users/alex_kizenkov-33612407/" target="_blank" rel="noopener noreferrer">https://pixabay.com/users/alex_kizenkov-33612407/</a></p> ]]></content:encoded> <dc:creator>Jeux de société - Le K Ludique</dc:creator> <category>Entertainment</category> <enclosure length="7707061407" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/47b94ac8-4a89-4fdb-9c00-b9764ad62435?videoFileIds=5944347"/> <media:community> <media:statistics views="0"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/9RG9daZwyiLgLZCLGaCSo2"/> <media:player url="https://peertube2.cpy.re/w/9RG9daZwyiLgLZCLGaCSo2"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ebc0d6c8-5365-4152-9af0-483fb5bbee00-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ff806177-2b18-4066-b7ae-58c738af0695-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ca233e29-9682-448c-9f3a-f9f944b39484-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2cd1ab47-c3d4-410f-9a3b-eadef2f27e71-480-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="240381258" url="https://videos.pair2jeux.tube/static/web-videos/0c44d66d-324d-4995-95b7-c0b2a3102513-0.mp4" framerate="0" duration="5981" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="7707061407" url="https://videos.pair2jeux.tube/static/streaming-playlists/hls/47b94ac8-4a89-4fdb-9c00-b9764ad62435/e58e6397-401f-402d-b769-9c0f793ee56b-1080-fragmented.mp4" framerate="60" duration="5981" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="1375656564" url="https://videos.pair2jeux.tube/static/streaming-playlists/hls/47b94ac8-4a89-4fdb-9c00-b9764ad62435/3dec14b7-fd0f-4cc4-b095-12c08250f649-720-fragmented.mp4" framerate="60" duration="5981" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="760485660" url="https://videos.pair2jeux.tube/static/streaming-playlists/hls/47b94ac8-4a89-4fdb-9c00-b9764ad62435/72775369-f0cc-4195-a86f-f5113a2cf2d2-480-fragmented.mp4" framerate="30" duration="5981" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/6d9bb167-8af1-4642-9eee-8417508da7ca.png" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Octobre 2026 - le Rékap' Jeux de société</media:title> <media:description type="plain">Le Zla & Sesterio vous présentent leur rékap' mensuel avec les jeux qu’ils ont pu découvrir au cours des dernières semaines. 00:00:00 Intro 00:00:26 L'actu 00:09:33 Les jeux du mois 00:09:49 - djSet monte le son 00:16:11 - Guillotine ...</media:description> </item> <item> <title><![CDATA[17 OCTOBRE : COMMENT MACRON TENTE DE POURRIR LA MANIFESTATION]]></title> <link>https://peertube2.cpy.re/w/2XkLkhBAX4AmfcfbMaUhRh</link> <guid>https://peertube2.cpy.re/w/2XkLkhBAX4AmfcfbMaUhRh</guid> <pubDate>Fri, 16 Oct 2026 20:10:38 GMT</pubDate> <description><![CDATA[SIGNEZ LA PÉTITION ! 👉 https://amnistie-lyceens.fr/ ⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 https://lmdtv.fr/capsur10k-youtube 00:00 : Macron tente de pourrir la manifestation 15:05 : Le Plan du RN et de Le Pen Emmanuel Macron s’in...]]></description> <content:encoded><![CDATA[<p>SIGNEZ LA PÉTITION ! 👉 <a href="https://amnistie-lyceens.fr/" target="_blank" rel="noopener noreferrer">https://amnistie-lyceens.fr/</a></p> <p>⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 <a href="https://lmdtv.fr/capsur10k-youtube" target="_blank" rel="noopener noreferrer">https://lmdtv.fr/capsur10k-youtube</a></p> <p>00:00 : Macron tente de pourrir la manifestation<br /> 15:05 : Le Plan du RN et de Le Pen</p> <p>Emmanuel Macron s’investit dans la mobilisation des lycéens, et pas pour leur bien mais le sien, on va en parler.</p> <p>Marine Le Pen prépare-t-elle un coup d’Etat ? C’est la question que l’on peut se poser après ses critiques contre le Conseil constitutionnel. Nils a mené l’enquête.</p> <p>C’est parti pour les Indiscrets.</p> <p>🔴 Soutenez le Média ! 👉 <a href="https://soutenez.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://soutenez.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> ⚠️ Le Média est également diffusé sur le canal 608 de la Freebox, sur le canal 257 de la Livebox (Orange) et sur le bouquet GRATUIT de l'application Molotov TV.</p> <p>Suivez Le Média sur sa seconde chaîne Youtube :<br /> 👉 <a href="https://www.youtube.com/@LeM%C3%A9dia24-7" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@LeMédia24-7</a></p> <p>👉 Pour recevoir les dernières actualités, le résumé de la semaine et être alerté des derniers programmes publiés du Média, directement dans votre boîte e-mail.<br /> <a href="https://newsletter.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://newsletter.lemediatv.fr</a></p> <p>▶ Soutenez Le Média :<br /> 👉 <a href="https://soutenez.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://soutenez.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> 👉 <a href="https://dons.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://dons.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> 👉 <a href="https://fr.tipeee.com/le-media" target="_blank" rel="noopener noreferrer">https://fr.tipeee.com/le-media</a> (CB - Paypal)</p> <p>✅ Suivez-nous :<br /> Instagram : <a href="https://www.instagram.com/lemedia_tv/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/lemedia_tv/</a><br /> Facebook : <a href="http://bit.ly/FacebookLeMedia" target="_blank" rel="noopener noreferrer">http://bit.ly/FacebookLeMedia</a><br /> BlueSky : <a href="https://bsky.app/profile/lemediatv.bsky.social" target="_blank" rel="noopener noreferrer">https://bsky.app/profile/lemediatv.bsky.social</a><br /> Youtube : <a href="http://bit.ly/YouTubeLeMedia" target="_blank" rel="noopener noreferrer">http://bit.ly/YouTubeLeMedia</a><br /> Peertube : <a href="https://video.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://video.lemediatv.fr</a><br /> Telegram : <a href="https://t.me/LeMediaOfficiel" target="_blank" rel="noopener noreferrer">https://t.me/LeMediaOfficiel</a><br /> TikTok : <a href="https://www.tiktok.com/@lemediatv" target="_blank" rel="noopener noreferrer">https://www.tiktok.com/@lemediatv</a></p> <p>Rejoignez la communauté des Socios !</p> ]]></content:encoded> <dc:creator>Le Média</dc:creator> <enclosure length="257693222" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/0fd339e9-ef92-4815-9315-d63dc5dd48ba?videoFileIds=5944228"/> <media:community> <media:statistics views="30"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/2XkLkhBAX4AmfcfbMaUhRh"/> <media:player url="https://peertube2.cpy.re/w/2XkLkhBAX4AmfcfbMaUhRh"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d5d11c78-e2c6-4d9b-97a8-c76a778cb52b-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/06b6f9a8-11a8-4739-ae5e-878961ca3d77-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6ded04ec-9ba5-4861-9486-3c01581eb04e-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a4e0538a-8240-482c-adb4-6bee671a65bd-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9df72af8-1bae-4edd-bfe4-9512b2a6c004-240-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="56004201" url="https://cdn.octos3.fr/peertube-mtv/web-videos/c801c0e4-2ebe-4c08-a1b1-bc045fb8415b-0.mp4" framerate="0" duration="1816" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="257693222" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/0fd339e9-ef92-4815-9315-d63dc5dd48ba/e70d8418-02a4-4c58-9171-b764425a55da-1080-fragmented.mp4" framerate="25" duration="1816" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="151093100" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/0fd339e9-ef92-4815-9315-d63dc5dd48ba/bcaf056b-5564-4f6b-989d-cc8babb927ec-720-fragmented.mp4" framerate="25" duration="1816" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="74596063" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/0fd339e9-ef92-4815-9315-d63dc5dd48ba/3a54de56-ddf2-4a8d-bc83-b342732f7c65-360-fragmented.mp4" framerate="25" duration="1816" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="55014682" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/0fd339e9-ef92-4815-9315-d63dc5dd48ba/d763c94f-61cb-4bed-a662-324037480ee8-240-fragmented.mp4" framerate="25" duration="1816" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/58ae7df8-831c-4996-992c-13450170775b.webp" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">17 OCTOBRE : COMMENT MACRON TENTE DE POURRIR LA MANIFESTATION</media:title> <media:description type="plain">SIGNEZ LA PÉTITION ! 👉 https://amnistie-lyceens.fr/ ⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 https://lmdtv.fr/capsur10k-youtube 00:00 : Macron tente de pourrir la manifestation 15:05 : Le Plan du RN et de Le Pen Emmanuel Macron s’in...</media:description> </item> <item> <title><![CDATA[The evolution of rebellion - from Spartacus to SPX6900]]></title> <link>https://peertube2.cpy.re/w/u21SqHPTTw1xWjnqkxjU4s</link> <guid>https://peertube2.cpy.re/w/u21SqHPTTw1xWjnqkxjU4s</guid> <pubDate>Fri, 16 Oct 2026 19:39:38 GMT</pubDate> <description><![CDATA[The evolution of rebellion - from Spartacus to SPX6900 To learn how the movement started, here’s the documentary that tells its story: https://tube.tchncs.de/w/rekd1aX4GyLH3hsyF22NLs Credits https://www.reddit.com/u/STPC_Visuals https://...]]></description> <content:encoded><![CDATA[<p>The evolution of rebellion - from Spartacus to SPX6900</p> <p>To learn how the movement started, here’s the documentary that tells its story:<br /> <a href="https://tube.tchncs.de/w/rekd1aX4GyLH3hsyF22NLs" target="_blank" rel="noopener noreferrer">https://tube.tchncs.de/w/rekd1aX4GyLH3hsyF22NLs</a></p> <p>Credits<br /> <a href="https://www.reddit.com/u/STPC_Visuals" target="_blank" rel="noopener noreferrer">https://www.reddit.com/u/STPC_Visuals</a><br /> <a href="https://x.com/STPC_Pro" target="_blank" rel="noopener noreferrer">https://x.com/STPC_Pro</a><br /> <a href="https://www.youtube.com/channel/UCWNWVnjDbbhDL8ufxIkfA1w" target="_blank" rel="noopener noreferrer">https://www.youtube.com/channel/UCWNWVnjDbbhDL8ufxIkfA1w</a></p> ]]></content:encoded> <dc:creator>aeon_kn channel</dc:creator> <category>Activism</category> <enclosure length="50904363" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/e2e4297b-f015-4eae-850b-f5a40b4daf38?videoFileIds=5944262"/> <media:community> <media:statistics views="4"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/u21SqHPTTw1xWjnqkxjU4s"/> <media:player url="https://peertube2.cpy.re/w/u21SqHPTTw1xWjnqkxjU4s"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/47276df5-8bc5-427a-9d3e-39cb5d59fb08-1080.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f350e495-d823-45d1-bb45-8a2a18a717d3-480.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f3d1cc1c-7d8c-4ff0-84ff-f1c302815f6b-360.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e8235b43-6d37-467f-8db4-3439dd92561d-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/fb3aad34-14aa-40cf-af5e-b5d3e9d7ec08-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b5eabc29-eced-415e-a976-4b16e7186cf2-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/270e3cae-3e71-4bc6-8c11-ebc8f6ed8227-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d04acb32-7aa3-4fad-a72c-082b5189e4d6-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="50904363" url="https://media.tube.tchncs.de/videos/5bdc1842-4dee-47fc-846d-55c2e233c908-1080.mp4" framerate="30" duration="149" isDefault="true"/> <media:content type="video/mp4" medium="video" height="480" fileSize="11932082" url="https://media.tube.tchncs.de/videos/c0c63aab-20a9-496c-8c5d-020c01cde3d5-480.mp4" framerate="30" duration="149" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="8856504" url="https://media.tube.tchncs.de/videos/d7975b09-7824-45eb-a57b-c83a11169ecb-360.mp4" framerate="30" duration="149" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="2411307" url="https://media.tube.tchncs.de/videos/a60adac6-de83-4877-ab1c-20757597b4c3-0.mp4" framerate="0" duration="149" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="50842641" url="https://media.tube.tchncs.de/streaming-playlists/hls/e2e4297b-f015-4eae-850b-f5a40b4daf38/aca0ab76-ee3c-45d1-8562-702e553f85fd-1080-fragmented.mp4" framerate="30" duration="149" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="11867276" url="https://media.tube.tchncs.de/streaming-playlists/hls/e2e4297b-f015-4eae-850b-f5a40b4daf38/f4fb3d0f-89bb-4696-831b-84cda9901c08-480-fragmented.mp4" framerate="30" duration="149" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="8792050" url="https://media.tube.tchncs.de/streaming-playlists/hls/e2e4297b-f015-4eae-850b-f5a40b4daf38/46a712d2-89fe-40a5-a2bd-d45c437a7b0b-360-fragmented.mp4" framerate="30" duration="149" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="2417301" url="https://media.tube.tchncs.de/streaming-playlists/hls/e2e4297b-f015-4eae-850b-f5a40b4daf38/ca89ede2-9334-4379-baae-fe0c60bd24dd-0-fragmented.mp4" framerate="0" duration="149" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/a3de9c8c-12ee-45c9-a5ca-29706c95d241.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">The evolution of rebellion - from Spartacus to SPX6900</media:title> <media:description type="plain">The evolution of rebellion - from Spartacus to SPX6900 To learn how the movement started, here’s the documentary that tells its story: https://tube.tchncs.de/w/rekd1aX4GyLH3hsyF22NLs Credits https://www.reddit.com/u/STPC_Visuals https://...</media:description> </item> <item> <title><![CDATA[Deus Ex Machina - SPX6900]]></title> <link>https://peertube2.cpy.re/w/2wHW8NpBRJ7RMayRm6WJ36</link> <guid>https://peertube2.cpy.re/w/2wHW8NpBRJ7RMayRm6WJ36</guid> <pubDate>Fri, 16 Oct 2026 19:21:33 GMT</pubDate> <description><![CDATA[A lot of time in the making Enjoy my friends ! And let me know what you thought of it. 😃 ❤️ Credits: https://www.reddit.com/user/STPC_Visuals/]]></description> <content:encoded><![CDATA[<p>A lot of time in the making</p> <p>Enjoy my friends ! And let me know what you thought of it. 😃 ❤️</p> <p>Credits:<br /> <a href="https://www.reddit.com/user/STPC_Visuals/" target="_blank" rel="noopener noreferrer">https://www.reddit.com/user/STPC_Visuals/</a></p> ]]></content:encoded> <dc:creator>aeon_kn channel</dc:creator> <category>Activism</category> <enclosure length="38879268" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/0c634b4a-9a08-404f-9177-eba90b800fe1?videoFileIds=5944234"/> <media:community> <media:statistics views="10"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/2wHW8NpBRJ7RMayRm6WJ36"/> <media:player url="https://peertube2.cpy.re/w/2wHW8NpBRJ7RMayRm6WJ36"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/36d5ca7b-1b96-43d6-9c3c-c93dfdd0a0c2-720.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0969dc92-73ae-4c59-9a03-b4e36f8c97d7-480.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/95ab6cfb-e6ac-4f73-8734-fd368b04d5ef-360.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a3819d81-0193-46ab-a6f4-b740b075ade7-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/64122d50-2cea-4b6a-9e9a-35c9ce8029ab-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4ca15be1-7f55-44ee-bd12-7da74adf87da-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/16928bee-7c24-44cd-9d65-ec065e9511a4-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4837db18-0a8e-452f-9921-c5bc116a5a35-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="38879268" url="https://media.tube.tchncs.de/videos/93899cdc-fce9-4d4c-91aa-e94b2119df39-720.mp4" framerate="30" duration="173" isDefault="true"/> <media:content type="video/mp4" medium="video" height="480" fileSize="24136060" url="https://media.tube.tchncs.de/videos/e49e5c38-3729-4685-91cf-10fb7f9aceca-480.mp4" framerate="30" duration="173" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="17382623" url="https://media.tube.tchncs.de/videos/3291d058-d830-4edd-a18a-21a0db800bff-360.mp4" framerate="30" duration="173" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="2844937" url="https://media.tube.tchncs.de/videos/79a66b3f-ca66-4db2-bd29-0417af8bd551-0.mp4" framerate="0" duration="173" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="38798598" url="https://media.tube.tchncs.de/streaming-playlists/hls/0c634b4a-9a08-404f-9177-eba90b800fe1/f5f5e712-c43a-481d-981f-988d0afbf6da-720-fragmented.mp4" framerate="30" duration="173" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="24063242" url="https://media.tube.tchncs.de/streaming-playlists/hls/0c634b4a-9a08-404f-9177-eba90b800fe1/ecd3a6e7-c148-403a-b05f-22128f818f5b-480-fragmented.mp4" framerate="30" duration="173" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="17309133" url="https://media.tube.tchncs.de/streaming-playlists/hls/0c634b4a-9a08-404f-9177-eba90b800fe1/fcc3313a-1c3e-4bb1-bae7-160a0efb2e97-360-fragmented.mp4" framerate="30" duration="173" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="2851891" url="https://media.tube.tchncs.de/streaming-playlists/hls/0c634b4a-9a08-404f-9177-eba90b800fe1/b21301ae-43d7-4b40-b04b-5171ec3b3292-0-fragmented.mp4" framerate="0" duration="173" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/49f358af-ebbc-4aee-8af0-b291734853cd.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Deus Ex Machina - SPX6900</media:title> <media:description type="plain">A lot of time in the making Enjoy my friends ! And let me know what you thought of it. 😃 ❤️ Credits: https://www.reddit.com/user/STPC_Visuals/</media:description> </item> <item> <title><![CDATA[Clinique Design #2]]></title> <link>https://peertube2.cpy.re/w/icX3F3P3BdJhSfhBMyvGr8</link> <guid>https://peertube2.cpy.re/w/icX3F3P3BdJhSfhBMyvGr8</guid> <pubDate>Fri, 16 Oct 2026 19:01:06 GMT</pubDate> <dc:creator>Vidéos de l'association Designers Ethiques</dc:creator> <enclosure length="1101496712" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/8b567648-cdf7-4928-b57a-f9c4dc6b6db9?videoFileIds=5944222&videoFileIds=5944224"/> <media:community> <media:statistics views="2"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/icX3F3P3BdJhSfhBMyvGr8"/> <media:player url="https://peertube2.cpy.re/w/icX3F3P3BdJhSfhBMyvGr8"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9e79bdcd-a039-454f-b958-f6d89047afa6-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/16b8b475-8fb4-4726-a5c7-4325e86ef813-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/021b62ec-9332-432f-aeb5-03bf81296a56-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="1046200837" url="https://pt-storage.designersethiques.org/streaming-playlists:hls/8b567648-cdf7-4928-b57a-f9c4dc6b6db9/f9792f63-463a-4d00-9d58-25da17b10cf9-720-fragmented.mp4" framerate="30" duration="3379" isDefault="true"/> <media:content type="video/mp4" medium="video" height="360" fileSize="371414915" url="https://pt-storage.designersethiques.org/streaming-playlists:hls/8b567648-cdf7-4928-b57a-f9c4dc6b6db9/26566a5e-a253-4ea1-b92a-ea28cdf9fc71-360-fragmented.mp4" framerate="30" duration="3379" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="55295875" url="https://pt-storage.designersethiques.org/streaming-playlists:hls/8b567648-cdf7-4928-b57a-f9c4dc6b6db9/a61d676a-b3b8-4404-b599-7258679c786b-0-fragmented.mp4" framerate="0" duration="3379" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/875ee2d2-b942-4781-aeeb-cb3dfffd091c.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Clinique Design #2</media:title> </item> <item> <title><![CDATA[Piketty choque Apolline de Malherbe sur la situation économique de la France]]></title> <link>https://peertube2.cpy.re/w/kyFMNdYpsJBeLMEHajFZru</link> <guid>https://peertube2.cpy.re/w/kyFMNdYpsJBeLMEHajFZru</guid> <pubDate>Fri, 16 Oct 2026 18:00:25 GMT</pubDate> <description><![CDATA[Thomas Piketty, économiste, directeur d’études à l’EHESS, est invité sur BFM pour parler de dette publique, d'impôts, de démocratie. Il explique en quoi la situation économique de la France actuelle ressemble à la France de 1789 : un endettement é...]]></description> <content:encoded><![CDATA[<p>Thomas Piketty, économiste, directeur d’études à l’EHESS, est invité sur BFM pour parler de dette publique, d'impôts, de démocratie. Il explique en quoi la situation économique de la France actuelle ressemble à la France de 1789 : un endettement étatique énorme pour ne pas taxer les plus riches.</p> <p>Réduire la qualité de la vidéo.</p> <p>Pour changer le système<br /> Réclamer le RIC constituant : <a href="https://www.mouvement-constituant-populaire.fr/" target="_blank" rel="noopener noreferrer">https://www.mouvement-constituant-populaire.fr/</a><br /> Changer de banque: <a href="https://www.lanef.com/" target="_blank" rel="noopener noreferrer">https://www.lanef.com/</a> <a href="https://change-de-banque.org/particulier/" target="_blank" rel="noopener noreferrer">https://change-de-banque.org/particulier/</a><br /> Passer à l'action militante: <a href="https://extinctionrebellion.fr/" target="_blank" rel="noopener noreferrer">https://extinctionrebellion.fr/</a> <a href="https://ripostealimentaire.fr/" target="_blank" rel="noopener noreferrer">https://ripostealimentaire.fr/</a><br /> Changer de travail : <a href="https://jobs.makesense.org/fr" target="_blank" rel="noopener noreferrer">https://jobs.makesense.org/fr</a></p> <p>Sources<br /> Piketty <a href="https://www.youtube.com/watch?v=naYuWY4LQ7c&si=VhsuIyuerNqzACmr" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=naYuWY4LQ7c&si=VhsuIyuerNqzACmr</a><br /> Musique <a href="https://www.youtube.com/watch?v=39PVEaSytpo" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=39PVEaSytpo</a></p> <p>Réponses au quiz de fin :</p> <p>/!\ Description à ne pas lire avant d'avoir vu la vidéo entièrement<br /> /!\</p> <p>/!\<br /> /!\<br /> /!\</p> <p>Quand a-t-on vu un niveau de dette aussi élevé dans l'histoire de France ?<br /> 1945, 1789, 1920.</p> <p>Quelle a été l'évolution des patrimoines privés entre 1970 et aujourd'hui ?<br /> 300% du PIB à 600% du PIB.</p> <p>Combien y a-t-il eu de référendums entre 1945 et 2005 ?<br /> 13. Un tous les 3/4 ans.</p> <p>#piketty #politique #économie #impôt #taxe #extrait #ethiqueettac</p> ]]></content:encoded> <dc:creator>ethique_et_tac</dc:creator> <enclosure length="129694697" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/9e6df4d6-3860-4853-b69f-bb5c55653ce2?videoFileIds=5944157"/> <media:community> <media:statistics views="25"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/kyFMNdYpsJBeLMEHajFZru"/> <media:player url="https://peertube2.cpy.re/w/kyFMNdYpsJBeLMEHajFZru"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bdb6fafe-c81b-40e7-967d-7ca5f5a3924d-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/503452a6-065e-4b03-999f-26ee024674a1-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a0734554-3b0b-4d91-b114-1af888365e0e-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/333a8d15-3928-486d-b458-d6744adab770-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c54c515e-86f3-4213-9ce4-e9d4e18d972d-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/255a3760-6a72-47ee-9893-d54e695eb85a-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="17994216" url="https://static.indymotion.fr/web-videos/bd081838-9e83-423f-a8c2-6ad56a3686c4-0.mp4" framerate="0" duration="563" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="129694697" url="https://static.indymotion.fr/streaming-playlists/hls/9e6df4d6-3860-4853-b69f-bb5c55653ce2/670226e2-344a-41ff-970a-021a231a17a3-1080-fragmented.mp4" framerate="25" duration="563" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="76259595" url="https://static.indymotion.fr/streaming-playlists/hls/9e6df4d6-3860-4853-b69f-bb5c55653ce2/29ebb523-bf8a-489f-820e-bb7b8f3df0f2-720-fragmented.mp4" framerate="25" duration="563" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="46195859" url="https://static.indymotion.fr/streaming-playlists/hls/9e6df4d6-3860-4853-b69f-bb5c55653ce2/c290f8aa-a190-41cc-ba98-7d38ee4c0ed1-480-fragmented.mp4" framerate="25" duration="563" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="22209035" url="https://static.indymotion.fr/streaming-playlists/hls/9e6df4d6-3860-4853-b69f-bb5c55653ce2/6cb303c8-75c4-469b-bbad-fd0ae52cd46c-240-fragmented.mp4" framerate="25" duration="563" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="9247371" url="https://static.indymotion.fr/streaming-playlists/hls/9e6df4d6-3860-4853-b69f-bb5c55653ce2/63431f27-82ba-45a6-8052-0dc3962d4322-0-fragmented.mp4" framerate="0" duration="563" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/938787fa-c372-47c6-b602-d56297682de6.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Piketty choque Apolline de Malherbe sur la situation économique de la France</media:title> <media:description type="plain">Thomas Piketty, économiste, directeur d’études à l’EHESS, est invité sur BFM pour parler de dette publique, d'impôts, de démocratie. Il explique en quoi la situation économique de la France actuelle ressemble à la France de 1789 : un endettement é...</media:description> </item> <item> <title><![CDATA[👻 BGS - I'm on Observation Duty 6 : UNIVERSITY 📹]]></title> <link>https://peertube2.cpy.re/w/nCkM4AXZW1JHUDd1doKqaK</link> <guid>https://peertube2.cpy.re/w/nCkM4AXZW1JHUDd1doKqaK</guid> <pubDate>Fri, 16 Oct 2026 18:00:10 GMT</pubDate> <description><![CDATA[⚠️ CW / TW : Trucs glauques, chuchotements, jumpscares, nudité. Hésite pas à : 💖 Liker 💬 Commenter 📱 Partager 🌈 Me suivre ici ou sur mes réseaux ! Le jeu est dispo sur steam : https://store.steampowered.com/app/2137700/Im_on_Observation_Du...]]></description> <content:encoded><![CDATA[<p>⚠️ CW / TW : Trucs glauques, chuchotements, jumpscares, nudité.</p> <p>Hésite pas à : 💖 Liker 💬 Commenter 📱 Partager 🌈 Me suivre ici ou sur mes réseaux !<br /> Le jeu est dispo sur steam : <a href="https://store.steampowered.com/app/2137700/Im_on_Observation_Duty_6/" target="_blank" rel="noopener noreferrer">https://store.steampowered.com/app/2137700/Im_on_Observation_Duty_6/</a></p> <p>𝑴𝒆𝒔 𝒍𝒊𝒆𝒏𝒔</p> <p>💌 Ma boîte à lettres : <a href="https://tally.so/r/mR6a29" target="_blank" rel="noopener noreferrer">https://tally.so/r/mR6a29</a><br /> 🌙 Carrd et autres projets : <a href="https://lukyaspyndell.carrd.co/" target="_blank" rel="noopener noreferrer">https://lukyaspyndell.carrd.co/</a></p> ]]></content:encoded> <dc:creator>Lady Boo 👻</dc:creator> <category>Gaming</category> <enclosure length="480894294" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/af22e023-e6e0-4359-8753-18188b80042d?videoFileIds=5944194"/> <media:community> <media:statistics views="1"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/nCkM4AXZW1JHUDd1doKqaK"/> <media:player url="https://peertube2.cpy.re/w/nCkM4AXZW1JHUDd1doKqaK"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c79626e2-f4af-4c83-9430-cf42b8dadf4b-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b655e73e-f42c-4c7d-9951-c978e26514ac-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7a0e70e8-f394-4679-bc2b-43cf86cf22e2-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/331c3b91-5ea7-41db-b57f-f8736a6a880c-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/57798f3e-7adf-477a-8b15-cc7c40f2d34c-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2c1be865-6976-41dc-94a9-ac31959c1ec0-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="72047095" url="https://static.indymotion.fr/web-videos/e6fbf412-dfb9-461a-8b8c-a228f959414a-0.mp4" framerate="0" duration="2979" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="480894294" url="https://static.indymotion.fr/streaming-playlists/hls/af22e023-e6e0-4359-8753-18188b80042d/06f722ff-43cf-463e-9c5d-321a9607c1f3-1080-fragmented.mp4" framerate="30" duration="2979" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="214165201" url="https://static.indymotion.fr/streaming-playlists/hls/af22e023-e6e0-4359-8753-18188b80042d/b1d6a43e-7bbf-489b-8473-914ef3ca9829-720-fragmented.mp4" framerate="30" duration="2979" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="135347598" url="https://static.indymotion.fr/streaming-playlists/hls/af22e023-e6e0-4359-8753-18188b80042d/c4cde071-fc18-4977-83cc-2cbb07d01fc6-480-fragmented.mp4" framerate="30" duration="2979" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="76531977" url="https://static.indymotion.fr/streaming-playlists/hls/af22e023-e6e0-4359-8753-18188b80042d/a063d47b-7ed7-47a9-97bc-07e9aa98664d-240-fragmented.mp4" framerate="30" duration="2979" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="43173908" url="https://static.indymotion.fr/streaming-playlists/hls/af22e023-e6e0-4359-8753-18188b80042d/8ae19dba-8cc6-45df-9822-844b98391648-0-fragmented.mp4" framerate="0" duration="2979" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/9b84b15f-0921-4a4c-8dae-ebc2af3b5f37.png" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">👻 BGS - I'm on Observation Duty 6 : UNIVERSITY 📹</media:title> <media:description type="plain">⚠️ CW / TW : Trucs glauques, chuchotements, jumpscares, nudité. Hésite pas à : 💖 Liker 💬 Commenter 📱 Partager 🌈 Me suivre ici ou sur mes réseaux ! Le jeu est dispo sur steam : https://store.steampowered.com/app/2137700/Im_on_Observation_Du...</media:description> </item> <item> <title><![CDATA[LYCÉENS, GILETS JAUNES : POURQUOI L'ÉMEUTE NOUS TRANSFORME]]></title> <link>https://peertube2.cpy.re/w/nNk8Ad65hTurAYZywe2t7S</link> <guid>https://peertube2.cpy.re/w/nNk8Ad65hTurAYZywe2t7S</guid> <pubDate>Fri, 16 Oct 2026 17:40:35 GMT</pubDate> <description><![CDATA[SIGNEZ LA PÉTITION ! 👉 https://amnistie-lyceens.fr/ ⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 https://lmdtv.fr/capsur10k-youtube Depuis plusieurs semaines, les lycéens sont dans la rue. Ils dénoncent le manque de moyens dans leurs étab...]]></description> <content:encoded><![CDATA[<p>SIGNEZ LA PÉTITION ! 👉 <a href="https://amnistie-lyceens.fr/" target="_blank" rel="noopener noreferrer">https://amnistie-lyceens.fr/</a></p> <p>⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 <a href="https://lmdtv.fr/capsur10k-youtube" target="_blank" rel="noopener noreferrer">https://lmdtv.fr/capsur10k-youtube</a></p> <p>Depuis plusieurs semaines, les lycéens sont dans la rue. Ils dénoncent le manque de moyens dans leurs établissements, les conditions d’études et le manque de professeurs. Et leur colère ne retombe pas.<br /> Samedi 17 octobre, un nouvel appel à la mobilisation est lancé. Les colères des jeunes, celle des travailleurs, celle de ceux qui n’arrivent plus à boucler leurs fins de mois semblent finir par se rejoindre. <br /> Mais quand la colère déborde, que se passe-t-il ? Pourquoi certains choisissent-ils le blocage, l’affrontement, parfois la confrontation avec la police ? Et qu’est-ce que ces moments disent de notre société ?<br /> C’est justement ce que cherche à comprendre Romain Huët dans son livre Le vertige de l’émeute. Il s’intéresse à ce que vivent celles et ceux qui se révoltent. À leur colère, à leur peur, mais aussi à ce sentiment de force collective qu’ils peuvent éprouver dans la rue.<br /> Alors, est-ce que l’émeute est seulement une explosion de colère ? Est-ce qu’elle peut faire bouger les lignes ? Et surtout, comment passer de la révolte à un véritable changement politique ?<br /> On en parle avec Romain Huët, chercheur et maitre de conferences en science de la communication à l’université Rennes 2. Il anime également Cracker l’époque, le podcast des imaginaires politiques.</p> <p>🔴 Soutenez le Média ! 👉 <a href="https://soutenez.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://soutenez.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> ⚠️ Le Média est également diffusé sur le canal 608 de la Freebox, sur le canal 257 de la Livebox (Orange) et sur le bouquet GRATUIT de l'application Molotov TV.</p> <p>Suivez Le Média sur sa seconde chaîne Youtube :<br /> 👉 <a href="https://www.youtube.com/@LeM%C3%A9dia24-7" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@LeMédia24-7</a></p> <p>👉 Pour recevoir les dernières actualités, le résumé de la semaine et être alerté des derniers programmes publiés du Média, directement dans votre boîte e-mail.<br /> <a href="https://newsletter.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://newsletter.lemediatv.fr</a></p> <p>▶ Soutenez Le Média :<br /> 👉 <a href="https://soutenez.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://soutenez.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> 👉 <a href="https://dons.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://dons.lemediatv.fr</a> (CB - SEPA - Chèque)<br /> 👉 <a href="https://fr.tipeee.com/le-media" target="_blank" rel="noopener noreferrer">https://fr.tipeee.com/le-media</a> (CB - Paypal)</p> <p>✅ Suivez-nous :<br /> Instagram : <a href="https://www.instagram.com/lemedia_tv/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/lemedia_tv/</a><br /> Facebook : <a href="http://bit.ly/FacebookLeMedia" target="_blank" rel="noopener noreferrer">http://bit.ly/FacebookLeMedia</a><br /> BlueSky : <a href="https://bsky.app/profile/lemediatv.bsky.social" target="_blank" rel="noopener noreferrer">https://bsky.app/profile/lemediatv.bsky.social</a><br /> Youtube : <a href="http://bit.ly/YouTubeLeMedia" target="_blank" rel="noopener noreferrer">http://bit.ly/YouTubeLeMedia</a><br /> Peertube : <a href="https://video.lemediatv.fr" target="_blank" rel="noopener noreferrer">https://video.lemediatv.fr</a><br /> Telegram : <a href="https://t.me/LeMediaOfficiel" target="_blank" rel="noopener noreferrer">https://t.me/LeMediaOfficiel</a><br /> TikTok : <a href="https://www.tiktok.com/@lemediatv" target="_blank" rel="noopener noreferrer">https://www.tiktok.com/@lemediatv</a></p> <p>Rejoignez la communauté des Socios !</p> ]]></content:encoded> <dc:creator>Le Média</dc:creator> <enclosure length="303518674" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/b087ea43-5b77-4879-aa41-505fb04aaf92?videoFileIds=5944121"/> <media:community> <media:statistics views="24"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/nNk8Ad65hTurAYZywe2t7S"/> <media:player url="https://peertube2.cpy.re/w/nNk8Ad65hTurAYZywe2t7S"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3ca8178d-44f8-4efd-89e1-5b587e7ff4e2-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/623b5fba-322b-4d8f-b046-a0759045c5a5-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9fd2014a-bc59-4e8a-a709-ba5c868432d9-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ecec6a7d-5f96-45f9-8160-369f77e68ff2-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3e506978-6e00-4853-af78-440ed291febd-240-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="62135549" url="https://cdn.octos3.fr/peertube-mtv/web-videos/1b2b8478-e5cb-4235-8678-8282af10cd1a-0.mp4" framerate="0" duration="1942" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="303518674" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/b087ea43-5b77-4879-aa41-505fb04aaf92/74a053e9-9db0-4fd6-975a-de291a68ab7e-1080-fragmented.mp4" framerate="25" duration="1942" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="188102127" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/b087ea43-5b77-4879-aa41-505fb04aaf92/49ae8753-b323-480b-a760-3bc0f3acb23f-720-fragmented.mp4" framerate="25" duration="1942" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="92435666" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/b087ea43-5b77-4879-aa41-505fb04aaf92/31def19a-5cf6-4526-8ab0-8485a23ac663-360-fragmented.mp4" framerate="25" duration="1942" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="66745629" url="https://cdn.octos3.fr/peertube-mtv/streaming-playlists/hls/b087ea43-5b77-4879-aa41-505fb04aaf92/e1b1df15-28c8-4df8-8f9b-65e5ead47ee6-240-fragmented.mp4" framerate="25" duration="1942" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/827496b5-761b-4c10-bc01-3028cae439d0.webp" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">LYCÉENS, GILETS JAUNES : POURQUOI L'ÉMEUTE NOUS TRANSFORME</media:title> <media:description type="plain">SIGNEZ LA PÉTITION ! 👉 https://amnistie-lyceens.fr/ ⚠️ SAUVEZ LE MÉDIA, DEVENEZ DONATEUR MENSUEL : 👉 https://lmdtv.fr/capsur10k-youtube Depuis plusieurs semaines, les lycéens sont dans la rue. Ils dénoncent le manque de moyens dans leurs étab...</media:description> </item> <item> <title><![CDATA[LITTLE LION MEET SETKA - BE CAREFUL (2017)]]></title> <link>https://peertube2.cpy.re/w/vZUp5TLUQvmMqZA8BBDsgu</link> <guid>https://peertube2.cpy.re/w/vZUp5TLUQvmMqZA8BBDsgu</guid> <pubDate>Fri, 16 Oct 2026 17:16:36 GMT</pubDate> <description><![CDATA[Premier extrait de la collaboration "Little Lion meet Setka", deux artistes alliant Rub a dub, Hip hop et leur propre univers à suivre de très près... REAL VIBES !!! Real : Mani vision rec/mix : Conçu pour durer Big up à l'Art Seine et Yed...]]></description> <content:encoded><![CDATA[<p>Premier extrait de la collaboration "Little Lion meet Setka", deux artistes alliant Rub a dub, Hip hop et leur propre univers à suivre de très près... REAL VIBES !!!</p> <p>Real : Mani vision<br /> rec/mix : Conçu pour durer</p> <p>Big up à l'Art Seine et Yedi..</p> ]]></content:encoded> <dc:creator>Setka official</dc:creator> <enclosure length="10562868" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/f2eeb51b-54e3-4a0c-9665-9d3ad73a3cc2?videoFileIds=5944175&videoFileIds=5944174"/> <media:community> <media:statistics views="2"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/vZUp5TLUQvmMqZA8BBDsgu"/> <media:player url="https://peertube2.cpy.re/w/vZUp5TLUQvmMqZA8BBDsgu"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/daf88cde-0f50-4c9c-a4d5-90104871798f-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9462e83c-6e6f-4379-bf40-89b1eb982b06-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5f38911f-9838-40f9-b488-c6f666599cbe-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/66ec5c63-2539-4d47-bd36-5d98125682c1-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="2842148" url="https://video.antopie.org/static/web-videos/aa258561-cc48-4915-96bf-6bff8e366155-0.mp4" framerate="0" duration="179" isDefault="true"/> <media:content type="video/mp4" medium="video" height="360" fileSize="7720720" url="https://video.antopie.org/static/streaming-playlists/hls/f2eeb51b-54e3-4a0c-9665-9d3ad73a3cc2/958f0007-af43-4773-af51-971bd7186f8a-360-fragmented.mp4" framerate="30" duration="179" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="4578040" url="https://video.antopie.org/static/streaming-playlists/hls/f2eeb51b-54e3-4a0c-9665-9d3ad73a3cc2/19c1b097-3e36-4541-94fa-955128674045-240-fragmented.mp4" framerate="30" duration="179" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="3026065" url="https://video.antopie.org/static/streaming-playlists/hls/f2eeb51b-54e3-4a0c-9665-9d3ad73a3cc2/de1dde42-5b6f-4e77-92d3-3072e73ea1b6-0-fragmented.mp4" framerate="0" duration="179" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/d68e33ec-ba1f-4026-88a9-32f93c0b7aa6.png" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">LITTLE LION MEET SETKA - BE CAREFUL (2017)</media:title> <media:description type="plain">Premier extrait de la collaboration "Little Lion meet Setka", deux artistes alliant Rub a dub, Hip hop et leur propre univers à suivre de très près... REAL VIBES !!! Real : Mani vision rec/mix : Conçu pour durer Big up à l'Art Seine et Yed...</media:description> </item> <item> <title><![CDATA[LITTLE LION MEET SETKA - DANS LA VILLE (2018)]]></title> <link>https://peertube2.cpy.re/w/7YAZNpwhYBJ94KyUJ54UN5</link> <guid>https://peertube2.cpy.re/w/7YAZNpwhYBJ94KyUJ54UN5</guid> <pubDate>Fri, 16 Oct 2026 17:03:37 GMT</pubDate> <description><![CDATA[2ème extrait de la collaboration "Little lion meet Setka" !!! Deux artistes alliant Rub a dub, Hip hop et leurs propres influences à suivre de très près... STAY TUNED PEOPLE ! Real : Mani vision Mise en scène : Da system Rec : Conçu pour d...]]></description> <content:encoded><![CDATA[<p>2ème extrait de la collaboration "Little lion meet Setka" !!!</p> <p>Deux artistes alliant Rub a dub, Hip hop et leurs propres influences à suivre de très près... STAY TUNED PEOPLE !</p> <p>Real : Mani vision<br /> Mise en scène : Da system<br /> Rec : Conçu pour durer</p> <p>Merci à Jason Katsenis</p> ]]></content:encoded> <dc:creator>Setka official</dc:creator> <enclosure length="17031806" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/387e0ceb-bfc8-4399-9c21-65b7711292b8?videoFileIds=5944167&videoFileIds=5944166"/> <media:community> <media:statistics views="1"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/7YAZNpwhYBJ94KyUJ54UN5"/> <media:player url="https://peertube2.cpy.re/w/7YAZNpwhYBJ94KyUJ54UN5"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/374d0073-8bbb-4659-8648-2e1e1e03b0c3-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9dc06909-a9de-45a6-9432-b4a95404d8da-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a83d0b80-9b63-43c5-839f-45bdc48b2d94-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/15ed7e10-28ad-4c64-8a1e-ebc3b933f3b3-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="3796980" url="https://video.antopie.org/static/web-videos/185147b4-b69e-4631-b72d-0a99f2c2f4de-0.mp4" framerate="0" duration="239" isDefault="true"/> <media:content type="video/mp4" medium="video" height="360" fileSize="13234826" url="https://video.antopie.org/static/streaming-playlists/hls/387e0ceb-bfc8-4399-9c21-65b7711292b8/d5806124-c19c-4802-99aa-fd73598792aa-360-fragmented.mp4" framerate="25" duration="239" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="7921503" url="https://video.antopie.org/static/streaming-playlists/hls/387e0ceb-bfc8-4399-9c21-65b7711292b8/74120d22-04e0-4049-b85c-076711c9d8c2-240-fragmented.mp4" framerate="25" duration="239" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="3913476" url="https://video.antopie.org/static/streaming-playlists/hls/387e0ceb-bfc8-4399-9c21-65b7711292b8/6fad73ae-badb-46c2-84f3-f541c7056c26-0-fragmented.mp4" framerate="0" duration="239" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/d9697a6e-a513-4ab6-a015-cac3732039e6.png" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">LITTLE LION MEET SETKA - DANS LA VILLE (2018)</media:title> <media:description type="plain">2ème extrait de la collaboration "Little lion meet Setka" !!! Deux artistes alliant Rub a dub, Hip hop et leurs propres influences à suivre de très près... STAY TUNED PEOPLE ! Real : Mani vision Mise en scène : Da system Rec : Conçu pour d...</media:description> </item> <item> <title><![CDATA[Trop occupé pour les vidéos... Zoom sur nos activités du moment !]]></title> <link>https://peertube2.cpy.re/w/1E7E8KremjjvtYSKkCLaVc</link> <guid>https://peertube2.cpy.re/w/1E7E8KremjjvtYSKkCLaVc</guid> <pubDate>Fri, 16 Oct 2026 17:00:27 GMT</pubDate> <description><![CDATA[Pas toujours facile et souvent stressant de concilier travail au jardin et travail sur les vidéos.. Comment ça les vidéos c'est pas un travail !? Aujourd'hui j'avais envie de vous en parler de ce travail, et du stress qui ça peut générer d'être pa...]]></description> <content:encoded><![CDATA[<p>Pas toujours facile et souvent stressant de concilier travail au jardin et travail sur les vidéos..<br /> Comment ça les vidéos c'est pas un travail !?<br /> Aujourd'hui j'avais envie de vous en parler de ce travail, et du stress qui ça peut générer d'être parfois pris entre trop de priorités différentes...<br /> En plus de vous présenter toutes nos activités du moment.<br /> Bonne vidéo à tous</p> <ul> <li>Adhérez à cette chaîne pour obtenir des avantages :<br /> <a href="https://www.youtube.com/channel/UC9Q8WeyCb3yxySC3P3mGpBw/join" target="_blank" rel="noopener noreferrer">https://www.youtube.com/channel/UC9Q8WeyCb3yxySC3P3mGpBw/join</a></li> </ul> <p>Site internet du jardin d'émerveille :<br /> <a href="https://www.lejardindemerveille.net/" target="_blank" rel="noopener noreferrer">https://www.lejardindemerveille.net/</a></p> <p>Venez nous renconter directement à la pépinière :<br /> 19 chemin de Guille à Marssac sur Tarn<br /> On est ouvert les samedis après midi de 15h à 18h.</p> <p>Vous pouvez aussi acheter nos plantes et graines en ligne :<br /> <a href="https://jardinforet.etsy.com" target="_blank" rel="noopener noreferrer">https://jardinforet.etsy.com</a></p> <p>Acheter mes livre :<br /> Le guide du Jardin Forêt : <a href="https://c3po.link/Qt3TUSrfh6" target="_blank" rel="noopener noreferrer">https://c3po.link/Qt3TUSrfh6</a><br /> Le jardin forêt en pratique : <a href="https://c3po.link/Qh4VY7tnxY" target="_blank" rel="noopener noreferrer">https://c3po.link/Qh4VY7tnxY</a></p> <p>Nous rejoindre sur Discord :<br /> <a href="https://discord.gg/Sjjq8axam9" target="_blank" rel="noopener noreferrer">https://discord.gg/Sjjq8axam9</a></p> <ul> <li>Pour suivre mes formations :<br /> <a href="https://www.grainesdemelisse.com/les-formations" target="_blank" rel="noopener noreferrer">https://www.grainesdemelisse.com/les-formations</a><br /> <a href="https://cours.universite-alveoles.fr/jardin-foret/" target="_blank" rel="noopener noreferrer">https://cours.universite-alveoles.fr/jardin-foret/</a></li> </ul> <p>Pour me suivre sur mes autres réseaux :<br /> Instagram : <a href="https://www.instagram.com/le_jardin_demerveille/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/le_jardin_demerveille/</a><br /> Facebook : <a href="https://www.facebook.com/remi.champy/" target="_blank" rel="noopener noreferrer">https://www.facebook.com/remi.champy/</a></p> <p>Sommaire :<br /> 0:00 – Pourquoi je stresse ?<br /> 1:08 – Culture, entretien et aménagement<br /> 4:02 – Récoltes et transformations<br /> 4:29 – Productions de semences<br /> 5:24 – Pépinière et vie personnelle<br /> 6:57 – Produire des vidéos…<br /> 7:41 – Ma vie de Youtubeur</p> ]]></content:encoded> <dc:creator>le_jardin_d_emerveille</dc:creator> <enclosure length="298854426" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/05525db7-1c19-4abe-beda-f106cbc56611?videoFileIds=5944110"/> <media:community> <media:statistics views="3"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/1E7E8KremjjvtYSKkCLaVc"/> <media:player url="https://peertube2.cpy.re/w/1E7E8KremjjvtYSKkCLaVc"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e658ef1b-3505-4052-991b-9430e3c25792-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9d0953df-0124-4f1f-b6da-bc8c576deaf0-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c0a6ea6c-8066-48f6-8499-30835f7efcdd-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a50ce5a4-b063-4aec-8b21-21db888cf191-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a639bb2c-3375-4809-b7b6-0c9be9e1fa7a-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/594a6510-30f2-42a3-bd47-d07985becb66-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="25425904" url="https://static.indymotion.fr/web-videos/03fe5591-ffed-4a84-8152-c10cef893596-0.mp4" framerate="0" duration="761" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="298854426" url="https://static.indymotion.fr/streaming-playlists/hls/05525db7-1c19-4abe-beda-f106cbc56611/79e1ad48-81c8-4101-915e-87742cf82215-1080-fragmented.mp4" framerate="25" duration="761" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="204083830" url="https://static.indymotion.fr/streaming-playlists/hls/05525db7-1c19-4abe-beda-f106cbc56611/ab33b395-cc1b-437f-bc10-498c976ebb01-720-fragmented.mp4" framerate="25" duration="761" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="112847981" url="https://static.indymotion.fr/streaming-playlists/hls/05525db7-1c19-4abe-beda-f106cbc56611/f5c1b752-fffb-447a-932c-e13abce03831-480-fragmented.mp4" framerate="25" duration="761" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="47330532" url="https://static.indymotion.fr/streaming-playlists/hls/05525db7-1c19-4abe-beda-f106cbc56611/fb5c6ae3-91f8-488b-b94e-8c2d2f30634f-240-fragmented.mp4" framerate="25" duration="761" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="13079052" url="https://static.indymotion.fr/streaming-playlists/hls/05525db7-1c19-4abe-beda-f106cbc56611/6c487d2c-2160-40b5-8e97-ddb356923a47-0-fragmented.mp4" framerate="0" duration="761" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/24170118-b9e3-4a29-940e-e87d53a1b6ea.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Trop occupé pour les vidéos... Zoom sur nos activités du moment !</media:title> <media:description type="plain">Pas toujours facile et souvent stressant de concilier travail au jardin et travail sur les vidéos.. Comment ça les vidéos c'est pas un travail !? Aujourd'hui j'avais envie de vous en parler de ce travail, et du stress qui ça peut générer d'être pa...</media:description> </item> <item> <title><![CDATA[La jeunesse peut faire basculer la présidentielle (et les médias le savent)]]></title> <link>https://peertube2.cpy.re/w/pvThm7WyVsoftcEahMjewe</link> <guid>https://peertube2.cpy.re/w/pvThm7WyVsoftcEahMjewe</guid> <pubDate>Fri, 16 Oct 2026 16:54:34 GMT</pubDate> <description><![CDATA[Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir La mobilisation des lycéens a donné lieu à beaucoup de séquences, à la fois glaçantes comme formidables et soulève l’inquiétude du conservatisme. Alors évidemment av...]]></description> <content:encoded><![CDATA[<p>Soutenez Blast, nouveau média indépendant : <a href="https://www.blast-info.fr/soutenir" target="_blank" rel="noopener noreferrer">https://www.blast-info.fr/soutenir</a></p> <p>La mobilisation des lycéens a donné lieu à beaucoup de séquences, à la fois glaçantes comme formidables et soulève l’inquiétude du conservatisme. Alors évidemment avec toutes ces controverses et tout ce débat, la télé s’est dit banco : le 8 octobre, LCI a sorti le dispositif classique, le grand plateau de « La Grande confrontation ». Terrible appareil de capture de ce mouvement social, le plateau n’a été qu’une machine à délégitimer : trop jeunes, trop violents, trop ignares, les jeunes doivent se taire et remercier les boomers.</p> <p>On en profitera pour faire une respiration parlementaire avec la saine colère de Stéphane Peu, avant de faire un micro-tour du côté de la primaire auto-produite, auto-gagnée et auto-proclamée de Glucksmann.</p> <p>00:00 Introduction<br /> 00:57 Journal de campagne : Allons enfants de la patrie !<br /> 23:59 Douce propagande : Peu de le dire<br /> 27:27 Cringe dès le premier tour.</p> <p>Une vidéo de Camille et Victor-Ulysse Sultra-Chastrusse, Doctorant en droit public,<br /> Réalisation et montage : Guillaume Cage<br /> Son : Baptiste Veilhan, Théo Duchesne<br /> Graphisme : Morgane Sabouret, Margaux Simon<br /> Production : Hicham Tragha<br /> Directeur du développement des collaborations extérieures : Mathias Enthoven<br /> Co-directrice de la rédaction : Soumaya Benaïssa<br /> Directeur de la publication : Denis Robert</p> <p>Le site : <a href="https://www.blast-info.fr/" target="_blank" rel="noopener noreferrer">https://www.blast-info.fr/</a><br /> Facebook : <a href="https://www.facebook.com/blastofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/blastofficiel</a><br /> Twitter : <a href="https://twitter.com/blast_france" target="_blank" rel="noopener noreferrer">https://twitter.com/blast_france</a><br /> Instagram : <a href="https://www.instagram.com/blastofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/blastofficiel/</a><br /> Mastodon : <a href="https://mamot.fr/web/@blast_info" target="_blank" rel="noopener noreferrer">https://mamot.fr/web/@blast_info</a><br /> Peertube : <a href="https://video.blast-info.fr/" target="_blank" rel="noopener noreferrer">https://video.blast-info.fr/</a><br /> Twitch : <a href="https://www.twitch.tv/blastinfo" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/blastinfo</a><br /> Bluesky : <a href="https://bsky.app/profile/blast-info.fr" target="_blank" rel="noopener noreferrer">https://bsky.app/profile/blast-info.fr</a></p> <p>#manifestation<br /> #17octobre<br /> #lycée</p> ]]></content:encoded> <dc:creator>blast, le souffle de l’info</dc:creator> <enclosure length="733544323" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/be6e5cb0-8309-416f-9487-4792ddd9a68d?videoFileIds=5944143"/> <media:community> <media:statistics views="164"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/pvThm7WyVsoftcEahMjewe"/> <media:player url="https://peertube2.cpy.re/w/pvThm7WyVsoftcEahMjewe"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a9d043e0-974c-4b76-898b-46e440388265-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e4a00939-5731-48fb-91fe-9bae08232ecf-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/56772b47-a5f3-46a2-ad63-e8133fbf65ec-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3a99a4c9-9d9e-4f96-9cda-e94c58a2861e-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5bd93431-da62-40a7-81f2-01f8df29e438-240-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/58c282e1-9f04-4def-93ef-fdfdaa7b945c-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="60336465" url="https://cdn.octos3.fr/peertube-blast/web-videos/34b2a989-073a-4e82-a9ad-c4f49aa228a6-0.mp4" framerate="0" duration="1852" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="733544323" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/be6e5cb0-8309-416f-9487-4792ddd9a68d/d8099239-2c40-4b80-85af-64cb51124dcc-1080-fragmented.mp4" framerate="25" duration="1852" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="315453067" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/be6e5cb0-8309-416f-9487-4792ddd9a68d/0a366f94-4023-4427-b629-eb3e64555368-720-fragmented.mp4" framerate="25" duration="1852" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="172026941" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/be6e5cb0-8309-416f-9487-4792ddd9a68d/8f137168-f16a-4f7c-a900-580667432c06-480-fragmented.mp4" framerate="25" duration="1852" isDefault="false"/> <media:content type="video/mp4" medium="video" height="240" fileSize="76250898" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/be6e5cb0-8309-416f-9487-4792ddd9a68d/25f68264-7218-4d73-864d-9944db3deded-240-fragmented.mp4" framerate="25" duration="1852" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="30071939" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/be6e5cb0-8309-416f-9487-4792ddd9a68d/77c4343c-01a6-45df-b958-5d910cb26569-0-fragmented.mp4" framerate="0" duration="1852" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1418a30b-be36-498c-b7bc-a291e88a9617.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">La jeunesse peut faire basculer la présidentielle (et les médias le savent)</media:title> <media:description type="plain">Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir La mobilisation des lycéens a donné lieu à beaucoup de séquences, à la fois glaçantes comme formidables et soulève l’inquiétude du conservatisme. Alors évidemment av...</media:description> </item> <item> <title><![CDATA[DOPPIO ALGORAVE --> CIRCOLO HEX / BOLOGNA]]></title> <link>https://peertube2.cpy.re/w/38KxgcARjmrEoyLgNXsCcx</link> <guid>https://peertube2.cpy.re/w/38KxgcARjmrEoyLgNXsCcx</guid> <pubDate>Fri, 16 Oct 2026 15:39:26 GMT</pubDate> <description><![CDATA[NONMATERIA + BELLAIRSIA GRACILIS + LEOFLTT + GAMBIT + KEVIN SMUGGLES + ACIDWARE + ||||| Live @ Circolo Hex / Bologna (10-11/10/2026) Video Credits --> Presenti]]></description> <content:encoded><![CDATA[<p>NONMATERIA + BELLAIRSIA GRACILIS + LEOFLTT + GAMBIT + KEVIN SMUGGLES + ACIDWARE + |||||<br /> Live @ Circolo Hex / Bologna (10-11/10/2026)<br /> Video Credits --> Presenti</p> ]]></content:encoded> <dc:creator>Live</dc:creator> <category>Art</category> <enclosure length="27206949" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/114750c9-614e-4a87-9318-7a7658f83cad?videoFileIds=5944091&videoFileIds=5944094"/> <media:community> <media:statistics views="9"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/38KxgcARjmrEoyLgNXsCcx"/> <media:player url="https://peertube2.cpy.re/w/38KxgcARjmrEoyLgNXsCcx"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e1d4c746-bd7d-4bfa-afe3-fdddda9af702-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b5132158-ead6-4162-840f-d79635742920-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/131e1b92-768a-4831-88f1-6149d0901c47-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="903049" url="https://peertube.uno/static/web-videos/238d61e7-304f-4637-880a-bc1c59b66476-0.mp4" framerate="0" duration="55" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="26303900" url="https://peertube.uno/static/streaming-playlists/hls/114750c9-614e-4a87-9318-7a7658f83cad/2d1ea44d-e6e5-4c9b-82eb-d868434d1048-1080-fragmented.mp4" framerate="24" duration="55" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="905235" url="https://peertube.uno/static/streaming-playlists/hls/114750c9-614e-4a87-9318-7a7658f83cad/fd17a3bf-cfb7-43fb-bde1-7264bc80632e-0-fragmented.mp4" framerate="0" duration="55" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/22521873-7b2e-4d06-b3fc-8aa303d35bc3.png" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">DOPPIO ALGORAVE --> CIRCOLO HEX / BOLOGNA</media:title> <media:description type="plain">NONMATERIA + BELLAIRSIA GRACILIS + LEOFLTT + GAMBIT + KEVIN SMUGGLES + ACIDWARE + ||||| Live @ Circolo Hex / Bologna (10-11/10/2026) Video Credits --&gt; Presenti</media:description> </item> <item> <title><![CDATA[Tux-Flash-2026-10-15-KI,ArtCraft,Linux Mint 27,Tux-Tage 2026 fallen aus,Wayland,Cosmic]]></title> <link>https://peertube2.cpy.re/w/mdwi5MSUvyiVPVDPAf853t</link> <guid>https://peertube2.cpy.re/w/mdwi5MSUvyiVPVDPAf853t</guid> <pubDate>Fri, 16 Oct 2026 14:47:01 GMT</pubDate> <description><![CDATA[Es ist wieder Podcast, meine Kerle 😃 Heute schnacken Micha (@saintofsinner) und Jean (Linux Guides) ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich. Der Podcast wird live gestreamt auf: https://www...]]></description> <content:encoded><![CDATA[<p>Es ist wieder Podcast, meine Kerle 😃</p> <p>Heute schnacken Micha (@saintofsinner) und Jean (Linux Guides) ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich.</p> <p>Der Podcast wird live gestreamt auf:</p> <ul> <li><a href="https://www.twitch.tv/saintofsinner" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/saintofsinner</a></li> <li><a href="https://www.linuxguides.de/live" target="_blank" rel="noopener noreferrer">https://www.linuxguides.de/live</a></li> </ul> <p>Der Tux Flash wird anschließend veröffentlicht auf :</p> <ul> <li><a href="https://tube.tchncs.de/c/ndwls/videos" target="_blank" rel="noopener noreferrer">https://tube.tchncs.de/c/ndwls/videos</a></li> <li><a href="https://www.youtube.com/@Tux-Flash" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@Tux-Flash</a></li> <li><a href="https://www.youtube.com/playlist?list=PLt-F9X6Bnsjhr3xeScgs4xElpJvaqaCW0" target="_blank" rel="noopener noreferrer">https://www.youtube.com/playlist?list=PLt-F9X6Bnsjhr3xeScgs4xElpJvaqaCW0</a></li> <li>Archiv mit alten Folgen: <a href="https://www.youtube.com/playlist?list=PLPK5iNo_kpNe0dtNukSwl02w64dKSYBlJ" target="_blank" rel="noopener noreferrer">https://www.youtube.com/playlist?list=PLPK5iNo_kpNe0dtNukSwl02w64dKSYBlJ</a></li> <li><a href="https://open.spotify.com/show/5j5C5a3nTq2L2Z2RBOvLuE" target="_blank" rel="noopener noreferrer">https://open.spotify.com/show/5j5C5a3nTq2L2Z2RBOvLuE</a></li> </ul> ]]></content:encoded> <dc:creator>Nicht der Weisheit letzter Schluß</dc:creator> <category>Science & Technology</category> <enclosure length="826450032" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/a3b65e3c-2e52-4a49-84fb-96eba6b5c397?videoFileIds=5944076"/> <media:community> <media:statistics views="3"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/mdwi5MSUvyiVPVDPAf853t"/> <media:player url="https://peertube2.cpy.re/w/mdwi5MSUvyiVPVDPAf853t"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6ef46e90-376c-494d-8926-9d3a8936dab7-720.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/680ab7bc-de87-4e51-90f4-e041fd08ae85-480.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d57f9691-f8e2-4d4b-bef8-03cb9522083d-360.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e2ecae90-4009-44ea-8d9b-70719ca875ec-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0d15bb38-bfd7-413f-b405-31b7abae0831-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/06984e61-f6a6-4ce8-bef0-c60b9b31b7cb-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5bc0c885-e59f-408b-9ab0-b7dfb0dcf67f-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1c8d77e3-75e7-4e65-b9eb-288d3d18e7a7-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="826450032" url="https://media.tube.tchncs.de/videos/eaa0bbd7-1303-47ac-b6db-61397cc28f1c-720.mp4" framerate="60" duration="5261" isDefault="true"/> <media:content type="video/mp4" medium="video" height="480" fileSize="541977357" url="https://media.tube.tchncs.de/videos/efa6f812-feb3-4cc6-a18b-410429c667cc-480.mp4" framerate="30" duration="5261" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="391312885" url="https://media.tube.tchncs.de/videos/68ab808f-557b-40e4-865f-d51cd5dc65fe-360.mp4" framerate="30" duration="5261" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="140440873" url="https://media.tube.tchncs.de/videos/1b490bf7-af8c-4e07-a803-6e3fc2a3b646-0.mp4" framerate="0" duration="5261" isDefault="false"/> <media:content type="video/mp4" medium="video" height="720" fileSize="822832458" url="https://media.tube.tchncs.de/streaming-playlists/hls/a3b65e3c-2e52-4a49-84fb-96eba6b5c397/cff9cfff-280a-4d2b-96c3-fcdc36fd5f89-720-fragmented.mp4" framerate="60" duration="5261" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="538592367" url="https://media.tube.tchncs.de/streaming-playlists/hls/a3b65e3c-2e52-4a49-84fb-96eba6b5c397/2fbb2888-99f9-4662-b2b1-c2d0a030f610-480-fragmented.mp4" framerate="30" duration="5261" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="387931535" url="https://media.tube.tchncs.de/streaming-playlists/hls/a3b65e3c-2e52-4a49-84fb-96eba6b5c397/7bb78ab5-b9df-4e63-9600-f3a34ae283ec-360-fragmented.mp4" framerate="30" duration="5261" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="139662935" url="https://media.tube.tchncs.de/streaming-playlists/hls/a3b65e3c-2e52-4a49-84fb-96eba6b5c397/2d4d340e-89a1-4ffd-88d8-77a5ba87f524-0-fragmented.mp4" framerate="0" duration="5261" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/20ff2b2e-79cc-4a2a-a9ee-fa4b0817671d.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Tux-Flash-2026-10-15-KI,ArtCraft,Linux Mint 27,Tux-Tage 2026 fallen aus,Wayland,Cosmic</media:title> <media:description type="plain">Es ist wieder Podcast, meine Kerle 😃 Heute schnacken Micha (@saintofsinner) und Jean (Linux Guides) ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich. Der Podcast wird live gestreamt auf: https://www...</media:description> </item> <item> <title><![CDATA[Narm's Elements -Full team feature]]></title> <link>https://peertube2.cpy.re/w/wAEfhYi3EG2AqG54Cyd27V</link> <guid>https://peertube2.cpy.re/w/wAEfhYi3EG2AqG54Cyd27V</guid> <pubDate>Fri, 16 Oct 2026 14:46:20 GMT</pubDate> <description><![CDATA[This video was made with the help of AI. Everything might change until release. Stay tuned for more!]]></description> <content:encoded><![CDATA[<p>This video was made with the help of AI. Everything might change until release.</p> <p>Stay tuned for more!</p> ]]></content:encoded> <dc:creator>PierTube</dc:creator> <category>Gaming</category> <enclosure length="19569408" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/f7c904a7-2e2e-4a4c-af9f-1ca8b0d0d9d5?videoFileIds=5944036&videoFileIds=5944038"/> <media:community> <media:statistics views="0"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/wAEfhYi3EG2AqG54Cyd27V"/> <media:player url="https://peertube2.cpy.re/w/wAEfhYi3EG2AqG54Cyd27V"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d0a23d08-5387-41b6-8537-36a7c24081f8-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/39b282b7-d05d-48c9-98f7-4ad506c412e8-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0d420a98-70cc-48c8-8d3e-918038bc8bdb-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1231554" url="https://peertube.uno/static/web-videos/c44fdf8c-7e68-4984-ba56-d58a8b2da6cd-0.mp4" framerate="0" duration="76" isDefault="true"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="18337854" url="https://peertube.uno/static/streaming-playlists/hls/f7c904a7-2e2e-4a4c-af9f-1ca8b0d0d9d5/ea8935c1-c372-40af-8ac2-ffc0d2499c67-1080-fragmented.mp4" framerate="30" duration="76" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1234524" url="https://peertube.uno/static/streaming-playlists/hls/f7c904a7-2e2e-4a4c-af9f-1ca8b0d0d9d5/62a9f517-3813-41af-866a-9ccfef8d06a9-0-fragmented.mp4" framerate="0" duration="76" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/ae31a88a-9a88-4ad9-bd8d-40bb9c3df6bf.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Narm's Elements -Full team feature</media:title> <media:description type="plain">This video was made with the help of AI. Everything might change until release. Stay tuned for more!</media:description> </item> <item> <title><![CDATA[Linux Talk 13-LineageOS, Android, Spielen auf Linux, Omarchy, CachyOS, Umstellung auf Linux, Kielux]]></title> <link>https://peertube2.cpy.re/w/o7YTSKNDS2NzxKcWfDrFKa</link> <guid>https://peertube2.cpy.re/w/o7YTSKNDS2NzxKcWfDrFKa</guid> <pubDate>Fri, 16 Oct 2026 14:35:23 GMT</pubDate> <description><![CDATA[Der Linux Talk 13 wird am 9.10.26 um 19:00Uhr live u.a. auf https://www.twitch.tv/linuxhanny, https://www.linuxguides.de/live, https://youtube.com/@nichtderweisheit, gestreamt. Mit dabei sind SaintOfSinner, Linux Guides, Linux Hanny...]]></description> <content:encoded><![CDATA[<p>Der Linux Talk 13 wird am 9.10.26 um 19:00Uhr live u.a. auf</p> <ul> <li><a href="https://www.twitch.tv/linuxhanny" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/linuxhanny</a></li> <li><a href="https://www.linuxguides.de/live" target="_blank" rel="noopener noreferrer">https://www.linuxguides.de/live</a></li> <li><a href="https://youtube.com/@nichtderweisheit" target="_blank" rel="noopener noreferrer">https://youtube.com/@nichtderweisheit</a></li> </ul> <p>gestreamt.</p> <p>Mit dabei sind SaintOfSinner, Linux Guides, Linux Hanny und ich.</p> ]]></content:encoded> <dc:creator>Nicht der Weisheit letzter Schluß</dc:creator> <category>Science & Technology</category> <enclosure length="990383447" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/b3229357-cb69-411d-a7d4-1b1f7b80843b?videoFileIds=5944039"/> <media:community> <media:statistics views="8"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/o7YTSKNDS2NzxKcWfDrFKa"/> <media:player url="https://peertube2.cpy.re/w/o7YTSKNDS2NzxKcWfDrFKa"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f505fcca-d44e-4ce1-bb67-4563598d78a9-1080.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/130396e3-477d-4017-9778-1f5789650402-480.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a2cbdd18-3b34-4443-8786-d7048345ff1e-360.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e8decc59-cf9a-4dd1-ab11-9a63a4d5170b-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3d1fbd83-4cda-40ff-bf8b-59acbc507962-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3a817e82-9331-46c5-856d-c6f86617c36f-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a58fea9c-6490-4cac-a044-e22cd8058845-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/003be1df-274f-46d2-92d3-98b13924d132-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="990383447" url="https://media.tube.tchncs.de/videos/9fad5c6e-22fb-4f89-9e1b-7594d6cda350-1080.mp4" framerate="30" duration="6446" isDefault="true"/> <media:content type="video/mp4" medium="video" height="480" fileSize="449661596" url="https://media.tube.tchncs.de/videos/6cf59155-573b-40a8-b646-0c9f25fc0b7a-480.mp4" framerate="30" duration="6446" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="369850728" url="https://media.tube.tchncs.de/videos/90c39c6c-442b-464b-92f9-a9370347c453-360.mp4" framerate="30" duration="6446" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="191370001" url="https://media.tube.tchncs.de/videos/67053ea8-6884-4042-a1b4-b50774aa44be-0.mp4" framerate="0" duration="6446" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="986319633" url="https://media.tube.tchncs.de/streaming-playlists/hls/b3229357-cb69-411d-a7d4-1b1f7b80843b/2a74c875-f6ec-4357-a443-6bea5b3b2ac2-1080-fragmented.mp4" framerate="30" duration="6446" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="445550430" url="https://media.tube.tchncs.de/streaming-playlists/hls/b3229357-cb69-411d-a7d4-1b1f7b80843b/de5472f2-ef30-4a84-bbc4-4dcce0db1d85-480-fragmented.mp4" framerate="30" duration="6446" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="365730562" url="https://media.tube.tchncs.de/streaming-playlists/hls/b3229357-cb69-411d-a7d4-1b1f7b80843b/6d8f986e-d94d-4f87-b0d7-da11fdd60a72-360-fragmented.mp4" framerate="30" duration="6446" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="190411203" url="https://media.tube.tchncs.de/streaming-playlists/hls/b3229357-cb69-411d-a7d4-1b1f7b80843b/cb630a8d-ff07-441e-b801-7329a9efca9e-0-fragmented.mp4" framerate="0" duration="6446" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/5f2ecd16-b143-4c73-8451-687c4f88d11f.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Linux Talk 13-LineageOS, Android, Spielen auf Linux, Omarchy, CachyOS, Umstellung auf Linux, Kielux</media:title> <media:description type="plain">Der Linux Talk 13 wird am 9.10.26 um 19:00Uhr live u.a. auf https://www.twitch.tv/linuxhanny, https://www.linuxguides.de/live, https://youtube.com/@nichtderweisheit, gestreamt. Mit dabei sind SaintOfSinner, Linux Guides, Linux Hanny...</media:description> </item> <item> <title><![CDATA[Il discorso di Marco Antonio]]></title> <link>https://peertube2.cpy.re/w/cfZwPZTrKhXCdh9p6UxgP6</link> <guid>https://peertube2.cpy.re/w/cfZwPZTrKhXCdh9p6UxgP6</guid> <pubDate>Fri, 16 Oct 2026 13:50:40 GMT</pubDate> <description><![CDATA[I filosofi e gli oratori antichi avevano compreso un principio fondamentale della persuasione: il pensiero dipende dalle emozioni. Per far cambiare idea a un pubblico, non si può attaccare la logica frontalmente. Bisogna prima gestire, manipolare...]]></description> <content:encoded><![CDATA[<p>I filosofi e gli oratori antichi avevano compreso un principio fondamentale della persuasione:<br /> il pensiero dipende dalle emozioni. Per far cambiare idea a un pubblico, non si può attaccare la logica frontalmente. Bisogna prima gestire, manipolare e reindirizzare lo stato emotivo degli<br /> interlocutori. Il discorso di Marco Antonio è la più grande dimostrazione di questa tesi.<br /> Per una analisi del video, qui: <a href="https://www.filosofiprecari.it/wordpress/?p=359" target="_blank" rel="noopener noreferrer">https://www.filosofiprecari.it/wordpress/?p=359</a></p> ]]></content:encoded> <dc:creator>Animainprogresso</dc:creator> <enclosure length="88860442" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/5b2c64a1-b38b-4833-b7c0-20a774bd21bf?videoFileIds=5944003&videoFileIds=5944005"/> <media:community> <media:statistics views="5"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/cfZwPZTrKhXCdh9p6UxgP6"/> <media:player url="https://peertube2.cpy.re/w/cfZwPZTrKhXCdh9p6UxgP6"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/29131457-af0d-48b3-acd0-075ea1d50e69-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/225ba671-1208-48dc-95aa-f151dfe2a00a-384-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/100e346b-bb9f-477e-97c6-ef12ae6f8f64-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="14349710" url="https://peertube.uno/static/web-videos/122f8a1d-f0f8-4f19-b845-a8caf347ef09-0.mp4" framerate="0" duration="850" isDefault="true"/> <media:content type="video/mp4" medium="video" height="384" fileSize="74510732" url="https://peertube.uno/static/streaming-playlists/hls/5b2c64a1-b38b-4833-b7c0-20a774bd21bf/28db36fa-c854-4437-bc5e-daa656f1eb4d-384-fragmented.mp4" framerate="25" duration="850" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="14347508" url="https://peertube.uno/static/streaming-playlists/hls/5b2c64a1-b38b-4833-b7c0-20a774bd21bf/cf6db6f1-3f7d-46cf-8581-76f417d20012-0-fragmented.mp4" framerate="0" duration="850" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/94845336-a14c-47b5-90b7-8c8b1dcea394.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Il discorso di Marco Antonio</media:title> <media:description type="plain">I filosofi e gli oratori antichi avevano compreso un principio fondamentale della persuasione: il pensiero dipende dalle emozioni. Per far cambiare idea a un pubblico, non si può attaccare la logica frontalmente. Bisogna prima gestire, manipolare...</media:description> </item> <item> <title><![CDATA[Fridays For Future Italia interviene al Tg3 sul caldo estremo di quest'estate]]></title> <link>https://peertube2.cpy.re/w/avxZaayDc3mAfFLJN5ky5i</link> <guid>https://peertube2.cpy.re/w/avxZaayDc3mAfFLJN5ky5i</guid> <pubDate>Fri, 16 Oct 2026 13:30:10 GMT</pubDate> <description><![CDATA[Il caldo estremo che quest'estate ha raggiunto ogni angolo d'Europa ha messo alle strette qualsiasi negazionismo climatico. Se non vogliamo ritrovarci nella stessa situazione anche nei prossimi anni vanno prese misure concrete. Pochi giorni fa ...]]></description> <content:encoded><![CDATA[<p>Il caldo estremo che quest'estate ha raggiunto ogni angolo d'Europa ha messo alle strette qualsiasi negazionismo climatico. Se non vogliamo ritrovarci nella stessa situazione anche nei prossimi anni vanno prese misure concrete.</p> <p>Pochi giorni fa siamo intervenut* durante il servizio al Tg3 di Gabriele Carletti, di cui potete vedere un estratto.</p> <p>Ripensare ai primi grandi scioperi del 2019 è emozionante, ricordiamoci però che quell'onda non si è mai placata e che da oltre 7 anni ci sono persone che in tutta Italia continuano a scendere in piazza per cambiare le cose.</p> <p>C'è ancora tanto che possiamo fare, in tutto il paese e nelle nostre città. Noi non ci rassegnamo, e tu?</p> ]]></content:encoded> <dc:creator>Fridays For Future Italia</dc:creator> <category>Activism</category> <enclosure length="21734266" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/4d02876e-20ee-45e5-907e-3ccaa7b27cf1?videoFileIds=5943984&videoFileIds=5943983"/> <media:community> <media:statistics views="1"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/avxZaayDc3mAfFLJN5ky5i"/> <media:player url="https://peertube2.cpy.re/w/avxZaayDc3mAfFLJN5ky5i"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/209a8694-88c5-4d5e-a500-2a727f115e5e-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e3bb7e65-b2ad-4baf-8fe7-d3345d4da21c-720-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/014cfe18-8028-4485-98ef-f635f5750e81-0-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1027696" url="https://peertube.uno/static/web-videos/cb8bb8d0-0dc2-498f-808d-45e5d85dfff3-0.mp4" framerate="0" duration="63" isDefault="true"/> <media:content type="video/mp4" medium="video" height="720" fileSize="20706570" url="https://peertube.uno/static/streaming-playlists/hls/4d02876e-20ee-45e5-907e-3ccaa7b27cf1/d0637999-4f9d-4300-ac10-fccbc0bb79d8-720-fragmented.mp4" framerate="60" duration="63" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1033566" url="https://peertube.uno/static/streaming-playlists/hls/4d02876e-20ee-45e5-907e-3ccaa7b27cf1/a0614a0d-177e-4fc9-b5c3-021d5a70267f-0-fragmented.mp4" framerate="0" duration="63" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1271af5d-2579-48d2-828f-9f3708662fd8.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Fridays For Future Italia interviene al Tg3 sul caldo estremo di quest'estate</media:title> <media:description type="plain">Il caldo estremo che quest'estate ha raggiunto ogni angolo d'Europa ha messo alle strette qualsiasi negazionismo climatico. Se non vogliamo ritrovarci nella stessa situazione anche nei prossimi anni vanno prese misure concrete. Pochi giorni fa ...</media:description> </item> <item> <title><![CDATA[enfantine_du_vendredi_petits_pouces_loup]]></title> <link>https://peertube2.cpy.re/w/iFswphH3yD1iyby2y3X9mD</link> <guid>https://peertube2.cpy.re/w/iFswphH3yD1iyby2y3X9mD</guid> <pubDate>Fri, 16 Oct 2026 13:09:37 GMT</pubDate> <description><![CDATA[L'enfantine du vendredi, cette semaine : mes petits pouces ont peur du loup ! A reprendre avec les tout-petits]]></description> <content:encoded><![CDATA[<p>L'enfantine du vendredi, cette semaine : mes petits pouces ont peur du loup !<br /> A reprendre avec les tout-petits</p> ]]></content:encoded> <dc:creator>Lemokili</dc:creator> <category>Kids</category> <enclosure length="89083466" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/8f2db5d9-4883-423d-bbab-080935856ec5?videoFileIds=5943977"/> <media:community> <media:statistics views="0"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/iFswphH3yD1iyby2y3X9mD"/> <media:player url="https://peertube2.cpy.re/w/iFswphH3yD1iyby2y3X9mD"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/99034ee3-77e4-4573-81f9-e916a35a587c-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/923d7003-2cbf-4dc8-9444-b924d0f30d27-1280-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/86f63c4e-cae9-4085-b0aa-f9455f749fbf-640-hls.torrent" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="5176505" url="https://videos.domainepublic.net/static/web-videos/6f34d600-ab8e-402c-84f4-303fd8349cf4-0.mp4" framerate="0" duration="162" isDefault="true"/> <media:content type="video/mp4" medium="video" height="720" fileSize="89083466" url="https://videos.domainepublic.net/static/streaming-playlists/hls/8f2db5d9-4883-423d-bbab-080935856ec5/461794dd-5489-498d-819d-7e194b0ce31a-720-fragmented.mp4" framerate="30" duration="162" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="14272251" url="https://videos.domainepublic.net/static/streaming-playlists/hls/8f2db5d9-4883-423d-bbab-080935856ec5/9b30891d-8822-400c-88dd-f5304025c8e0-360-fragmented.mp4" framerate="30" duration="162" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/73e2ef59-f582-4a18-84d0-97882f1eda78.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">enfantine_du_vendredi_petits_pouces_loup</media:title> <media:description type="plain">L'enfantine du vendredi, cette semaine : mes petits pouces ont peur du loup ! A reprendre avec les tout-petits</media:description> </item> <item> <title><![CDATA[Who owns America (and the world)? BlackRock and Larry Fink]]></title> <link>https://peertube2.cpy.re/w/5TgraQVrvNSaKTDHZsym9Q</link> <guid>https://peertube2.cpy.re/w/5TgraQVrvNSaKTDHZsym9Q</guid> <pubDate>Fri, 16 Oct 2026 11:25:24 GMT</pubDate> <description><![CDATA[Who owns America (and the world)? BlackRock and Larry Fink We can do something about this. SPX6900 - Flip the stock market 💹🧲 https://www.spx6900.com #blackrock #larryfink #SPX6900 #FTSM #FlipTheStockMarket #kshapedeconomy #inflatio...]]></description> <content:encoded><![CDATA[<p>Who owns America (and the world)? BlackRock and Larry Fink</p> <p>We can do something about this.</p> <p>SPX6900 - Flip the stock market 💹🧲</p> <p><a href="https://www.spx6900.com" target="_blank" rel="noopener noreferrer">https://www.spx6900.com</a></p> <p>#blackrock #larryfink #SPX6900 #FTSM #FlipTheStockMarket #kshapedeconomy #inflation #eattherich #blackrockkanzler #blackrockmerz #blackrockregierung</p> <p>Video created by chang (<a href="https://x.com/fangiskhan" target="_blank" rel="noopener noreferrer">https://x.com/fangiskhan</a>)</p> ]]></content:encoded> <dc:creator>aeon_kn channel</dc:creator> <category>Activism</category> <enclosure length="35643823" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/278cff98-daad-4acd-ace0-f32bdd317bd0?videoFileIds=5943888"/> <media:community> <media:statistics views="25"/> </media:community> <media:embed url="https://peertube2.cpy.re/videos/embed/5TgraQVrvNSaKTDHZsym9Q"/> <media:player url="https://peertube2.cpy.re/w/5TgraQVrvNSaKTDHZsym9Q"/> <media:group> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3ee92425-f1f5-47a8-89c4-d6c9d4dd8362-1080.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/12caffb3-834c-40ce-83f1-7a0e4220fc7d-480.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8184aeb3-c861-4f1f-a534-dc48a73a9ec7-360.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/301f3e01-3e3d-41d2-a809-d0d89468f210-0.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d4e54841-620e-4c64-b001-1370b345c81d-1080-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9391f04b-a27a-403e-b0a1-e28b4a118196-480-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/716c3e24-777f-4544-a355-6d5f63b95df3-360-hls.torrent" isDefault="false"/> <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bde5a570-f7a0-47c1-a5e7-3e67a452c091-0-hls.torrent" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="35643823" url="https://media.tube.tchncs.de/videos/550cf7a8-1f0c-4d6d-b08b-c9386bee4d47-1080.mp4" framerate="60" duration="114" isDefault="true"/> <media:content type="video/mp4" medium="video" height="480" fileSize="9223938" url="https://media.tube.tchncs.de/videos/38c6be86-488b-49ef-9e79-219ea0885676-480.mp4" framerate="30" duration="114" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="6380600" url="https://media.tube.tchncs.de/videos/18a23070-8eef-48b6-9b9f-f97aa2a1cdd8-360.mp4" framerate="30" duration="114" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1839043" url="https://media.tube.tchncs.de/videos/f7e199c7-8530-47c5-a13d-2dafdfb80f3b-0.mp4" framerate="0" duration="114" isDefault="false"/> <media:content type="video/mp4" medium="video" height="1080" fileSize="35563729" url="https://media.tube.tchncs.de/streaming-playlists/hls/278cff98-daad-4acd-ace0-f32bdd317bd0/cb512177-5a60-47ce-8680-cb8dc62b7fe6-1080-fragmented.mp4" framerate="60" duration="114" isDefault="false"/> <media:content type="video/mp4" medium="video" height="480" fileSize="9173896" url="https://media.tube.tchncs.de/streaming-playlists/hls/278cff98-daad-4acd-ace0-f32bdd317bd0/5423cf9f-6a91-4dd4-9f8b-ca5b41d51ac1-480-fragmented.mp4" framerate="30" duration="114" isDefault="false"/> <media:content type="video/mp4" medium="video" height="360" fileSize="6330014" url="https://media.tube.tchncs.de/streaming-playlists/hls/278cff98-daad-4acd-ace0-f32bdd317bd0/e8a6335b-2d19-455d-a8f0-170ac1eed3ba-360-fragmented.mp4" framerate="30" duration="114" isDefault="false"/> <media:content type="audio/mp4" medium="video" height="0" fileSize="1843613" url="https://media.tube.tchncs.de/streaming-playlists/hls/278cff98-daad-4acd-ace0-f32bdd317bd0/22d1bf1b-44c1-4f84-84be-2606bee7f50b-0-fragmented.mp4" framerate="0" duration="114" isDefault="false"/> </media:group> <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/353d6046-50e5-402d-a4d0-3aad76db4097.jpg" height="1400" width="1400"/> <media:rating>nonadult</media:rating> <media:title type="plain">Who owns America (and the world)? BlackRock and Larry Fink</media:title> <media:description type="plain">Who owns America (and the world)? BlackRock and Larry Fink We can do something about this. SPX6900 - Flip the stock market 💹🧲 https://www.spx6900.com #blackrock #larryfink #SPX6900 #FTSM #FlipTheStockMarket #kshapedeconomy #inflatio...</media:description> </item> </channel> </rss>
Videos of subscriptions feeds
path Parameters
| format required | string Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1" format expected (we focus on making |
query Parameters
| accountId required | string limit listing to a specific account |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| sort | string Example: sort=-createdAt Sort column |
| token required | string private token allowing access |
Responses
Response samples
- 200
Content type
No sample
As a visitor, you can use this API to open an account (if registrations are open on that PeerTube instance). As an admin, you should use the dedicated User creation API instead.
Verify a user
Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| verificationString required | string <url> |
| isPendingEmail | boolean |
Responses
Request samples
- Payload
Content type
application/json
{- "verificationString": "string",
- "isPendingEmail": true
}Verify a registration email
Following a user registration request, the user will receive an email asking to click a link containing a secret.
path Parameters
| registrationId required | integer (id) >= 1 Example: 42 Registration ID |
Request Body schema: application/json
| verificationString required | string <url> |
Responses
Request samples
- Payload
Content type
application/json
{- "verificationString": "string"
}Register a user
Signup has to be enabled and signup approval is not required
Request Body schema: application/jsonrequired
| email required | string <email> email of the user, used for login or service communications |
| password required | string <password> (password) [ 6 .. 50 ] characters |
| username required | string [ 1 .. 50 ] characters /^[a-z0-9._]+$/ immutable name of the user, used to find or mention its actor |
object channel base information used to create the first channel of the user | |
| displayName | string [ 1 .. 120 ] characters editable name of the user, displayed in its representations |
Responses
Request samples
- Payload
Content type
application/json
{- "username": "chocobozzz",
- "password": "pa$$word",
- "email": "user@example.com",
- "displayName": "string",
- "channel": {
- "name": "framasoft_videos",
- "displayName": "string"
}
}Response samples
- 200
Content type
application/json
{- "state": {
- "id": 1,
- "label": "string"
}
}Request registration
Signup has to be enabled and require approval on the instance
Request Body schema: application/json
| email required | string <email> email of the user, used for login or service communications |
| password required | string <password> (password) [ 6 .. 50 ] characters |
| registrationReason required | string reason for the user to register on the instance |
| username required | string [ 1 .. 50 ] characters /^[a-z0-9._]+$/ immutable name of the user, used to find or mention its actor |
object channel base information used to create the first channel of the user | |
| displayName | string [ 1 .. 120 ] characters editable name of the user, displayed in its representations |
Responses
Request samples
- Payload
Content type
application/json
{- "username": "chocobozzz",
- "password": "pa$$word",
- "email": "user@example.com",
- "displayName": "string",
- "channel": {
- "name": "framasoft_videos",
- "displayName": "string"
}, - "registrationReason": "string"
}Response samples
- 200
Content type
application/json
{- "state": {
- "id": 1,
- "label": "string"
}
}Accept registration
Authorizations:
OAuth2
path Parameters
| registrationId required | integer (id) >= 1 Example: 42 Registration ID |
Request Body schema: application/json
| moderationResponse required | string Moderation response to send to the user |
| preventEmailDelivery | boolean Set it to true if you don't want PeerTube to send an email to the user |
Responses
Request samples
- Payload
Content type
application/json
{- "moderationResponse": "string",
- "preventEmailDelivery": true
}Reject registration
Authorizations:
OAuth2
path Parameters
| registrationId required | integer (id) >= 1 Example: 42 Registration ID |
Request Body schema: application/json
| moderationResponse required | string Moderation response to send to the user |
| preventEmailDelivery | boolean Set it to true if you don't want PeerTube to send an email to the user |
Responses
Request samples
- Payload
Content type
application/json
{- "moderationResponse": "string",
- "preventEmailDelivery": true
}List registrations
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string |
| sort | string Enum: "-createdAt" "createdAt" "state" "-state" |
| start | integer >= 0 Offset used to paginate results |
| stateOneOf | Array of integers (UserRegistrationState) Items Enum: 1 2 3 |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 1,
- "label": "string"
}, - "registrationReason": "string",
- "moderationResponse": "string",
- "username": "string",
- "email": "user@example.com",
- "emailVerified": true,
- "accountDisplayName": "string",
- "channelHandle": "string",
- "channelDisplayName": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "user": {
- "id": 42
}
}
]
}Sessions deal with access tokens over time. Only one session token can currently be used at a time.
Request samples
- Shell
API="https://peertube2.cpy.re/api/v1" ## AUTH curl -s "$API/oauth-clients/local"
Response samples
- 200
Content type
application/json
{- "client_id": "v1ikx5hnfop4mdpnci8nsqh93c45rldf",
- "client_secret": "AjWiOapPltI6EnsWQwlFarRtLh4u8tDt"
}Login
With your client id and secret, you can retrieve an access and refresh tokens.
header Parameters
| x-peertube-otp | string If the user enabled two factor authentication, you need to provide the OTP code in this header |
Request Body schema: application/x-www-form-urlencoded
| client_id required | string = 32 characters /^[a-z0-9]$/ |
| client_secret required | string = 32 characters /^[a-zA-Z0-9]$/ |
| grant_type required | string |
| username required | string [ 1 .. 50 ] characters /^[a-z0-9._]+$/ immutable name of the user, used to find or mention its actor |
| externalAuthToken | string If you want to authenticate using an external authentication token you got from an auth plugin (like |
| password | string <password> (password) [ 6 .. 50 ] characters |
Responses
Request samples
- Shell
## DEPENDENCIES: jq API="https://peertube2.cpy.re/api/v1" USERNAME="<your_username>" PASSWORD="<your_password>" ## AUTH client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id") client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret") curl -s "$API/users/token" \ --data client_id="$client_id" \ --data client_secret="$client_secret" \ --data grant_type=password \ --data username="$USERNAME" \ --data-urlencode password="$PASSWORD" \ | jq -r ".access_token"
Response samples
- 200
Content type
application/json
{- "token_type": "Bearer",
- "access_token": "90286a0bdf0f7315d9d3fe8dabf9e1d2be9c97d0",
- "refresh_token": "2e0d675df9fc96d2e4ec8a3ebbbf45eca9137bb7",
- "expires_in": 14399,
- "refresh_token_expires_in": 1209600
}List token sessions
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 0,
- "currentSession": true,
- "loginDevice": "string",
- "loginIP": "192.168.0.1",
- "loginDate": "2019-08-24T14:15:22Z",
- "lastActivityDevice": "string",
- "lastActivityIP": "192.168.0.1",
- "lastActivityDate": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z"
}
]
}Accounts encompass remote accounts discovered across the federation, and correspond to the main Actor, along with video channels a user can create, which are also Actors. When a comment is posted, it is done with your Account's Actor.
Get an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
Responses
Response samples
- 200
Content type
application/json
{- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}List videos of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Request samples
- JavaScript
- Shell
- Ruby
- Python
fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos') .then(function(response) { return response.json() }).then(function(data) { console.log(data) })
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}List followers of an account
Authorizations:
OAuth2
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Value: "createdAt" Sort followers by criteria |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "follower": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "following": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "score": 0,
- "state": "pending",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}List accounts
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
]
}List playlists of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
string or Array of strings PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| playlistType | integer (VideoPlaylistTypeSet) Enum: 1 2 The video playlist type (Regular = |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}List video channels of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| statsDays | integer Default: 30 Enum: 30 90 365 0 number of days of view statistics to include in |
| withStats | boolean include view statistics time series and total views (only if authenticated as the account user) |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}List the synchronizations of video channels of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 2,
- "label": "PROCESSING"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}, - "videoPrivacy": 0
}
]
}List ratings of an account
Authorizations:
OAuth2
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| rating | string Enum: "like" "dislike" Optionally filter which ratings to retrieve |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
[- {
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}, - "rating": "like"
}
]Using some features of PeerTube require authentication, for which User provide different levels of permission as well as associated user information. Each user has a corresponding local Account for federation.
Create a user
Authorizations:
OAuth2
Request Body schema: application/jsonrequired
If the smtp server is configured, you can leave the password empty and an email will be sent asking the user to set it first.
| email required | string <email> The user email |
| password required | string <password> (password) [ 6 .. 50 ] characters |
| role required | integer (UserRole) Enum: 0 1 2 The user role (Admin = |
| username required | string (username) [ 1 .. 50 ] characters /^[a-z0-9._]+$/ immutable name of the user, used to find or mention its actor |
| adminFlags | integer (UserAdminFlags) Enum: 0 1 Admin flags for the user (None = |
| channelName | string (usernameChannel) [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/ immutable name of the channel, used to interact with its actor |
| videoQuota | integer The user video quota in bytes |
| videoQuotaDaily | integer The user daily video quota in bytes |
Responses
Request samples
- Payload
Content type
application/json
{- "username": "chocobozzz",
- "password": "pa$$word",
- "email": "user@example.com",
- "videoQuota": -1,
- "videoQuotaDaily": -1,
- "channelName": "framasoft_videos",
- "role": 2,
- "adminFlags": 1
}Response samples
- 200
Content type
application/json
{- "user": {
- "id": 42,
- "account": {
- "id": 42
}
}
}List users
Authorizations:
OAuth2
query Parameters
| blocked | boolean Filter results down to (un)banned users |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| role | integer (UserRole) Enum: 0 1 2 Example: role=2 Filter results down to users with a specific role |
| search | string Plain text search that will match with user usernames or emails |
| sort | string Enum: "-id" "-username" "-createdAt" Sort users by criteria |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
[- {
- "id": 42,
- "username": "chocobozzz",
- "email": "user@example.com",
- "emailVerified": true,
- "nsfwPolicy": "display",
- "nsfwFlagsDisplayed": 0,
- "nsfwFlagsHidden": 0,
- "nsfwFlagsWarned": 0,
- "nsfwFlagsBlurred": 0,
- "adminFlags": 1,
- "autoPlayNextVideo": true,
- "autoPlayNextVideoPlaylist": true,
- "autoPlayVideo": true,
- "p2pEnabled": true,
- "videosHistoryEnabled": true,
- "videoLanguages": [
- "string"
], - "videoCategories": [
- 0
], - "videoLive": "true",
- "language": "string",
- "videoQuota": -1,
- "videoQuotaDaily": -1,
- "role": {
- "id": 2,
- "label": "User"
}, - "theme": "string",
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "notificationSettings": {
- "abuseAsModerator": 0,
- "videoAutoBlacklistAsModerator": 0,
- "newUserRegistration": 0,
- "newVideoFromSubscription": 0,
- "blacklistOnMyVideo": 0,
- "myVideoPublished": 0,
- "myVideoImportFinished": 0,
- "commentMention": 0,
- "newCommentOnMyVideo": 0,
- "newFollow": 0,
- "newInstanceFollower": 0,
- "autoInstanceFollowing": 0,
- "abuseStateChange": 0,
- "abuseNewMessage": 0,
- "newPeerTubeVersion": 0,
- "newPluginVersion": 0,
- "myVideoStudioEditionFinished": 0,
- "myVideoTranscriptionGenerated": 0
}, - "videoChannels": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
], - "blocked": true,
- "blockedReason": "string",
- "noInstanceConfigWarningModal": true,
- "noAccountSetupWarningModal": true,
- "noWelcomeModal": true,
- "createdAt": "string",
- "pluginAuth": "string",
- "lastLoginDate": "2019-08-24T14:15:22Z",
- "twoFactorEnabled": true,
- "newFeaturesInfoRead": 0
}
]Get a user
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
query Parameters
| withStats | boolean include statistics about the user (only available as a moderator/admin) |
Responses
Response samples
- 200
Content type
application/json
Example
{- "id": 42,
- "username": "chocobozzz",
- "email": "user@example.com",
- "emailVerified": true,
- "nsfwPolicy": "display",
- "nsfwFlagsDisplayed": 0,
- "nsfwFlagsHidden": 0,
- "nsfwFlagsWarned": 0,
- "nsfwFlagsBlurred": 0,
- "adminFlags": 1,
- "autoPlayNextVideo": true,
- "autoPlayNextVideoPlaylist": true,
- "autoPlayVideo": true,
- "p2pEnabled": true,
- "videosHistoryEnabled": true,
- "videoLanguages": [
- "string"
], - "videoCategories": [
- 0
], - "videoLive": "true",
- "language": "string",
- "videoQuota": -1,
- "videoQuotaDaily": -1,
- "role": {
- "id": 2,
- "label": "User"
}, - "theme": "string",
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "notificationSettings": {
- "abuseAsModerator": 0,
- "videoAutoBlacklistAsModerator": 0,
- "newUserRegistration": 0,
- "newVideoFromSubscription": 0,
- "blacklistOnMyVideo": 0,
- "myVideoPublished": 0,
- "myVideoImportFinished": 0,
- "commentMention": 0,
- "newCommentOnMyVideo": 0,
- "newFollow": 0,
- "newInstanceFollower": 0,
- "autoInstanceFollowing": 0,
- "abuseStateChange": 0,
- "abuseNewMessage": 0,
- "newPeerTubeVersion": 0,
- "newPluginVersion": 0,
- "myVideoStudioEditionFinished": 0,
- "myVideoTranscriptionGenerated": 0
}, - "videoChannels": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
], - "blocked": true,
- "blockedReason": "string",
- "noInstanceConfigWarningModal": true,
- "noAccountSetupWarningModal": true,
- "noWelcomeModal": true,
- "createdAt": "string",
- "pluginAuth": "string",
- "lastLoginDate": "2019-08-24T14:15:22Z",
- "twoFactorEnabled": true,
- "newFeaturesInfoRead": 0
}Update a user
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/jsonrequired
| adminFlags | integer (UserAdminFlags) Enum: 0 1 Admin flags for the user (None = |
string <email> The updated email of the user | |
| emailVerified | boolean Set the email as verified |
| password | string <password> (password) [ 6 .. 50 ] characters |
| pluginAuth | string or null The auth plugin to use to authenticate the user |
| role | integer (UserRole) Enum: 0 1 2 The user role (Admin = |
| videoQuota | integer The updated video quota of the user in bytes |
| videoQuotaDaily | integer The updated daily video quota of the user in bytes |
Responses
Request samples
- Payload
Content type
application/json
{- "email": "user@example.com",
- "emailVerified": true,
- "videoQuota": 0,
- "videoQuotaDaily": 0,
- "pluginAuth": "peertube-plugin-auth-saml2",
- "role": 2,
- "adminFlags": 1,
- "password": "pa$$word"
}Block a user
Prevent a user from logging in and interacting with the instance
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| reason | string [ 0 .. 500 ] characters Optional reason for blocking the user |
Responses
Request samples
- Payload
Content type
application/json
{- "reason": "string"
}Verify a user
Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| verificationString required | string <url> |
| isPendingEmail | boolean |
Responses
Request samples
- Payload
Content type
application/json
{- "verificationString": "string",
- "isPendingEmail": true
}Request two factor auth
Request two factor authentication for a user
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| currentPassword | string Password of the currently authenticated user |
Responses
Request samples
- Payload
Content type
application/json
{- "currentPassword": "string"
}Response samples
- 200
Content type
application/json
[- {
- "otpRequest": {
- "requestToken": "string",
- "secret": "string",
- "uri": "string"
}
}
]Confirm two factor auth
Confirm a two factor authentication request
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| otpToken required | string OTP token generated by the app |
| requestToken required | string Token to identify the two factor request |
Responses
Request samples
- Payload
Content type
application/json
{- "requestToken": "string",
- "otpToken": "string"
}Disable two factor auth
Disable two factor authentication of a user
Authorizations:
OAuth2
path Parameters
| id required | integer (id) >= 1 Example: 42 Entity id |
Request Body schema: application/json
| currentPassword | string Password of the currently authenticated user. Users of an id and pass auth plugin must use the password they log in with |
Responses
Request samples
- Payload
Content type
application/json
{- "currentPassword": "string"
}Request user export
Request an archive of user data. An email is sent when the archive is ready.
Authorizations:
OAuth2
path Parameters
| userId required | integer (id) >= 1 Example: 42 User id |
Request Body schema: application/json
| withVideoFiles | boolean Whether to include video files in the archive |
Responses
Request samples
- Payload
Content type
application/json
{- "withVideoFiles": true
}Response samples
- 200
Content type
application/json
{- "export": {
- "id": 0
}
}List user exports
PeerTube >= 6.1
Authorizations:
OAuth2
path Parameters
| userId required | integer (id) >= 1 Example: 42 User id |
Responses
Response samples
- 200
Content type
application/json
{- "id": 0,
- "state": {
- "id": 1,
- "label": "string"
}, - "size": 0,
- "privateDownloadUrl": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "expiresOn": "2019-08-24T14:15:22Z"
}Initialize the resumable user import
PeerTube >= 6.1 Uses a resumable protocol to initialize the import of the archive
Authorizations:
OAuth2
path Parameters
| userId required | integer (id) >= 1 Example: 42 User id |
header Parameters
| X-Upload-Content-Length required | number Example: 2469036 Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading. |
| X-Upload-Content-Type required | string <mimetype> Example: video/mp4 MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary. |
Request Body schema: application/json
| filename | string <filename> Archive filename including extension |
Responses
Request samples
- Payload
Content type
application/json
{- "filename": "user-export-6-2024-02-09T10_12_11.682Z"
}Send chunk for the resumable user import
PeerTube >= 6.1 Uses a resumable protocol to continue, pause or resume the import of the archive
Authorizations:
OAuth2
path Parameters
| userId required | integer (id) >= 1 Example: 42 User id |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 262144 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. |
| Content-Range required | string Example: bytes 0-262143/2469036 Specifies the bytes in the file that the request is uploading. For example, a value of When the server config |
Request Body schema: application/octet-stream
string <binary>
Responses
Cancel the resumable user import
PeerTube >= 6.1 Uses a resumable protocol to cancel the resumable user import
Authorizations:
OAuth2
path Parameters
| userId required | integer (id) >= 1 Example: 42 User id |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 0 |
Responses
Response samples
- 200
Content type
application/json
[- {
- "id": 42,
- "username": "chocobozzz",
- "email": "user@example.com",
- "emailVerified": true,
- "nsfwPolicy": "display",
- "nsfwFlagsDisplayed": 0,
- "nsfwFlagsHidden": 0,
- "nsfwFlagsWarned": 0,
- "nsfwFlagsBlurred": 0,
- "adminFlags": 1,
- "autoPlayNextVideo": true,
- "autoPlayNextVideoPlaylist": true,
- "autoPlayVideo": true,
- "p2pEnabled": true,
- "videosHistoryEnabled": true,
- "videoLanguages": [
- "string"
], - "videoCategories": [
- 0
], - "videoLive": "true",
- "language": "string",
- "videoQuota": -1,
- "videoQuotaDaily": -1,
- "role": {
- "id": 2,
- "label": "User"
}, - "theme": "string",
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "notificationSettings": {
- "abuseAsModerator": 0,
- "videoAutoBlacklistAsModerator": 0,
- "newUserRegistration": 0,
- "newVideoFromSubscription": 0,
- "blacklistOnMyVideo": 0,
- "myVideoPublished": 0,
- "myVideoImportFinished": 0,
- "commentMention": 0,
- "newCommentOnMyVideo": 0,
- "newFollow": 0,
- "newInstanceFollower": 0,
- "autoInstanceFollowing": 0,
- "abuseStateChange": 0,
- "abuseNewMessage": 0,
- "newPeerTubeVersion": 0,
- "newPluginVersion": 0,
- "myVideoStudioEditionFinished": 0,
- "myVideoTranscriptionGenerated": 0
}, - "videoChannels": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
], - "blocked": true,
- "blockedReason": "string",
- "noInstanceConfigWarningModal": true,
- "noAccountSetupWarningModal": true,
- "noWelcomeModal": true,
- "createdAt": "string",
- "pluginAuth": "string",
- "lastLoginDate": "2019-08-24T14:15:22Z",
- "twoFactorEnabled": true,
- "newFeaturesInfoRead": 0
}
]Update my user information
Authorizations:
OAuth2
Request Body schema: application/jsonrequired
| autoPlayNextVideo | boolean new preference regarding playing following videos automatically |
| autoPlayNextVideoPlaylist | boolean new preference regarding playing following playlist videos automatically |
| autoPlayVideo | boolean new preference regarding playing videos automatically |
| currentPassword | string <password> (password) [ 6 .. 50 ] characters |
| displayName | string [ 3 .. 120 ] characters new name of the user in its representations |
string <email> new email used for login and service communications | |
| language | string default language for this user |
| noAccountSetupWarningModal | boolean |
| noInstanceConfigWarningModal | boolean |
| noWelcomeModal | boolean |
| nsfwFlagsBlurred | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsDisplayed | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsHidden | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsWarned | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwPolicy | string Enum: "true" "false" "both" new NSFW display policy |
| p2pEnabled | boolean whether to enable P2P in the player or not |
| password | string <password> (password) [ 6 .. 50 ] characters |
| theme | string |
| videoCategories | Array of integers or null list of categories to filter videos down to ( |
| videoLanguages | Array of strings list of languages to filter videos down to |
| videoLive | string Enum: "true" "false" "both" filter videos down to lives ( |
| videosHistoryEnabled | boolean whether to keep track of watched history or not |
Responses
Request samples
- Payload
Content type
application/json
{- "password": "pa$$word",
- "currentPassword": "pa$$word",
- "email": "user@example.com",
- "displayName": "string",
- "nsfwPolicy": "true",
- "nsfwFlagsDisplayed": 0,
- "nsfwFlagsHidden": 0,
- "nsfwFlagsWarned": 0,
- "nsfwFlagsBlurred": 0,
- "p2pEnabled": true,
- "autoPlayVideo": true,
- "autoPlayNextVideo": true,
- "autoPlayNextVideoPlaylist": true,
- "videosHistoryEnabled": true,
- "videoLanguages": [
- "string"
], - "videoCategories": [
- 0
], - "videoLive": "true",
- "language": "string",
- "theme": "string",
- "noInstanceConfigWarningModal": true,
- "noAccountSetupWarningModal": true,
- "noWelcomeModal": true
}Get video imports of my user
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| search | string Search in video names |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| stateOneOf | Array of integers Items Enum: 1 2 3 4 5 6 Filter on import state |
| targetUrl | string Filter on import target URL |
| videoChannelSyncId | number Filter on imports created by a specific channel synchronization |
| videoId | integer Filter on import video ID |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "torrentfile": "string",
- "torrentName": "string",
- "state": {
- "id": 1,
- "label": "Pending"
}, - "error": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
}
]
}List videos of my user
Authorizations:
OAuth2
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
string or Array of strings PeerTube >= 7.2 Filter on videos that are published by a channel with one of these names | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Mark feature info as read
**PeerTube >= v8.0.0
Authorizations:
OAuth2
Request Body schema: application/json
| feature required | integer (NewFeatureInfoType) Value: 1 Represent a new feature that can be displayed to inform users. One of the following values:
|
Responses
Request samples
- Payload
Content type
application/json
{- "feature": 1
}Update my user avatar
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| avatarfile | string <binary> The file to upload |
Responses
Response samples
- 200
Content type
application/json
{- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}List my abuses
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| id | integer only list the report with this id |
| sort | string Enum: "-id" "-createdAt" "-state" Sort abuses by criteria |
| start | integer >= 0 Offset used to paginate results |
| state | integer (AbuseStateSet) Enum: 1 2 3 The abuse state (Pending = |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "reason": "The video is a spam",
- "predefinedReasons": [
- "spamOrMisleading"
], - "reporterAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "state": {
- "id": 1,
- "label": "string"
}, - "moderationComment": "Decided to ban the server since it spams us regularly",
- "video": {
- "id": 0,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "nsfw": true,
- "startAt": "2019-08-24T14:15:22Z",
- "endAt": "2019-08-24T14:15:22Z",
- "deleted": true,
- "blacklisted": true,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Operations related to your subscriptions to video channels, their new videos, and how to keep up to date with their latest publications!
List my user subscriptions
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-id" "-createdAt" "-channelUpdatedAt" |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}List videos of subscriptions of my user
Authorizations:
OAuth2
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Get subscription of my user
Authorizations:
OAuth2
path Parameters
| subscriptionHandle required | string Example: my_username | my_username@example.com The subscription handle |
Responses
Response samples
- 200
Content type
application/json
{- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}Notifications following new videos, follows or reports. They allow you to keep track of the interactions and overall important information that concerns you. You MAY set per-notification type delivery preference, to receive the info either by mail, by in-browser notification or both.
List my notifications
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| typeOneOf | Array of integers (NotificationType) Items Enum: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 only list notifications of these types |
| unread | boolean only list unread notifications |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "type": 1,
- "read": true,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}, - "videoImport": {
- "id": 42,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}, - "torrentName": "string",
}, - "comment": {
- "id": 42,
- "threadId": 0,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}, - "account": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "heldForReview": true
}, - "videoAbuse": {
- "id": 42,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}
}, - "videoBlacklist": {
- "id": 42,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}
}, - "account": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "actorFollow": {
- "id": 42,
- "follower": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "state": "pending",
- "following": {
- "type": "account",
- "name": "string",
- "displayName": "string",
- "host": "example.com"
}
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Update my notification settings
Authorizations:
OAuth2
Request Body schema: application/json
| abuseAsModerator | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| abuseNewMessage | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| abuseStateChange | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| autoInstanceFollowing | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| blacklistOnMyVideo | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| commentMention | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| myVideoImportFinished | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| myVideoPublished | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| myVideoStudioEditionFinished | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| myVideoTranscriptionGenerated | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newCommentOnMyVideo | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newFollow | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newInstanceFollower | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newPeerTubeVersion | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newPluginVersion | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newUserRegistration | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| newVideoFromSubscription | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
| videoAutoBlacklistAsModerator | integer (NotificationSettingValue) Notification type. One of the following values, or a sum of multiple values:
|
Responses
Request samples
- Payload
Content type
application/json
{- "abuseAsModerator": 0,
- "videoAutoBlacklistAsModerator": 0,
- "newUserRegistration": 0,
- "newVideoFromSubscription": 0,
- "blacklistOnMyVideo": 0,
- "myVideoPublished": 0,
- "myVideoImportFinished": 0,
- "commentMention": 0,
- "newCommentOnMyVideo": 0,
- "newFollow": 0,
- "newInstanceFollower": 0,
- "autoInstanceFollowing": 0,
- "abuseStateChange": 0,
- "abuseNewMessage": 0,
- "newPeerTubeVersion": 0,
- "newPluginVersion": 0,
- "myVideoStudioEditionFinished": 0,
- "myVideoTranscriptionGenerated": 0
}List watched videos history
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}List videos of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Request samples
- JavaScript
- Shell
- Ruby
- Python
fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos') .then(function(response) { return response.json() }).then(function(data) { console.log(data) })
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Request video token
Request special tokens that expire quickly to use them in some context (like accessing private static files)
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "files": {
- "token": "string",
- "expires": "2019-08-24T14:15:22Z"
}
}Create a studio task
Create a task to edit a video (cut, add intro/outro etc)
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: multipart/form-datarequired
Array
Any of
| name | string Value: "cut" |
object |
Responses
List videos
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Response samples
- 200
Content type
application/json
{- "1": "Music",
- "2": "Films",
- "3": "Vehicles",
- "4": "Art",
- "5": "Sports",
- "6": "Travels",
- "7": "Gaming",
- "8": "People",
- "9": "Comedy",
- "10": "Entertainment",
- "11": "News & Politics",
- "12": "How To",
- "13": "Education",
- "14": "Activism",
- "15": "Science & Technology",
- "16": "Animals",
- "17": "Kids",
- "18": "Food"
}Response samples
- 200
Content type
application/json
{- "1": "Attribution",
- "2": "Attribution - Share Alike",
- "3": "Attribution - No Derivatives",
- "4": "Attribution - Non Commercial",
- "5": "Attribution - Non Commercial - Share Alike",
- "6": "Attribution - Non Commercial - No Derivatives",
- "7": "Public Domain Dedication",
- "8": "Free of known copyright restrictions",
- "9": "All Rights Reserved"
}List available video languages
query Parameters
| scope | string Value: "subtitle" PeerTube >= 8.2 Filter languages by scope. Use |
Responses
Response samples
- 200
Content type
application/json
{- "aa": "Afar",
- "ab": "Abkhazian",
- "af": "Afrikaans",
- "ak": "Akan",
- "am": "Amharic",
- "ar": "Arabic",
- "an": "Aragonese",
- "ase": "American Sign Language",
- "as": "Assamese",
- "asq": "Austrian Sign Language",
- "av": "Avaric",
- "avk": "Kotava",
- "ay": "Aymara",
- "az": "Azerbaijani",
- "ba": "Bashkir",
- "bm": "Bambara",
- "be": "Belarusian",
- "bn": "Bengali",
- "bfi": "British Sign Language",
- "bi": "Bislama",
- "bo": "Tibetan",
- "bs": "Bosnian",
- "br": "Breton",
- "bg": "Bulgarian",
- "bzs": "Brazilian Sign Language",
- "ca": "Catalan",
- "cs": "Czech",
- "ch": "Chamorro",
- "ce": "Chechen",
- "cv": "Chuvash",
- "kw": "Cornish",
- "co": "Corsican",
- "cr": "Cree",
- "cse": "Czech Sign Language",
- "csl": "Chinese Sign Language",
- "cy": "Welsh",
- "da": "Danish",
- "de": "German",
- "dv": "Dhivehi",
- "dsl": "Danish Sign Language",
- "dz": "Dzongkha",
- "el": "Greek",
- "en": "English",
- "eo": "Esperanto",
- "et": "Estonian",
- "eu": "Basque",
- "ee": "Ewe",
- "fo": "Faroese",
- "fa": "Persian",
- "fj": "Fijian",
- "fi": "Finnish",
- "fr": "French",
- "fy": "Western Frisian",
- "fse": "Finnish Sign Language",
- "fsl": "French Sign Language",
- "ff": "Fulah",
- "gcf": "Guadeloupean Creole French",
- "gd": "Scottish Gaelic",
- "ga": "Irish",
- "gl": "Galician",
- "gv": "Manx",
- "gn": "Guarani",
- "gsg": "German Sign Language",
- "gsw": "Swiss German",
- "gu": "Gujarati",
- "ht": "Haitian",
- "ha": "Hausa",
- "sh": "Serbo-Croatian",
- "he": "Hebrew",
- "hz": "Herero",
- "hi": "Hindi",
- "ho": "Hiri Motu",
- "hr": "Croatian",
- "hu": "Hungarian",
- "hy": "Armenian",
- "ig": "Igbo",
- "ii": "Sichuan Yi",
- "iu": "Inuktitut",
- "id": "Indonesian",
- "ik": "Inupiaq",
- "is": "Icelandic",
- "it": "Italian",
- "jv": "Javanese",
- "jbo": "Lojban",
- "ja": "Japanese",
- "jsl": "Japanese Sign Language",
- "kab": "Kabyle",
- "kl": "Kalaallisut",
- "kn": "Kannada",
- "ks": "Kashmiri",
- "ka": "Georgian",
- "kr": "Kanuri",
- "kk": "Kazakh",
- "km": "Khmer",
- "ki": "Kikuyu",
- "rw": "Kinyarwanda",
- "ky": "Kirghiz",
- "kv": "Komi",
- "kg": "Kongo",
- "ko": "Korean",
- "kj": "Kuanyama",
- "ku": "Kurdish",
- "lo": "Lao",
- "la": "Latin",
- "lv": "Latvian",
- "li": "Limburgan",
- "ln": "Lingala",
- "lt": "Lithuanian",
- "lb": "Luxembourgish",
- "lu": "Luba-Katanga",
- "lg": "Ganda",
- "mh": "Marshallese",
- "ml": "Malayalam",
- "mr": "Marathi",
- "mk": "Macedonian",
- "mg": "Malagasy",
- "mt": "Maltese",
- "mn": "Mongolian",
- "mi": "Maori",
- "ms": "Malay (macrolanguage)",
- "my": "Burmese",
- "na": "Nauru",
- "nv": "Navajo",
- "nr": "South Ndebele",
- "nd": "North Ndebele",
- "ng": "Ndonga",
- "ne": "Nepali (macrolanguage)",
- "nl": "Dutch",
- "nn": "Norwegian Nynorsk",
- "nb": "Norwegian Bokmål",
- "no": "Norwegian",
- "ny": "Nyanja",
- "oc": "Occitan",
- "oj": "Ojibwa",
- "or": "Oriya (macrolanguage)",
- "om": "Oromo",
- "os": "Ossetian",
- "pa": "Panjabi",
- "pks": "Pakistan Sign Language",
- "pl": "Polish",
- "pt": "Portuguese",
- "ps": "Pushto",
- "qu": "Quechua",
- "rm": "Romansh",
- "ro": "Romanian",
- "rsl": "Russian Sign Language",
- "rn": "Rundi",
- "ru": "Russian",
- "sg": "Sango",
- "sdl": "Saudi Arabian Sign Language",
- "sfs": "South African Sign Language",
- "si": "Sinhala",
- "sk": "Slovak",
- "sl": "Slovenian",
- "se": "Northern Sami",
- "sm": "Samoan",
- "sn": "Shona",
- "sd": "Sindhi",
- "so": "Somali",
- "st": "Southern Sotho",
- "es": "Spanish (Spain)",
- "sq": "Albanian",
- "sc": "Sardinian",
- "sr": "Serbian",
- "ss": "Swati",
- "su": "Sundanese",
- "sw": "Swahili (macrolanguage)",
- "sv": "Swedish",
- "swl": "Swedish Sign Language",
- "ty": "Tahitian",
- "ta": "Tamil",
- "tt": "Tatar",
- "te": "Telugu",
- "tg": "Tajik",
- "tl": "Tagalog",
- "th": "Thai",
- "ti": "Tigrinya",
- "tlh": "Klingon",
- "to": "Tonga (Tonga Islands)",
- "tn": "Tswana",
- "ts": "Tsonga",
- "tk": "Turkmen",
- "tr": "Turkish",
- "tw": "Twi",
- "ug": "Uighur",
- "uk": "Ukrainian",
- "ur": "Urdu",
- "uz": "Uzbek",
- "ve": "Venda",
- "vi": "Vietnamese",
- "wa": "Walloon",
- "wo": "Wolof",
- "xh": "Xhosa",
- "yi": "Yiddish",
- "yo": "Yoruba",
- "za": "Zhuang",
- "zh": "Chinese",
- "zu": "Zulu",
- "zxx": "No linguistic content",
- "tok": "Toki Pona",
- "pt-BR": "Portuguese (Brazilian)",
- "pt-PT": "Portuguese (Portugal)",
- "es-419": "Spanish (Latin America)",
- "zh-Hans": "Simplified Chinese",
- "zh-Hant": "Traditional Chinese",
- "ca-valencia": "Valencian",
- "rcf": "Réunion Creole French",
- "gcr": "Guianese Creole French"
}Update a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: multipart/form-data
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| channelId | integer New channel of the video. The channel must be owned by the same account as the previous one. Use the "change ownership" endpoints to give a video to a channel owned by another account on the local PeerTube instance. |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| name | string [ 3 .. 120 ] characters Video name |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string or null <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | string Whether or not we wait transcoding before publish the video |
Responses
Get a video
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
- 401
- 403
Content type
application/json
{- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 42,
- "name": "chocobozzz",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "description": "string"
}, - "channel": {
- "id": 42,
- "name": "chocobozzz",
- "displayName": "Videos of Framasoft",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}, - "userHistory": {
- "currentTime": 0
}, - "viewers": 0,
- "description": "\"**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network,\nbased on free/libre software!*\\r\\n\\r\\n**Animation Produced by:** [LILA](https://libreart.info) - [ZeMarmot Team](https://film.zemarmot.net)\\r\\n\n*Directed by* Aryeom\\r\\n*Assistant* Jehan\\r\\n**Licence**: [CC-By-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)\\r\\n\\r\\n\n**Sponsored by** [Framasoft](https://framasoft.org)\\r\\n\\r\\n**Music**: [Red Step Forward](http://play.dogmazic.net/song.php?song_id=52491) - CC-By Ken Bushima\\r\\n\\r\\n\n**Movie Clip**: [Caminades 3: Llamigos](http://www.caminandes.com/) CC-By Blender Institute\\r\\n\\r\\n**Video sources**: https://gitlab.gnome.org/Jehan/what-is-peertube/\"\n",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "tags": [
- "flowers",
- "gardening"
], - "commentsPolicy": {
- "id": 1,
- "label": "string"
}, - "downloadEnabled": true,
- "inputFileUpdatedAt": "2019-08-24T14:15:22Z",
- "trackerUrls": [
- "wss://peertube2.cpy.re/tracker/socket"
], - "files": [
- {
- "id": 42,
- "resolution": {
- "id": 240,
- "label": "240p"
}, - "size": 0,
- "torrentUrl": "string",
- "torrentDownloadUrl": "string",
- "fileUrl": "string",
- "playlistUrl": "string",
- "fileDownloadUrl": "string",
- "fps": 0,
- "width": 0,
- "height": 0,
- "metadataUrl": "string",
- "hasAudio": true,
- "hasVideo": true,
- "storage": 0
}
], - "streamingPlaylists": [
- {
- "id": 42,
- "type": 1,
- "playlistUrl": "string",
- "segmentsSha256Url": "string",
- "files": [
- {
- "id": 42,
- "resolution": {
- "id": 240,
- "label": "240p"
}, - "size": 0,
- "torrentUrl": "string",
- "torrentDownloadUrl": "string",
- "fileUrl": "string",
- "playlistUrl": "string",
- "fileDownloadUrl": "string",
- "fps": 0,
- "width": 0,
- "height": 0,
- "metadataUrl": "string",
- "hasAudio": true,
- "hasVideo": true,
- "storage": 0
}
], - "redundancies": [
- {
- "baseUrl": "string"
}
]
}
]
}Notify user is watching a video
Call this endpoint regularly (every 5-10 seconds for example) to notify the server the user is watching the video. After a while, PeerTube will increase video's viewers counter. If the user is authenticated, PeerTube will also store the current player time.
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/jsonrequired
| currentTime required | integer <seconds> timestamp within the video, in seconds |
| client | string Client software used to watch the video. For example "Firefox", "PeerTube Approval Android", etc. |
| device | any Enum: "console" "embedded" "mobile" "smarttv" "tablet" "wearable" "xr" "desktop" Device used to watch the video. For example "desktop", "mobile", "smarttv", etc. |
| operatingSystem | string Operating system used to watch the video. For example "Windows", "Ubuntu", etc. |
| sessionId | string Optional param to represent the current viewer session. Used by the backend to properly count one view per session per video. PeerTube admin can configure the server to not trust this |
| viewEvent | string Value: "seek" Event since last viewing call:
|
Responses
Request samples
- Payload
Content type
application/json
{- "currentTime": 5,
- "viewEvent": "seek",
- "sessionId": "string",
- "client": "string",
- "device": "console",
- "operatingSystem": "string"
}Upload a video
Uses a single request to upload a video.
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| channelId required | integer >= 1 Channel id that will contain this video |
| name required | string [ 3 .. 120 ] characters Video name |
| videofile required | string <binary> Video file |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Request samples
- Shell
## DEPENDENCIES: jq USERNAME="<your_username>" PASSWORD="<your_password>" FILE_PATH="<your_file_path>" CHANNEL_ID="<your_channel_id>" NAME="<video_name>" API="https://peertube2.cpy.re/api/v1" ## AUTH client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id") client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret") token=$(curl -s "$API/users/token" \ --data client_id="$client_id" \ --data client_secret="$client_secret" \ --data grant_type=password \ --data username="$USERNAME" \ --data password="$PASSWORD" \ | jq -r ".access_token") ## VIDEO UPLOAD curl -s "$API/videos/upload" \ -H "Authorization: Bearer $token" \ --max-time 600 \ --form videofile=@"$FILE_PATH" \ --form channelId=$CHANNEL_ID \ --form name="$NAME"
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Initialize the resumable upload of a video
Uses a resumable protocol to initialize the upload of a video
Authorizations:
OAuth2
header Parameters
| X-Upload-Content-Length required | number Example: 2469036 Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading. |
| X-Upload-Content-Type required | string <mimetype> Example: video/mp4 MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary. |
Request Body schema: application/json
| channelId required | integer >= 1 Channel id that will contain this video |
| filename required | string <filename> Video filename including extension |
| name required | string [ 3 .. 120 ] characters Video name |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Request samples
- Payload
Content type
application/json
{- "name": "What is PeerTube?",
- "channelId": 3,
- "privacy": 1,
- "category": 15,
- "licence": 2,
- "language": "en",
- "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
- "waitTranscoding": true,
- "generateTranscription": true,
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "nsfw": true,
- "nsfwSummary": null,
- "nsfwFlags": 0,
- "tags": [
- "framasoft",
- "peertube"
], - "commentsPolicy": 1,
- "downloadEnabled": true,
- "originallyPublishedAt": "2019-08-24T14:15:22Z",
- "scheduleUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "thumbnailfile": "string",
- "previewfile": "string",
- "videoPasswords": [
- "string"
], - "filename": "what_is_peertube.mp4"
}Send chunk for the resumable upload of a video
Uses a resumable protocol to continue, pause or resume the upload of a video
Authorizations:
OAuth2
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 262144 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. |
| Content-Range required | string Example: bytes 0-262143/2469036 Specifies the bytes in the file that the request is uploading. For example, a value of When the server config |
Request Body schema: application/octet-stream
string <binary>
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Cancel the resumable upload of a video, deleting any data uploaded so far
Uses a resumable protocol to cancel the upload of a video
Authorizations:
OAuth2
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 0 |
Responses
Create a live
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| channelId required | integer Channel id that will contain this live video |
| name required | string [ 3 .. 120 ] characters Live video/replay name |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Live video/replay description |
| downloadEnabled | boolean Enable or disable downloading for the replay of this live video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| latencyMode | integer Enum: 1 2 3 User can select live latency mode if enabled by the instance |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this live video/replay contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| permanentLive | boolean User can stream multiple times in a permanent live |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (LiveVideoReplaySettings) | |
| saveReplay | boolean |
Array of objects (LiveSchedule) | |
| support | string A text tell the audience how to support the creator |
| tags | Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ] Live video/replay tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Live video/replay thumbnail file |
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Get information about a live
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Responses
Response samples
- 200
Content type
application/json
{- "rtmpUrl": "string",
- "rtmpsUrl": "string",
- "streamKey": "string",
- "saveReplay": true,
- "replaySettings": {
- "privacy": 1
}, - "permanentLive": true,
- "latencyMode": 1,
- "schedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
]
}Update information about a live
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| latencyMode | integer Enum: 1 2 3 User can select live latency mode if enabled by the instance |
| permanentLive | boolean User can stream multiple times in a permanent live |
object (LiveVideoReplaySettings) | |
| saveReplay | boolean |
Array of objects (LiveSchedule) |
Responses
Request samples
- Payload
Content type
application/json
{- "saveReplay": true,
- "replaySettings": {
- "privacy": 1
}, - "permanentLive": true,
- "latencyMode": 1,
- "schedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
]
}Get video source file metadata
Get metadata and download link of original video file
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Responses
Response samples
- 200
Content type
application/json
{- "inputFilename": "string",
- "fileDownloadUrl": "string",
- "resolution": {
- "id": 240,
- "label": "240p"
}, - "size": 0,
- "fps": 0,
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z"
}Initialize the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| X-Upload-Content-Length required | number Example: 2469036 Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading. |
| X-Upload-Content-Type required | string <mimetype> Example: video/mp4 MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary. |
Request Body schema: application/json
| filename | string <filename> Video filename including extension |
Responses
Request samples
- Payload
Content type
application/json
{- "filename": "what_is_peertube.mp4"
}Send chunk for the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 262144 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. |
| Content-Range required | string Example: bytes 0-262143/2469036 Specifies the bytes in the file that the request is uploading. For example, a value of When the server config |
Request Body schema: application/octet-stream
string <binary>
Responses
Cancel the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 0 |
Responses
List storyboards of a video
PeerTube >= 6.0
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Responses
Response samples
- 200
Content type
application/json
{- "storyboards": [
- {
- "storyboardPath": "string",
- "fileUrl": "string",
- "totalHeight": 0,
- "totalWidth": 0,
- "spriteHeight": 0,
- "spriteWidth": 0,
- "spriteDuration": 0
}
]
}List videos of a video channel
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Search videos
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| durationMax | integer Get videos that have this maximum duration |
| durationMin | integer Get videos that have this minimum duration |
| endDate | string <date-time> Get videos that are published before this date |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| originallyPublishedEndDate | string <date-time> Get videos that are originally published before this date |
| originallyPublishedStartDate | string <date-time> Get videos that are originally published after this date |
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
| startDate | string <date-time> Get videos that are published after this date |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video | |
| uuids | Array of strings Find elements with specific UUIDs |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes.
Upload
- legacy, where the video file is sent in a single request
- resumable, where the video file is sent in chunks
You can upload videos more reliably by using the resumable variant. Its protocol lets you resume an upload operation after a network interruption or other transmission failure, saving time and bandwidth in the event of network failures.
Favor using resumable uploads in any of the following cases:
- You are transferring large files
- The likelihood of a network interruption is high
- Uploads are originating from a device with a low-bandwidth or unstable Internet connection, such as a mobile device
Import
- URL-based: where the URL points to any service supported by youtube-dl
- magnet-based: where the URI resolves to a BitTorrent resource containing a single supported video file
- torrent-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file
The import function is practical when the desired video/audio is available online. It makes PeerTube download it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.
Upload a video
Uses a single request to upload a video.
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| channelId required | integer >= 1 Channel id that will contain this video |
| name required | string [ 3 .. 120 ] characters Video name |
| videofile required | string <binary> Video file |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Request samples
- Shell
## DEPENDENCIES: jq USERNAME="<your_username>" PASSWORD="<your_password>" FILE_PATH="<your_file_path>" CHANNEL_ID="<your_channel_id>" NAME="<video_name>" API="https://peertube2.cpy.re/api/v1" ## AUTH client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id") client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret") token=$(curl -s "$API/users/token" \ --data client_id="$client_id" \ --data client_secret="$client_secret" \ --data grant_type=password \ --data username="$USERNAME" \ --data password="$PASSWORD" \ | jq -r ".access_token") ## VIDEO UPLOAD curl -s "$API/videos/upload" \ -H "Authorization: Bearer $token" \ --max-time 600 \ --form videofile=@"$FILE_PATH" \ --form channelId=$CHANNEL_ID \ --form name="$NAME"
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Initialize the resumable upload of a video
Uses a resumable protocol to initialize the upload of a video
Authorizations:
OAuth2
header Parameters
| X-Upload-Content-Length required | number Example: 2469036 Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading. |
| X-Upload-Content-Type required | string <mimetype> Example: video/mp4 MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary. |
Request Body schema: application/json
| channelId required | integer >= 1 Channel id that will contain this video |
| filename required | string <filename> Video filename including extension |
| name required | string [ 3 .. 120 ] characters Video name |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Request samples
- Payload
Content type
application/json
{- "name": "What is PeerTube?",
- "channelId": 3,
- "privacy": 1,
- "category": 15,
- "licence": 2,
- "language": "en",
- "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
- "waitTranscoding": true,
- "generateTranscription": true,
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "nsfw": true,
- "nsfwSummary": null,
- "nsfwFlags": 0,
- "tags": [
- "framasoft",
- "peertube"
], - "commentsPolicy": 1,
- "downloadEnabled": true,
- "originallyPublishedAt": "2019-08-24T14:15:22Z",
- "scheduleUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "thumbnailfile": "string",
- "previewfile": "string",
- "videoPasswords": [
- "string"
], - "filename": "what_is_peertube.mp4"
}Send chunk for the resumable upload of a video
Uses a resumable protocol to continue, pause or resume the upload of a video
Authorizations:
OAuth2
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 262144 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. |
| Content-Range required | string Example: bytes 0-262143/2469036 Specifies the bytes in the file that the request is uploading. For example, a value of When the server config |
Request Body schema: application/octet-stream
string <binary>
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Cancel the resumable upload of a video, deleting any data uploaded so far
Uses a resumable protocol to cancel the upload of a video
Authorizations:
OAuth2
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 0 |
Responses
Import a video
Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)
Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
| channelId required | integer >= 1 Channel id that will contain this video |
| name required | string [ 3 .. 120 ] characters Video name |
| targetUrl required | string <url> remote URL where to find the import's source video |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Initialize the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| X-Upload-Content-Length required | number Example: 2469036 Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading. |
| X-Upload-Content-Type required | string <mimetype> Example: video/mp4 MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary. |
Request Body schema: application/json
| filename | string <filename> Video filename including extension |
Responses
Request samples
- Payload
Content type
application/json
{- "filename": "what_is_peertube.mp4"
}Send chunk for the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 262144 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. |
| Content-Range required | string Example: bytes 0-262143/2469036 Specifies the bytes in the file that the request is uploading. For example, a value of When the server config |
Request Body schema: application/octet-stream
string <binary>
Responses
Cancel the resumable replacement of a video
PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| upload_id required | string 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. |
header Parameters
| Content-Length required | number Example: 0 |
Responses
Import a video
Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)
Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
| channelId required | integer >= 1 Channel id that will contain this video |
| name required | string [ 3 .. 120 ] characters Video name |
| targetUrl required | string <url> remote URL where to find the import's source video |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Video description |
| downloadEnabled | boolean Enable or disable downloading for this video |
| generateTranscription | boolean PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this video contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| originallyPublishedAt | string <date-time> Date when the content was originally published |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (VideoScheduledUpdate) | |
| support | string A text tell the audience how to support the video creator |
| tags | Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ] Video tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Video thumbnail file |
| videoPasswords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
| waitTranscoding | boolean Whether or not we wait transcoding before publish the video |
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}List captions of a video
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "language": {
- "id": "en",
- "label": "English"
}, - "automaticallyGenerated": true,
- "captionPath": "string",
- "fileUrl": "string",
- "m3u8Url": "string",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Generate a video caption
PeerTube >= 6.2 This feature has to be enabled by the administrator
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| forceTranscription | boolean Default: false |
Responses
Request samples
- Payload
Content type
application/json
{- "forceTranscription": false
}Add or replace a video caption
Authorizations:
OAuth2
path Parameters
| captionLanguage required | string (VideoLanguageSet) Example: en The caption language |
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: multipart/form-data
| captionfile | string <binary> The file to upload. |
Responses
Get chapters of a video
PeerTube >= 6.0
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "chapters": {
- "title": "string",
- "timecode": 0
}
}Replace video chapters
PeerTube >= 6.0
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
Array of objects |
Responses
Request samples
- Payload
Content type
application/json
{- "chapters": [
- {
- "title": "string",
- "timecode": 0
}
]
}Operations dealing with the creation, modification and listing of videos within a channel.
List video channels
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}Create a video channel
Authorizations:
OAuth2
Request Body schema: application/json
| displayName required | any Channel display name |
| name required | string [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/ username of the channel to create |
| description | any Channel description |
| publicEmail | string or null <email> Public email visible in podcast RSS feeds |
| support | any How to support/fund the channel |
Responses
Request samples
- Payload
Content type
application/json
{- "displayName": null,
- "description": null,
- "support": null,
- "publicEmail": "user@example.com",
- "name": "framasoft_videos"
}Response samples
- 200
Content type
application/json
{- "videoChannel": {
- "id": 42
}
}Get a video channel
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Responses
Response samples
- 200
Content type
application/json
{- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}Update a video channel
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/json
| bulkVideosSupportUpdate | boolean Update the support field for all videos of this channel |
| description | any Channel description |
| displayName | any Channel display name |
| publicEmail | string or null <email> Public email visible in podcast RSS feeds |
| support | any How to support/fund the channel |
Responses
Request samples
- Payload
Content type
application/json
{- "displayName": null,
- "description": null,
- "support": null,
- "publicEmail": "user@example.com",
- "bulkVideosSupportUpdate": true
}List videos of a video channel
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}List activities of a video channel
PeerTube >= 8.0
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 0,
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "action": {
- "id": 1,
- "label": "string"
}, - "targetType": {
- "id": 1,
- "label": "string"
}, - "details": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string"
}, - "video": {
- "id": 42,
- "name": "string",
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "url": "string",
- "isLive": true
}, - "videoImport": {
- "id": 42,
- "name": "string",
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "url": "string",
}, - "playlist": {
- "id": 42,
- "name": "string",
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "url": "string"
},
}
]
}List playlists of a channel
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| playlistType | integer (VideoPlaylistTypeSet) Enum: 1 2 The video playlist type (Regular = |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}Reorder channel playlists
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/json
| insertAfterPosition required | integer >= 0 New position for the block to reorder, to add the block before the first element |
| startPosition required | integer >= 1 Start position of the element to reorder |
| reorderLength | integer >= 1 How many element from |
Responses
Request samples
- Payload
Content type
application/json
{- "startPosition": 1,
- "insertAfterPosition": 0,
- "reorderLength": 1
}List followers of a video channel
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Value: "createdAt" Sort followers by criteria |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "follower": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "following": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "score": 0,
- "state": "pending",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Update channel avatar
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: multipart/form-data
| avatarfile | string <binary> The file to upload. |
Responses
Response samples
- 200
Content type
application/json
{- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Import videos in channel
Import a remote channel/playlist videos into a channel
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/json
| externalChannelUrl required | string |
| videoChannelSyncId | integer If part of a channel sync process, specify its id to assign video imports to this channel synchronization |
Responses
Request samples
- Payload
Content type
application/json
{- "videoChannelSyncId": 0
}List video channels of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| statsDays | integer Default: 30 Enum: 30 90 365 0 number of days of view statistics to include in |
| withStats | boolean include view statistics time series and total views (only if authenticated as the account user) |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}List the synchronizations of video channels of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 2,
- "label": "PROCESSING"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}, - "videoPrivacy": 0
}
]
}Search channels
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| handles | Array of strings Find elements with these handles |
| host | string Find elements owned by this host |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}List channel collaborators
PeerTube >= 8.0
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "state": {
- "id": 1,
- "label": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Invite a collaborator
PeerTube >= 8.0 Invite a local user to collaborate on the specified video channel.
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/jsonrequired
| accountHandle | string Local user username to invite |
Responses
Request samples
- Payload
Content type
application/json
{- "accountHandle": "string"
}Response samples
- 200
Content type
application/json
{- "collaborator": {
- "id": 42,
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "state": {
- "id": 1,
- "label": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
}Remove a channel collaborator
PeerTube >= 8.0 Only the channel owner or the collaborator themselves can remove a collaborator from a channel
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
| collaboratorId required | integer (id) >= 1 Example: 42 The collaborator id |
Responses
Operations dealing with comments to a video. Comments are organized in threads: adding a comment in response to the video starts a thread, adding a reply to a comment adds it to its root comment thread.
List comments on user's videos
PeerTube >= 6.2
Authorizations:
OAuth2
query Parameters
string or Array of strings PeerTube >= 6.2 filter on comments that contain one of these automatic tags | |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| isHeldForReview | boolean only display comments that are held for review |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| searchAccount | string Filter comments by searching on the account |
| searchVideo | string Filter comments by searching on the video |
| videoChannelId | integer Limit results on this specific video channel |
| videoId | integer Limit results on this specific video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "heldForReview": true,
- "threadId": 42,
- "inReplyToCommentId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}, - "automaticTags": [
- "string"
]
}
]
}List threads of a video
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-createdAt" "-totalReplies" Sort comments by criteria |
| start | integer >= 0 Offset used to paginate results |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 0,
- "totalNotDeletedComments": 0,
- "data": [
- {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "threadId": 42,
- "inReplyToCommentId": 42,
- "videoId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null,
- "isDeleted": false,
- "heldForReview": true,
- "totalRepliesFromVideoAuthor": 0,
- "totalReplies": 0,
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
}
]
}Create a thread
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| text required | string <html> [ 1 .. 10000 ] characters Text of the comment |
Responses
Request samples
- Payload
Content type
application/json
{- "text": "This video is wonderful!"
}Response samples
- 200
Content type
application/json
{- "comment": {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "threadId": 42,
- "inReplyToCommentId": 42,
- "videoId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null,
- "isDeleted": false,
- "heldForReview": true,
- "totalRepliesFromVideoAuthor": 0,
- "totalReplies": 0,
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
}
}Get a thread
Since PeerTube 8.3 the returned tree is truncated: only the first replies of each comment are included, and only down to maxDepth nesting levels. Use GET /api/v1/videos/{id}/comments/{commentId}/replies to fetch the replies that are missing, comparing children and totalChildren of each node of the tree.
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
| threadId required | integer The thread id (root comment id) |
query Parameters
| maxDepth | integer [ 1 .. 10 ] Default: 5 Number of nesting levels to include below the requested comment.
Bounded by |
| repliesPerLevel | integer [ 1 .. 30 ] Default: 10 Number of direct replies to include for each comment of the tree. Does not apply to the first level of |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "comment": {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "threadId": 42,
- "inReplyToCommentId": 42,
- "videoId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null,
- "isDeleted": false,
- "heldForReview": true,
- "totalRepliesFromVideoAuthor": 0,
- "totalReplies": 0,
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
}, - "children": [
- { }
], - "totalChildren": 0
}List replies of a comment
PeerTube >= 8.3 List the direct replies of a comment, each of them nested up to maxDepth levels. Used to unfold the parts of a thread that GET /api/v1/videos/{id}/comment-threads/{threadId} truncated.
path Parameters
| commentId required | integer >= 1 Example: 42 The comment id |
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| maxDepth | integer [ 1 .. 10 ] Default: 5 Number of nesting levels to include below the requested comment.
Bounded by |
| repliesPerLevel | integer [ 1 .. 30 ] Default: 10 Number of direct replies to include for each comment of the tree. Does not apply to the first level of |
| sort | string Default: "createdAt" Enum: "createdAt" "-createdAt" Sort the direct replies of the comment. Deeper levels of the tree are always sorted the same way.
Defaults to |
| start | integer >= 0 Offset used to paginate results |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 13,
- "data": [
- {
- "comment": {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "threadId": 42,
- "inReplyToCommentId": 42,
- "videoId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null,
- "isDeleted": false,
- "heldForReview": true,
- "totalRepliesFromVideoAuthor": 0,
- "totalReplies": 0,
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
}, - "children": [
- { }
], - "totalChildren": 0
}
]
}List instance comments
Authorizations:
OAuth2
query Parameters
string or Array of strings PeerTube >= 6.2 filter on comments that contain one of these automatic tags | |
| includeMuted | boolean PeerTube >= 8.2 Include comments from muted accounts |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
| onLocalVideo | boolean Display only objects of local or remote videos |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| searchAccount | string Filter comments by searching on the account |
| searchVideo | string Filter comments by searching on the video |
| videoChannelId | integer Limit results on this specific video channel |
| videoId | integer Limit results on this specific video |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "heldForReview": true,
- "threadId": 42,
- "inReplyToCommentId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "name": "What is PeerTube?",
- "state": {
- "id": 1,
- "label": "string"
}
}, - "automaticTags": [
- "string"
]
}
]
}Reply to a thread of a video
Authorizations:
OAuth2
path Parameters
| commentId required | integer >= 1 Example: 42 The comment id |
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Request Body schema: application/json
| text required | string <html> [ 1 .. 10000 ] characters Text of the comment |
Responses
Request samples
- Payload
Content type
application/json
{- "text": "This video is wonderful!"
}Response samples
- 200
Content type
application/json
{- "comment": {
- "id": 42,
- "url": "string",
- "text": "This video is wonderful!",
- "threadId": 42,
- "inReplyToCommentId": 42,
- "videoId": 42,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null,
- "isDeleted": false,
- "heldForReview": true,
- "totalRepliesFromVideoAuthor": 0,
- "totalReplies": 0,
- "account": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}
}
}Like/dislike a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Request Body schema: application/json
| rating required | string Enum: "like" "dislike" |
Responses
Request samples
- Payload
Content type
application/json
{- "rating": "like"
}Operations dealing with playlists of videos. Playlists are bound to users and/or channels.
List playlists of a channel
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| playlistType | integer (VideoPlaylistTypeSet) Enum: 1 2 The video playlist type (Regular = |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}Reorder channel playlists
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/json
| insertAfterPosition required | integer >= 0 New position for the block to reorder, to add the block before the first element |
| startPosition required | integer >= 1 Start position of the element to reorder |
| reorderLength | integer >= 1 How many element from |
Responses
Request samples
- Payload
Content type
application/json
{- "startPosition": 1,
- "insertAfterPosition": 0,
- "reorderLength": 1
}List video playlists
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| playlistType | integer (VideoPlaylistTypeSet) Enum: 1 2 The video playlist type (Regular = |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}Create a video playlist
If the video playlist is set as public, videoChannelId is mandatory.
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| displayName required | string [ 1 .. 120 ] characters Video playlist display name |
| description | string [ 3 .. 1000 ] characters Video playlist description |
| privacy | integer (VideoPlaylistPrivacySet) Enum: 1 2 3 Video playlist privacy policy (see /video-playlists/privacies) |
| thumbnailfile | string <binary> Video playlist thumbnail file |
| videoChannelId | integer >= 1 Video channel in which the playlist will be published |
Responses
Response samples
- 200
Content type
application/json
{- "videoPlaylist": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Response samples
- 200
Content type
application/json
{- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}Update a video playlist
If the video playlist is set as public, the playlist must have a assigned channel.
Authorizations:
OAuth2
path Parameters
| playlistId required | integer >= 1 Example: 42 Playlist id |
Request Body schema: multipart/form-data
| description | string Video playlist description |
| displayName | string [ 1 .. 120 ] characters Video playlist display name |
| privacy | integer (VideoPlaylistPrivacySet) Enum: 1 2 3 Video playlist privacy policy (see /video-playlists/privacies) |
| thumbnailfile | string <binary> Video playlist thumbnail file |
| videoChannelId | integer >= 1 Video channel in which the playlist will be published |
Responses
List videos of a playlist
path Parameters
| playlistId required | integer >= 1 Example: 42 Playlist id |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "position": 2,
- "startTimestamp": 10,
- "stopTimestamp": 41,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
}
]
}Add a video in a playlist
Authorizations:
OAuth2
path Parameters
| playlistId required | integer >= 1 Example: 42 Playlist id |
Request Body schema: application/json
required | string or integer Video to add in the playlist |
| startTimestamp | integer <seconds> Start the video at this specific timestamp |
| stopTimestamp | integer <seconds> Stop the video at this specific timestamp |
Responses
Request samples
- Payload
Content type
application/json
{- "videoId": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "startTimestamp": 0,
- "stopTimestamp": 0
}Response samples
- 200
Content type
application/json
{- "videoPlaylistElement": {
- "id": 2
}
}Reorder playlist elements
Authorizations:
OAuth2
path Parameters
| playlistId required | integer >= 1 Example: 42 Playlist id |
Request Body schema: application/json
| insertAfterPosition required | integer >= 0 New position for the block to reorder, to add the block before the first element |
| startPosition required | integer >= 1 Start position of the element to reorder |
| reorderLength | integer >= 1 How many element from |
Responses
Request samples
- Payload
Content type
application/json
{- "startPosition": 1,
- "insertAfterPosition": 0,
- "reorderLength": 1
}Update a playlist element
Authorizations:
OAuth2
path Parameters
| playlistElementId required | integer (id) >= 1 Example: 42 Playlist element id |
| playlistId required | integer >= 1 Example: 42 Playlist id |
Request Body schema: application/json
| startTimestamp | integer <seconds> Start the video at this specific timestamp |
| stopTimestamp | integer <seconds> Stop the video at this specific timestamp |
Responses
Request samples
- Payload
Content type
application/json
{- "startTimestamp": 0,
- "stopTimestamp": 0
}Check video exists in my playlists
Authorizations:
OAuth2
query Parameters
| videoIds required | Array of integers[ items >= 1 ] Example: videoIds=42 The video ids to check |
Responses
Response samples
- 200
Content type
application/json
{- "videoId": [
- {
- "playlistElementId": 0,
- "playlistId": 0,
- "startTimestamp": 0,
- "stopTimestamp": 0
}
]
}List playlists of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
string or Array of strings PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| playlistType | integer (VideoPlaylistTypeSet) Enum: 1 2 The video playlist type (Regular = |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}Search playlists
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| host | string Find elements owned by this host |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| uuids | Array of strings Find elements with specific UUIDs |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}Get overall stats of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| endDate | string <date-time> Filter stats by end date |
| startDate | string <date-time> Filter stats by start date |
Responses
Response samples
- 200
Content type
application/json
{- "averageWatchTime": 0,
- "totalWatchTime": 0,
- "viewersPeak": 0,
- "totalViewers": 0,
- "viewersPeakDate": "2019-08-24T14:15:22Z",
- "countries": [
- {
- "isoCode": "string",
- "viewers": 0
}
], - "subdivisions": [
- {
- "name": "string",
- "viewers": 0
}
]
}Get user agent stats of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| endDate | string <date-time> Filter stats by end date |
| startDate | string <date-time> Filter stats by start date |
Responses
Response samples
- 200
Content type
application/json
{- "clients": [
- {
- "name": "string",
- "viewers": 0
}
], - "devices": [
- {
- "name": "console",
- "viewers": 0
}
], - "operatingSystem": [
- {
- "name": "string",
- "viewers": 0
}
]
}Get timeserie stats of a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
| metric required | string Enum: "viewers" "aggregateWatchTime" The metric to get |
query Parameters
| endDate | string <date-time> Filter stats by end date |
| startDate | string <date-time> Filter stats by start date |
Responses
Response samples
- 200
Content type
application/json
{- "data": [
- {
- "date": "string",
- "value": 0
}
]
}List video ownership changes
List ownership change requests received by the authenticated user and requests sent by a channel managed by the authenticated user
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-createdAt" "createdAt" |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 1,
- "label": "string"
}, - "initiatorAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "nextOwnerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "isLive": true,
- "nsfw": true,
- "publishedAt": "2019-08-24T14:15:22Z",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Accept ownership change request
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/jsonrequired
| channelId required | integer Target channel id owned by the authenticated user |
Responses
Request samples
- Payload
Content type
application/json
{- "channelId": 0
}List ownership change requests for a video
List all ownership change requests for a specific video. The authenticated user must be able to manage the video.
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-createdAt" "createdAt" |
| start | integer >= 0 Offset used to paginate results |
| state | integer (ChangeOwnershipState) Enum: 1 2 3 Filter by ownership change state |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 1,
- "label": "string"
}, - "initiatorAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "nextOwnerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "isLive": true,
- "nsfw": true,
- "publishedAt": "2019-08-24T14:15:22Z",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}List channel ownership changes
List ownership change requests received by the authenticated user and requests sent by channels managed by the authenticated user
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-createdAt" "createdAt" |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 1,
- "label": "string"
}, - "initiatorAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "nextOwnerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "isLive": true,
- "nsfw": true,
- "publishedAt": "2019-08-24T14:15:22Z",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}List ownership change requests for a channel
List all ownership change requests for a specific channel. The authenticated user must be able to manage the channel.
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Enum: "-createdAt" "createdAt" |
| start | integer >= 0 Offset used to paginate results |
| state | integer (ChangeOwnershipState) Enum: 1 2 3 Filter by ownership change state |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 1,
- "label": "string"
}, - "initiatorAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "nextOwnerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "isLive": true,
- "nsfw": true,
- "publishedAt": "2019-08-24T14:15:22Z",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Request channel ownership change
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/jsonrequired
| username required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "username": "string"
}PeerTube instances can mirror videos from one another, and help distribute some videos.
For importing videos as your own, refer to video imports.
List videos being mirrored
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Value: "name" Sort abuses by criteria |
| start | integer >= 0 Offset used to paginate results |
| target required | string Enum: "my-videos" "remote-videos" direction of the mirror |
Responses
Response samples
- 200
Content type
application/json
[- {
- "id": 42,
- "name": "string",
- "url": "string",
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "redundancies": {
- "streamingPlaylists": [
- {
- "id": 42,
- "fileUrl": "string",
- "strategy": "manual",
- "size": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "expiresOn": "2019-08-24T14:15:22Z"
}
]
}
}
]Create a studio task
Create a task to edit a video (cut, add intro/outro etc)
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: multipart/form-datarequired
Array
Any of
| name | string Value: "cut" |
object |
Responses
Create a transcoding job
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| transcodingType required | string Enum: "hls" "web-video" |
| forceTranscoding | boolean Default: false If the video is stuck in transcoding state, do it anyway |
Responses
Request samples
- Payload
Content type
application/json
{- "transcodingType": "hls",
- "forceTranscoding": false
}Create a live
Authorizations:
OAuth2
Request Body schema: multipart/form-data
| channelId required | integer Channel id that will contain this live video |
| name required | string [ 3 .. 120 ] characters Live video/replay name |
| category | integer (VideoCategorySet) category id of the video (see /videos/categories) |
| commentsPolicy | integer (VideoCommentsPolicySet) Enum: 1 2 3 Comments policy of the video (Enabled = |
| description | string Live video/replay description |
| downloadEnabled | boolean Enable or disable downloading for the replay of this live video |
| language | string (VideoLanguageSet) language id of the video (see /videos/languages) |
| latencyMode | integer Enum: 1 2 3 User can select live latency mode if enabled by the instance |
| licence | integer (VideoLicenceSet) licence id of the video (see /videos/licences) |
| nsfw | boolean Whether or not this live video/replay contains sensitive content |
| nsfwFlags | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwSummary | any More information about the sensitive content of the video |
| permanentLive | boolean User can stream multiple times in a permanent live |
| previewfile | string <binary> Deprecated Deprecated in PeerTube v8.1, use thumbnailfile instead |
| privacy | |
object (LiveVideoReplaySettings) | |
| saveReplay | boolean |
Array of objects (LiveSchedule) | |
| support | string A text tell the audience how to support the creator |
| tags | Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ] Live video/replay tags (maximum 5 tags each between 2 and 30 characters) |
| thumbnailfile | string <binary> Live video/replay thumbnail file |
Responses
Response samples
- 200
Content type
application/json
{- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Get information about a live
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Responses
Response samples
- 200
Content type
application/json
{- "rtmpUrl": "string",
- "rtmpsUrl": "string",
- "streamKey": "string",
- "saveReplay": true,
- "replaySettings": {
- "privacy": 1
}, - "permanentLive": true,
- "latencyMode": 1,
- "schedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
]
}Update information about a live
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| latencyMode | integer Enum: 1 2 3 User can select live latency mode if enabled by the instance |
| permanentLive | boolean User can stream multiple times in a permanent live |
object (LiveVideoReplaySettings) | |
| saveReplay | boolean |
Array of objects (LiveSchedule) |
Responses
Request samples
- Payload
Content type
application/json
{- "saveReplay": true,
- "replaySettings": {
- "privacy": 1
}, - "permanentLive": true,
- "latencyMode": 1,
- "schedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
]
}List live sessions
List all sessions created in a particular live
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| sort | string Example: sort=-createdAt Sort column |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 0,
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "error": 1,
- "replayVideo": {
- "id": 0,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}
]
}Get live session of a replay
If the video is a replay of a live, you can find the associated live session using this endpoint
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
header Parameters
| x-peertube-video-password | string Required on password protected video |
Responses
Response samples
- 200
Content type
application/json
{- "id": 0,
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "error": 1,
- "replayVideo": {
- "id": 0,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC"
}
}Operations dealing with synchronizing PeerTube user's channel with channels of other platforms
Import videos in channel
Import a remote channel/playlist videos into a channel
Authorizations:
OAuth2
path Parameters
| channelHandle required | string Example: my_username | my_username@example.com The video channel handle |
Request Body schema: application/json
| externalChannelUrl required | string |
| videoChannelSyncId | integer If part of a channel sync process, specify its id to assign video imports to this channel synchronization |
Responses
Request samples
- Payload
Content type
application/json
{- "videoChannelSyncId": 0
}Create a synchronization for a video channel
Authorizations:
OAuth2
Request Body schema: application/json
| externalChannelUrl | string |
| videoChannelId | integer (id) >= 1 |
| videoPrivacy | integer Privacy of imported videos (1 = PUBLIC, 2 = UNLISTED, 3 = PRIVATE, 4 = INTERNAL). Password protected privacy is not supported |
Responses
Request samples
- Payload
Content type
application/json
{- "videoChannelId": 42,
- "videoPrivacy": 0
}Response samples
- 200
Content type
application/json
{- "videoChannelSync": {
- "id": 42,
- "state": {
- "id": 2,
- "label": "PROCESSING"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}, - "videoPrivacy": 0
}
}List the synchronizations of video channels of an account
path Parameters
| name required | string Example: chocobozzz | chocobozzz@example.org The username or handle of the account |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| includeCollaborations | boolean PeerTube >= 8.0 Include objects from collaborated channels |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": {
- "id": 2,
- "label": "PROCESSING"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}, - "videoPrivacy": 0
}
]
}List video passwords
PeerTube >= 6.0
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "password": "string",
- "videoId": 42
}
]
}Update video passwords
PeerTube >= 6.0
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| passwords | Array of strings (AddVideoPasswords) unique [ items >= 2 characters ] |
Responses
Request samples
- Payload
Content type
application/json
{- "passwords": [
- "string"
]
}Add a video password
PeerTube >= 8.0
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| password | string |
Responses
Request samples
- Payload
Content type
application/json
{- "password": "string"
}Update video embed privacy
PeerTube >= 8.1
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| domains | Array of strings |
| policy | integer (VideoEmbedPrivacy) Enum: 1 2 3 4 The video embed privacy level:
|
Responses
Request samples
- Payload
Content type
application/json
{- "policy": 1,
- "domains": [
- "example.com"
]
}Check if embed is allowed
PeerTube >= 8.1 Check if video embed is allowed on a specific domain according to the video embed privacy settings
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
query Parameters
| domain required | string The domain to check if embed is allowed |
Responses
Response samples
- 200
Content type
application/json
{- "domainAllowed": true,
- "userBypassAllowed": true
}The search helps to find videos or channels from within the instance and beyond. Videos from other instances federated by the instance (that is, instances followed by the instance) can be found via keywords and other criteria of the advanced search.
Administrators can also enable the use of a remote search system, indexing videos and channels that may not be federated by the instance.
Search videos
query Parameters
string or Array of strings PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags | |
VideoCategorySet (integer) or Array of VideoCategorySet (integers) category id of the video (see /videos/categories) | |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| durationMax | integer Get videos that have this maximum duration |
| durationMin | integer Get videos that have this minimum duration |
| endDate | string <date-time> Get videos that are published before this date |
| excludeAlreadyWatched | boolean Whether or not to exclude videos that are in the user's video history |
| hasHLSFiles | boolean PeerTube >= 4.0 Display only videos that have HLS files |
| hasWebVideoFiles | boolean PeerTube >= 6.0 Display only videos that have Web Video files |
| host | string Find elements owned by this host |
| include | integer Enum: 0 1 2 4 8 16 32 Only administrators and moderators can use this parameter Include additional videos in results (can be combined using bitwise or operator)
|
| includeScheduledLive | boolean whether or not include live that are scheduled for later |
| isLive | boolean whether or not the video is a live |
| isLocal | boolean PeerTube >= 4.0 Display only local or remote objects |
VideoLanguageSet (string) or Array of VideoLanguageSet (strings) language id of the video (see /videos/languages). Use | |
VideoLicenceSet (integer) or Array of VideoLicenceSet (integers) licence id of the video (see /videos/licences) | |
| nsfw | string Enum: "true" "false" whether to include nsfw videos, if any |
| nsfwFlagsExcluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| nsfwFlagsIncluded | integer (NSFWFlag) Enum: 0 1 2 4 NSFW flags (can be combined using bitwise or operator)
|
| originallyPublishedEndDate | string <date-time> Get videos that are originally published before this date |
| originallyPublishedStartDate | string <date-time> Get videos that are originally published after this date |
| privacyOneOf | integer (VideoPrivacySet) Enum: 1 2 3 4 5 PeerTube >= 4.0 Display only videos in this specific privacy/privacies |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| skipCount | string Default: "false" Enum: "true" "false" if you don't need the |
| sort | string Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best" Sort videos by criteria (prefixing with
|
| start | integer >= 0 Offset used to paginate results |
| startDate | string <date-time> Get videos that are published after this date |
integer or Array of integers PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states | |
string or Array of strings tag(s) of the video, where all should be present in the video | |
string or Array of strings tag(s) of the video | |
| uuids | Array of strings Find elements with specific UUIDs |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}
]
}Search channels
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| handles | Array of strings Find elements with these handles |
| host | string Find elements owned by this host |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
]
}Search playlists
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| host | string Find elements owned by this host |
| search required | string String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it. |
| searchTarget | string Enum: "local" "search-index" If the administrator enabled search index support, you can override the default search target. Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:
|
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| uuids | Array of strings Find elements with specific UUIDs |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "description": "string",
- "displayName": "string",
- "isLocal": true,
- "videoLength": 0,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "privacy": {
- "id": 1,
- "label": "string"
}, - "type": {
- "id": 1,
- "label": "string"
}, - "ownerAccount": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "videoChannelPosition": 1
}
]
}List my abuses
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| id | integer only list the report with this id |
| sort | string Enum: "-id" "-createdAt" "-state" Sort abuses by criteria |
| start | integer >= 0 Offset used to paginate results |
| state | integer (AbuseStateSet) Enum: 1 2 3 The abuse state (Pending = |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "reason": "The video is a spam",
- "predefinedReasons": [
- "spamOrMisleading"
], - "reporterAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "state": {
- "id": 1,
- "label": "string"
}, - "moderationComment": "Decided to ban the server since it spams us regularly",
- "video": {
- "id": 0,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "nsfw": true,
- "startAt": "2019-08-24T14:15:22Z",
- "endAt": "2019-08-24T14:15:22Z",
- "deleted": true,
- "blacklisted": true,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}List abuses
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| filter | string Enum: "video" "comment" "account" only list account, comment or video reports |
| id | integer only list the report with this id |
| predefinedReason | Array of strings (PredefinedAbuseReasons) <= 8 items Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions" predefined reason the listed reports should contain |
| search | string plain search that will match with video titles, reporter names and more |
| searchReportee | string only list reports of a specific reportee |
| searchReporter | string only list reports of a specific reporter |
| searchVideo | string only list reports of a specific video |
| searchVideoChannel | string only list reports of a specific video channel |
| sort | string Enum: "-id" "-createdAt" "-state" Sort abuses by criteria |
| start | integer >= 0 Offset used to paginate results |
| state | integer (AbuseStateSet) Enum: 1 2 3 The abuse state (Pending = |
| videoIs | string Enum: "deleted" "blacklisted" only list deleted or blocklisted videos |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "reason": "The video is a spam",
- "predefinedReasons": [
- "spamOrMisleading"
], - "reporterAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "state": {
- "id": 1,
- "label": "string"
}, - "moderationComment": "Decided to ban the server since it spams us regularly",
- "video": {
- "id": 0,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "name": "string",
- "nsfw": true,
- "startAt": "2019-08-24T14:15:22Z",
- "endAt": "2019-08-24T14:15:22Z",
- "deleted": true,
- "blacklisted": true,
- "thumbnailPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "channel": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "displayName": "Videos of Framasoft",
- "description": "Videos made with <3 by Framasoft",
- "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
- "publicEmail": "user@example.com",
- "isLocal": true,
- "banners": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "ownerAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "videosCount": 0,
- "viewsPerDay": [
- {
- "date": "2019-08-24T14:15:22Z",
- "views": 0
}
], - "viewsGroupInterval": "day",
- "totalViews": 0
}
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Report an abuse
You cannot report a video that you own or on which you are a collaborator (video channel editor).
Authorizations:
OAuth2
Request Body schema: application/jsonrequired
| reason required | string [ 2 .. 3000 ] characters Reason why the user reports this video |
object | |
object | |
| predefinedReasons | Array of strings (PredefinedAbuseReasons) <= 8 items Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions" Reason categories that help triage reports |
object |
Responses
Request samples
- Payload
Content type
application/json
{- "reason": "string",
- "predefinedReasons": [
- "violentOrAbusive"
], - "video": {
- "id": 42,
- "startAt": 0,
- "endAt": 0
}, - "comment": {
- "id": 42
}, - "account": {
- "id": 0
}
}Response samples
- 200
Content type
application/json
{- "abuse": {
- "id": 42
}
}Update an abuse
Authorizations:
OAuth2
path Parameters
| abuseId required | integer >= 1 Example: 42 Abuse id |
Request Body schema: application/json
| moderationComment | string [ 2 .. 3000 ] characters Update the report comment visible only to the moderation team |
| state | integer (AbuseStateSet) Enum: 1 2 3 The abuse state (Pending = |
Responses
Request samples
- Payload
Content type
application/json
{- "state": 1,
- "moderationComment": "string"
}List messages of an abuse
Authorizations:
OAuth2
path Parameters
| abuseId required | integer >= 1 Example: 42 Abuse id |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "message": "string",
- "byModerator": true,
- "createdAt": "2019-08-24T14:15:22Z",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
}
]
}Operations dealing with blocking videos (removing them from view and preventing interactions).
Block a video
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| internalNote | string Internal note for moderators/admins |
| reason | string Reason for the block (public) |
| unfederate | boolean Whether to unfederate the video |
Responses
Request samples
- Payload
Content type
application/json
{- "reason": "string",
- "unfederate": true,
- "internalNote": "string"
}Update a video block
Authorizations:
OAuth2
path Parameters
required | id (integer) or UUIDv4 (string) or shortUUID (string) The object id, uuid or short uuid |
Request Body schema: application/json
| internalNote | string Internal note for moderators/admins |
| reason | string Reason for the block (displayed publicly) |
Responses
Request samples
- Payload
Content type
application/json
{- "reason": "string",
- "internalNote": "string"
}List video blocks
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string plain search that will match with video titles, and more |
| sort | string Enum: "-id" "name" "-duration" "-views" "-likes" "-dislikes" "-uuid" "-createdAt" Sort blocklists by criteria |
| start | integer >= 0 Offset used to paginate results |
| type | integer Enum: 1 2 list only blocks that match this type:
|
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "reason": "string",
- "internalNote": "string",
- "unfederated": true,
- "type": 0,
- "video": {
- "id": 42,
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
- "isLive": true,
- "liveSchedules": [
- {
- "startAt": "2019-08-24T14:15:22Z"
}
], - "createdAt": "2017-10-01T10:52:46.396Z",
- "publishedAt": "2018-10-01T10:52:46.396Z",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
- "category": {
- "id": 15,
- "label": "Science & Technology"
}, - "licence": {
- "id": 2,
- "label": "Attribution - Share Alike"
}, - "language": {
- "id": "en",
- "label": "English"
}, - "privacy": {
- "id": 1,
- "label": "string"
}, - "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
- "duration": 1419,
- "aspectRatio": 1.778,
- "isLocal": true,
- "name": "What is PeerTube?",
- "thumbnailPath": "string",
- "previewPath": "string",
- "thumbnails": [
- {
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "aspectRatio": "16:9"
}
], - "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
- "views": 1337,
- "likes": 42,
- "dislikes": 7,
- "comments": 0,
- "nsfw": true,
- "nsfwFlags": 0,
- "nsfwSummary": "string",
- "waitTranscoding": true,
- "state": {
- "id": 1,
- "label": "string"
}, - "scheduledUpdate": {
- "privacy": 1,
- "updateAt": "2019-08-24T14:15:22Z"
}, - "blacklisted": true,
- "blacklistedReason": "string",
- "account": {
- "id": 0,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "channel": {
- "id": 42,
- "name": "string",
- "displayName": "string",
- "url": "string",
- "host": "example.com",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}, - "userHistory": {
- "currentTime": 0
}
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Get block status of accounts/hosts
query Parameters
| accounts | Array of strings Example: accounts=goofy@example.com&accounts=donald@example.com Check if these accounts are blocked |
| hosts | Array of strings Example: hosts=example.com Check if these hosts are blocked |
Responses
Response samples
- 200
Content type
application/json
{- "accounts": {
- "account1": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}, - "account2": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}
}, - "hosts": {
- "host1": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}, - "host2": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}
}
}List accounts blocked by my account
Get the list of accounts that the authenticated user has blocked
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Search query string |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "byAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blockedAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blocklistSubscription": {
- "id": 42,
- "name": "string",
- "url": "string"
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Block an account by my account
Add an account to the authenticated user's blocklist
Authorizations:
OAuth2
Request Body schema: application/jsonrequired
| accountName required | string Account name to block (format: name@host) |
Responses
Request samples
- Payload
Content type
application/json
{- "accountName": "user@example.com"
}List servers blocked by my account
Get the list of servers that the authenticated user has blocked
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Search query string |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "byAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blockedServer": {
- "host": "example.com"
}, - "blocklistSubscription": {
- "id": 42,
- "name": "string",
- "url": "string"
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}Get block status of accounts/hosts
query Parameters
| accounts | Array of strings Example: accounts=goofy@example.com&accounts=donald@example.com Check if these accounts are blocked |
| hosts | Array of strings Example: hosts=example.com Check if these hosts are blocked |
Responses
Response samples
- 200
Content type
application/json
{- "accounts": {
- "account1": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}, - "account2": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}
}, - "hosts": {
- "host1": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}, - "host2": {
- "blockedByServer": true,
- "blockedByServerSubscription": "string",
- "blockedByUser": true
}
}
}List blocked accounts by server
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| subscriptionName | string |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "byAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blockedAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blocklistSubscription": {
- "id": 42,
- "name": "string",
- "url": "string"
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}List blocked servers by server
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| subscriptionName | string |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "byAccount": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "userId": 42,
- "displayName": "string",
- "description": "string"
}, - "blockedServer": {
- "host": "example.com"
}, - "blocklistSubscription": {
- "id": 42,
- "name": "string",
- "url": "string"
}, - "createdAt": "2019-08-24T14:15:22Z"
}
]
}List server blocklist subscriptions
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "name": "string",
- "url": "string",
- "mutedAccountsCount": 0,
- "mutedServersCount": 0,
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Add a server blocklist subscription
Authorizations:
OAuth2
Request Body schema: application/json
| url required | string <url> |
Responses
Request samples
- Payload
Content type
application/json
{- "url": "string"
}Response samples
- 200
Content type
application/json
{- "id": 42,
- "name": "string",
- "url": "string",
- "mutedAccountsCount": 0,
- "mutedServersCount": 0,
- "lastSyncAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)
List account watched words
PeerTube >= 6.2
Authorizations:
OAuth2
path Parameters
| accountName required | string account name to list watched words |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "listName": "string",
- "words": [
- "string"
], - "subscriptionUrl": "string",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}
]
}Add account watched words
PeerTube >= 6.2
Authorizations:
OAuth2
path Parameters
| accountName required | string |
Request Body schema: application/json
| listName | string |
| words | Array of strings |
Responses
Request samples
- Payload
Content type
application/json
{- "listName": "string",
- "words": [
- "string"
]
}Response samples
- 200
Content type
application/json
{- "watchedWordsList": {
- "id": 0
}
}Update account watched words
PeerTube >= 6.2
Authorizations:
OAuth2
path Parameters
| accountName required | string |
| listId required | string list of watched words to update |
Request Body schema: application/json
| listName | string |
| words | Array of strings |
Responses
Request samples
- Payload
Content type
application/json
{- "listName": "string",
- "words": [
- "string"
]
}Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "listName": "string",
- "words": [
- "string"
], - "subscriptionUrl": "string",
- "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}
]
}Add server watched words
PeerTube >= 6.2
Authorizations:
OAuth2
Request Body schema: application/json
| listName | string |
| words | Array of strings |
Responses
Request samples
- Payload
Content type
application/json
{- "listName": "string",
- "words": [
- "string"
]
}Response samples
- 200
Content type
application/json
{- "watchedWordsList": {
- "id": 0
}
}Update server watched words
PeerTube >= 6.2
Authorizations:
OAuth2
path Parameters
| listId required | string list of watched words to update |
Request Body schema: application/json
| listName | string |
| words | Array of strings |
Responses
Request samples
- Payload
Content type
application/json
{- "listName": "string",
- "words": [
- "string"
]
}List account watched words subscriptions
Authorizations:
OAuth2
path Parameters
| accountName required | string account name to list watched words subscriptions |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "name": "string",
- "url": "string",
- "importedWordsCount": 0,
- "lastSyncAt": "2021-05-04T08:01:01.502Z",
- "state": {
- "id": 1,
- "label": "string"
}, - "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}
]
}Add account watched words subscription
Authorizations:
OAuth2
path Parameters
| accountName required | string |
Request Body schema: application/json
| url required | string <url> |
Responses
Request samples
- Payload
Content type
application/json
{- "url": "string"
}Response samples
- 200
Content type
application/json
{- "id": 42,
- "name": "string",
- "url": "string",
- "importedWordsCount": 0,
- "lastSyncAt": "2021-05-04T08:01:01.502Z",
- "state": {
- "id": 1,
- "label": "string"
}, - "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}List server watched words subscriptions
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "name": "string",
- "url": "string",
- "importedWordsCount": 0,
- "lastSyncAt": "2021-05-04T08:01:01.502Z",
- "state": {
- "id": 1,
- "label": "string"
}, - "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}
]
}Add server watched words subscription
Authorizations:
OAuth2
Request Body schema: application/json
| url required | string <url> |
Responses
Request samples
- Payload
Content type
application/json
{- "url": "string"
}Response samples
- 200
Content type
application/json
{- "id": 42,
- "name": "string",
- "url": "string",
- "importedWordsCount": 0,
- "lastSyncAt": "2021-05-04T08:01:01.502Z",
- "state": {
- "id": 1,
- "label": "string"
}, - "updatedAt": "2021-05-04T08:01:01.502Z",
- "createdAt": "2021-05-04T08:01:01.502Z"
}Response samples
- 200
Content type
application/json
{- "client": {
- "newFeaturesInfo": true,
- "header": {
- "hideInstanceName": false
}, - "videos": {
- "miniature": {
- "preferAuthorDisplayName": true
}, - "resumableUpload": {
- "maxChunkSize": 0,
- "minChunkSize": 0
}
}, - "browseVideos": {
- "defaultSort": "-publishedAt",
- "defaultScope": "federated",
- "includeScheduledLive": false
}, - "menu": {
- "login": {
- "redirectOnSingleExternalAuth": false
}
}, - "openInApp": {
- "android": {
- "intent": {
- "enabled": true,
- "host": "joinpeertube.org",
- "scheme": "peertube",
}
}, - "ios": {
- "enabled": true,
- "host": "joinpeertube.org",
- "scheme": "peertube",
}
}
}, - "defaults": {
- "publish": {
- "downloadEnabled": true,
- "commentsPolicy": 1,
- "privacy": 4,
- "licence": null
}, - "live": {
- "saveReplay": false
}, - "p2p": {
- "webapp": {
- "enabled": true
}, - "embed": {
- "enabled": true
}
}, - "player": {
- "theme": "lucide",
- "autoPlay": true
}
}, - "webadmin": {
- "configuration": {
- "edition": {
- "allowed": true
}
}
}, - "instance": {
- "name": "PeerTube Nightly",
- "shortDescription": "PeerTube instance updated nightly",
- "isNSFW": false,
- "defaultNSFWPolicy": "do_not_list",
- "defaultClientRoute": "/home",
- "serverCountry": "",
- "support": {
- "text": ""
}, - "social": {
- "blueskyLink": "",
- "mastodonLink": "",
- "xLink": "",
- "externalLink": ""
}, - "customizations": {
- "javascript": "",
- "css": ""
}, - "defaultLanguage": "en-US",
- "avatars": [
- {
- "height": 1500,
- "width": 1500,
- "path": "/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png",
- "createdAt": "2024-05-15T09:12:38.684Z",
- "updatedAt": "2024-05-15T09:12:38.684Z"
}, - {
- "height": 600,
- "width": 600,
- "path": "/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png",
- "createdAt": "2024-05-15T09:12:38.709Z",
- "updatedAt": "2024-05-15T09:12:38.709Z"
}, - {
- "height": 120,
- "width": 120,
- "path": "/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png",
- "createdAt": "2024-05-15T09:12:38.719Z",
- "updatedAt": "2024-05-15T09:12:38.719Z"
}, - {
- "height": 48,
- "width": 48,
- "path": "/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png",
- "createdAt": "2024-05-15T09:12:38.749Z",
- "updatedAt": "2024-05-15T09:12:38.749Z"
}
], - "banners": [
- {
- "height": 100,
- "width": 600,
- "path": "/lazy-static/banners/d853452c-f020-4c6f-a4ea-9fc582d68ff2.jpg",
- "createdAt": "2024-04-16T14:09:02.665Z",
- "updatedAt": "2024-04-16T14:09:02.665Z"
}, - {
- "height": 317,
- "width": 1920,
- "path": "/lazy-static/banners/772ff0ae-6cb5-4d1c-b89b-ace85eece196.jpg",
- "createdAt": "2024-04-16T14:09:02.615Z",
- "updatedAt": "2024-04-16T14:09:02.615Z"
}
], - "logo": [
- {
- "height": 1500,
- "width": 1500,
- "type": "favicon",
- "isFallback": true
}, - {
- "height": 600,
- "width": 600,
- "type": "favicon",
- "isFallback": true
}, - {
- "height": 120,
- "width": 120,
- "type": "favicon",
- "isFallback": true
}, - {
- "height": 48,
- "width": 48,
- "type": "favicon",
- "isFallback": true
}, - {
- "height": 1500,
- "width": 1500,
- "type": "header-square",
- "isFallback": true
}, - {
- "height": 600,
- "width": 600,
- "type": "header-square",
- "isFallback": true
}, - {
- "height": 120,
- "width": 120,
- "type": "header-square",
- "isFallback": true
}, - {
- "height": 48,
- "width": 48,
- "type": "header-square",
- "isFallback": true
}, - {
- "height": 1500,
- "width": 1500,
- "type": "header-wide",
- "isFallback": true
}, - {
- "height": 600,
- "width": 600,
- "type": "header-wide",
- "isFallback": true
}, - {
- "height": 120,
- "width": 120,
- "type": "header-wide",
- "isFallback": true
}, - {
- "height": 48,
- "width": 48,
- "type": "header-wide",
- "isFallback": true
}, - {
- "height": 1500,
- "width": 1500,
- "type": "opengraph",
- "isFallback": true
}, - {
- "height": 600,
- "width": 600,
- "type": "opengraph",
- "isFallback": true
}, - {
- "height": 120,
- "width": 120,
- "type": "opengraph",
- "isFallback": true
}, - {
- "height": 48,
- "width": 48,
- "type": "opengraph",
- "isFallback": true
}
]
}, - "search": {
- "remoteUri": {
- "users": true,
- "anonymous": false
}, - "searchIndex": {
- "enabled": true,
- "disableLocalSearch": false,
- "isDefaultSearch": true
}
}, - "plugin": {
- "registered": [
- {
- "npmName": "peertube-plugin-matomo",
- "name": "matomo",
- "version": "1.0.2",
- "description": "Matomo plugin that tracks page views on a PeerTube instance.",
- "clientScripts": {
- "dist/common-client-plugin.js": {
- "script": "dist/common-client-plugin.js",
- "scopes": [
- "common"
]
}, - "dist/embed-client-plugin.js": {
- "script": "dist/embed-client-plugin.js",
- "scopes": [
- "embed"
]
}
}
}, - {
- "npmName": "peertube-plugin-auto-mute",
- "name": "auto-mute",
- "version": "0.0.8",
- "description": "Auto mute plugin for PeerTube",
- "clientScripts": { }
}, - {
- "npmName": "peertube-plugin-auth-openid-connect",
- "name": "auth-openid-connect",
- "version": "2.1.0",
- "description": "Add OpenID connect support to login form in PeerTube.",
- "clientScripts": { }
}, - {
- "npmName": "peertube-plugin-auth-ldap",
- "name": "auth-ldap",
- "version": "0.0.14",
- "description": "Add LDAP support to login form in PeerTube.",
- "clientScripts": { }
}, - {
- "npmName": "peertube-plugin-transcoding-custom-quality",
- "name": "transcoding-custom-quality",
- "version": "0.2.0",
- "description": "Set a custom quality for transcoding",
- "clientScripts": { }
}, - {
- "npmName": "peertube-plugin-ultimate-transcoding",
- "name": "ultimate-transcoding",
- "version": "0.6.2",
- "description": "Ultimate PeerTube transcoding controls with a cleaner settings UI and FFmpeg overrides",
- "clientScripts": {
- "client/admin-plugin-client-plugin.js": {
- "script": "client/admin-plugin-client-plugin.js",
- "scopes": [
- "admin-plugin"
]
}
}
}, - {
- "npmName": "peertube-plugin-video-annotation",
- "name": "video-annotation",
- "version": "0.2.0",
- "description": "PeerTube plugin video annotation",
- "clientScripts": {
- "dist/embed-client-plugin.js": {
- "script": "dist/embed-client-plugin.js",
- "scopes": [
- "embed"
]
}, - "dist/video-edit-client-plugin.js": {
- "script": "dist/video-edit-client-plugin.js",
- "scopes": [
- "video-edit"
]
}, - "dist/video-watch-client-plugin.js": {
- "script": "dist/video-watch-client-plugin.js",
- "scopes": [
- "video-watch"
]
}
}
}, - {
- "npmName": "peertube-plugin-livechat",
- "name": "livechat",
- "version": "14.0.2",
- "description": "PeerTube plugin livechat: create chat rooms for your Peertube lives! Comes with many features: federation, moderation tools, chat bot, chat persistence, OBS integration, ...",
- "clientScripts": {
- "dist/client/common-client-plugin.js": {
- "script": "dist/client/common-client-plugin.js",
- "scopes": [
- "common"
]
}, - "dist/client/admin-plugin-client-plugin.js": {
- "script": "dist/client/admin-plugin-client-plugin.js",
- "scopes": [
- "admin-plugin"
]
}
}
}
], - "registeredExternalAuths": [ ],
- "registeredIdAndPassAuths": [
- {
- "npmName": "peertube-plugin-auth-ldap",
- "name": "auth-ldap",
- "version": "0.0.14",
- "authName": "ldap",
- "weight": 100
}
]
}, - "theme": {
- "registered": [
- {
- "npmName": "peertube-theme-dark",
- "name": "dark",
- "version": "3.0.2",
- "description": "PeerTube dark theme",
- "css": [
- "assets/style.css"
], - "clientScripts": { }
}, - {
- "npmName": "peertube-theme-framasoft",
- "name": "framasoft",
- "version": "1.0.0",
- "description": "PeerTube Framasoft theme",
- "css": [
- "assets/style.css"
], - "clientScripts": { }
}
], - "builtIn": [
- {
- "name": "peertube-core-dark-brown"
}, - {
- "name": "peertube-core-light-beige"
}
], - "default": "default",
- "customization": {
- "primaryColor": null,
- "onPrimaryColor": null,
- "foregroundColor": null,
- "backgroundColor": null,
- "backgroundSecondaryColor": null,
- "menuForegroundColor": null,
- "menuBackgroundColor": null,
- "menuBorderRadius": null,
- "headerForegroundColor": null,
- "headerBackgroundColor": null,
- "inputBorderRadius": null
}
}, - "email": {
- "enabled": true
}, - "contactForm": {
- "enabled": true
}, - "serverVersion": "8.3.1-nightly-2026-10-16",
- "serverCommit": "",
- "transcoding": {
- "remoteRunners": {
- "enabled": true
}, - "hls": {
- "enabled": true,
- "splitAudioAndVideo": true
}, - "web_videos": {
- "enabled": false
}, - "enabledResolutions": [
- 0,
- 240,
- 480
], - "profile": "ultimate-transcoding",
- "availableProfiles": [
- "default",
- "custom-quality",
- "ultimate-transcoding"
], - "alwaysTranscodeOriginalResolution": true,
- "alwaysTranscodePodcastOptimizedAudio": true
}, - "live": {
- "enabled": true,
- "allowReplay": true,
- "dvr": {
- "maxWindow": 3600
}, - "latencySetting": {
- "enabled": true
}, - "maxDuration": -1,
- "maxInstanceLives": 20,
- "maxUserLives": 4,
- "transcoding": {
- "enabled": true,
- "remoteRunners": {
- "enabled": true
}, - "enabledResolutions": [
- 360
], - "profile": "default",
- "availableProfiles": [
- "default",
- "custom-quality",
- "ultimate-transcoding"
]
}, - "rtmp": {
- "port": 1935
}
}, - "videoStudio": {
- "enabled": true,
- "remoteRunners": {
- "enabled": false
}
}, - "videoFile": {
- "update": {
- "enabled": true
}
}, - "videoTranscription": {
- "enabled": true,
- "remoteRunners": {
- "enabled": true
}
}, - "import": {
- "videos": {
- "http": {
- "enabled": true
}, - "torrent": {
- "enabled": true
}
}, - "videoChannelSynchronization": {
- "enabled": true
}, - "users": {
- "enabled": true,
- "resumableUpload": {
- "minChunkSize": 0
}
}
}, - "export": {
- "users": {
- "enabled": true,
- "exportExpiration": 172800000,
- "maxUserVideoQuota": 10737418240
}
}, - "autoBlacklist": {
- "videos": {
- "ofUsers": {
- "enabled": true
}
}
}, - "avatar": {
- "file": {
- "size": {
- "max": 8388608
}, - "extensions": [
- ".png",
- ".jpeg",
- ".jpg",
- ".gif",
- ".webp"
]
}
}, - "banner": {
- "file": {
- "size": {
- "max": 8388608
}, - "extensions": [
- ".png",
- ".jpeg",
- ".jpg",
- ".gif",
- ".webp"
]
}
}, - "logo": {
- "file": {
- "size": {
- "max": 8388608
}, - "extensions": [
- ".svg",
- ".png",
- ".jpeg",
- ".jpg",
- ".gif",
- ".webp"
]
}
}, - "video": {
- "image": {
- "extensions": [
- ".png",
- ".jpg",
- ".jpeg",
- ".webp"
], - "size": {
- "max": 8388608
}
}, - "file": {
- "extensions": [
- ".webm",
- ".ogv",
- ".ogg",
- ".mp4",
- ".mkv",
- ".mov",
- ".qt",
- ".mqv",
- ".m4v",
- ".flv",
- ".f4v",
- ".wmv",
- ".avi",
- ".3gp",
- ".3gpp",
- ".3g2",
- ".3gpp2",
- ".nut",
- ".mts",
- ".ts",
- ".m2ts",
- ".mpv",
- ".m2v",
- ".m1v",
- ".mpg",
- ".mpe",
- ".mpeg",
- ".vob",
- ".mxf",
- ".mp3",
- ".wma",
- ".wav",
- ".flac",
- ".aac",
- ".m4a",
- ".m4b",
- ".ac3"
]
}
}, - "videoCaption": {
- "file": {
- "size": {
- "max": 20971520
}, - "extensions": [
- ".vtt",
- ".srt"
]
}
}, - "user": {
- "videoQuota": 524288000,
- "videoQuotaDaily": 104857600
}, - "videoChannels": {
- "maxPerUser": 20
}, - "trending": {
- "videos": {
- "intervalDays": 7,
- "algorithms": {
- "enabled": [
- "best",
- "hot",
- "most-viewed",
- "most-liked"
], - "default": "most-viewed"
}
}
}, - "tracker": {
- "enabled": true
}, - "followings": {
}, - "blocklist": {
- "publicLog": {
- "enabled": true
}
}, - "federation": {
- "enabled": true
}, - "broadcastMessage": {
- "enabled": false,
- "message": "We are currently experiencing technical problems on this instance. We are trying to fix it as soon as possible. Thank you for your understanding.",
- "level": "error",
- "dismissable": true
}, - "homepage": {
- "enabled": true
}, - "openTelemetry": {
- "metrics": {
- "enabled": true,
- "playbackStatsInterval": 15000
}
}, - "views": {
- "videos": {
- "countViewAfter": 10000,
- "remote": {
- "maxAge": 2592000000
}, - "local": {
- "maxAge": -1
}, - "watchingInterval": {
- "anonymous": 5000,
- "users": 5000
}
}
}, - "storyboards": {
- "enabled": true,
- "remoteRunners": {
- "enabled": false
}
}, - "webrtc": {
- "stunServers": [
- "stun:stunserver2025.stunprotocol.org",
- "stun:stun.framasoft.org",
- "stun:stun.ekiga.net",
- "stun:stun.freeswitch.org"
]
}, - "nsfwFlagsSettings": {
- "enabled": true
}, - "fieldsConstraints": {
- "users": {
- "password": {
- "minLength": 8,
- "maxLength": 50
}
}
}, - "signup": {
- "allowed": false,
- "allowedForCurrentIP": true,
- "minimumAge": 16,
- "requiresApproval": true,
- "requiresEmailVerification": true
}
}
Response samples
- 200
Content type
application/json
{- "instance": {
- "name": "PeerTube Nightly",
- "shortDescription": "PeerTube instance updated nightly",
- "description": "This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.",
- "terms": "No terms for now. Being a closed test instance, no real terms of use beyond fair use are to be expected.",
- "codeOfConduct": "",
- "hardwareInformation": "",
- "creationReason": "",
- "moderationInformation": "This instance only allows...",
- "administrator": "",
- "maintenanceLifetime": "",
- "businessModel": "",
- "languages": [
- "fr"
], - "categories": [
- 16
], - "banners": [
- {
- "height": 100,
- "width": 600,
- "path": "/lazy-static/banners/d853452c-f020-4c6f-a4ea-9fc582d68ff2.jpg",
- "createdAt": "2024-04-16T14:09:02.665Z",
- "updatedAt": "2024-04-16T14:09:02.665Z"
}, - {
- "height": 317,
- "width": 1920,
- "path": "/lazy-static/banners/772ff0ae-6cb5-4d1c-b89b-ace85eece196.jpg",
- "createdAt": "2024-04-16T14:09:02.615Z",
- "updatedAt": "2024-04-16T14:09:02.615Z"
}
], - "avatars": [
- {
- "height": 1500,
- "width": 1500,
- "path": "/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png",
- "createdAt": "2024-05-15T09:12:38.684Z",
- "updatedAt": "2024-05-15T09:12:38.684Z"
}, - {
- "height": 600,
- "width": 600,
- "path": "/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png",
- "createdAt": "2024-05-15T09:12:38.709Z",
- "updatedAt": "2024-05-15T09:12:38.709Z"
}, - {
- "height": 120,
- "width": 120,
- "path": "/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png",
- "createdAt": "2024-05-15T09:12:38.719Z",
- "updatedAt": "2024-05-15T09:12:38.719Z"
}, - {
- "height": 48,
- "width": 48,
- "path": "/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png",
- "createdAt": "2024-05-15T09:12:38.749Z",
- "updatedAt": "2024-05-15T09:12:38.749Z"
}
]
}
}Response samples
- 200
Content type
application/json
{- "instance": {
- "name": "string",
- "shortDescription": "string",
- "description": "string",
- "terms": "string",
- "codeOfConduct": "string",
- "creationReason": "string",
- "moderationInformation": "string",
- "administrator": "string",
- "maintenanceLifetime": "string",
- "businessModel": "string",
- "hardwareInformation": "string",
- "languages": [
- "string"
], - "categories": [
- 0
], - "isNSFW": true,
- "defaultNSFWPolicy": "string",
- "serverCountry": "string",
- "support": {
- "text": "string"
}, - "social": {
- "externalLink": "string",
- "mastodonLink": "string",
- "blueskyLink": "string",
- "xLink": "string"
}, - "defaultClientRoute": "string",
- "customizations": {
- "javascript": "string",
- "css": "string"
}
}, - "theme": {
- "default": "string"
}, - "services": {
- "twitter": {
- "username": "string"
}
}, - "cache": {
- "previews": {
- "size": 0
}, - "captions": {
- "size": 0
}
}, - "signup": {
- "enabled": true,
- "limit": 0,
- "requiresEmailVerification": true
}, - "admin": {
- "email": "user@example.com"
}, - "contactForm": {
- "enabled": true
}, - "user": {
- "videoQuota": 16810141515,
- "videoQuotaDaily": 1681014151
}, - "transcoding": {
- "enabled": true,
- "originalFile": {
- "keep": true
}, - "allowAdditionalExtensions": true,
- "allowAudioFiles": true,
- "threads": 0,
- "concurrency": 0,
- "profile": "default",
- "resolutions": {
- "0p": true,
- "144p": true,
- "240p": true,
- "360p": true,
- "480p": true,
- "720p": true,
- "1080p": true,
- "1440p": true,
- "2160p": true
}, - "web_videos": {
- "enabled": true
}, - "hls": {
- "enabled": true,
- "splitAudioAndVideo": true
}
}, - "import": {
- "videos": {
- "http": {
- "enabled": true
}, - "torrent": {
- "enabled": true
}
}, - "video_channel_synchronization": {
- "enabled": true
}
}, - "autoBlacklist": {
- "videos": {
- "ofUsers": {
- "enabled": true
}
}
}, - "blocklist": {
- "publicLog": {
- "enabled": true
}
}, - "followers": {
- "instance": {
- "enabled": true,
- "manualApproval": true
}
}, - "storyboard": {
- "enabled": true
}, - "defaults": {
- "publish": {
- "downloadEnabled": true,
- "commentsPolicy": 1,
- "privacy": 1,
- "licence": 2
}, - "p2p": {
- "webapp": {
- "enabled": true
}, - "embed": {
- "enabled": true
}
}, - "player": {
- "autoPlay": true
}
}
}Update client language Deprecated
Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.
Request Body schema: application/jsonrequired
| language required | string or null Language code to set |
Responses
Request samples
- Payload
Content type
application/json
{- "language": "en-US"
}Update client language
Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.
Request Body schema: application/jsonrequired
| language required | string or null Language code to set, or |
Responses
Request samples
- Payload
Content type
application/json
{- "language": "en-US"
}Managing servers which the instance interacts with is crucial to the concept of federation in PeerTube and external video indexation. The PeerTube server then deals with inter-server ActivityPub operations and propagates information across its social graph by posting activities to actors' inbox endpoints.
List instances following the server
query Parameters
| actorType | string Enum: "Person" "Application" "Group" "Service" "Organization" |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| state | string Enum: "pending" "accepted" |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "follower": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "following": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "score": 0,
- "state": "pending",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}List instances followed by the server
query Parameters
| actorType | string Enum: "Person" "Application" "Group" "Service" "Organization" |
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| state | string Enum: "pending" "accepted" |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "follower": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "following": {
- "id": 42,
- "url": "string",
- "name": "chocobozzz",
- "avatars": [
- {
- "path": "string",
- "fileUrl": "string",
- "width": 0,
- "height": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "host": "example.com",
- "hostRedundancyAllowed": true,
- "followingCount": 0,
- "followersCount": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "score": 0,
- "state": "pending",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Follow a list of actors (PeerTube instance, channel or account)
Authorizations:
OAuth2
Request Body schema: application/json
| handles | Array of strings unique |
| hosts | Array of strings <hostname> unique [ items <hostname > ] |
Responses
Request samples
- Payload
Content type
application/json
{- "hosts": [
- "example.com"
], - "handles": [
- "string"
]
}Redundancy is part of the inter-server solidarity that PeerTube fosters. Manage the list of instances you wish to help by seeding their videos according to the policy of video selection of your choice. Note that you have a similar functionality to mirror individual videos, see video mirroring.
Update a server redundancy policy
Authorizations:
OAuth2
path Parameters
| host required | string <hostname> server domain to mirror |
Request Body schema: application/json
| redundancyAllowed required | boolean allow mirroring of the host's local videos |
Responses
Request samples
- Payload
Content type
application/json
{- "redundancyAllowed": true
}Managing plugins installed from a local path or from NPM, or search for new ones.
List plugins
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| pluginType | integer |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
| uninstalled | boolean |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "name": "peertube-plugin-auth-ldap",
- "type": 1,
- "latestVersion": "0.0.3",
- "version": "0.0.1",
- "enabled": true,
- "uninstalled": true,
- "peertubeEngine": "2.2.0",
- "description": "string",
- "settings": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}List available plugins
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| currentPeerTubeEngine | string |
| pluginType | integer |
| search | string |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "name": "peertube-plugin-auth-ldap",
- "type": 1,
- "latestVersion": "0.0.3",
- "version": "0.0.1",
- "enabled": true,
- "uninstalled": true,
- "peertubeEngine": "2.2.0",
- "description": "string",
- "settings": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}Get a plugin
Authorizations:
OAuth2
path Parameters
| npmName required | string Example: peertube-plugin-auth-ldap name of the plugin/theme on npmjs.com or in its package.json |
Responses
Response samples
- 200
Content type
application/json
{- "name": "peertube-plugin-auth-ldap",
- "type": 1,
- "latestVersion": "0.0.3",
- "version": "0.0.1",
- "enabled": true,
- "uninstalled": true,
- "peertubeEngine": "2.2.0",
- "description": "string",
- "settings": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}Response samples
- 200
Content type
application/json
{- "totalUsers": 0,
- "totalDailyActiveUsers": 0,
- "totalWeeklyActiveUsers": 0,
- "totalMonthlyActiveUsers": 0,
- "totalModerators": 0,
- "totalAdmins": 0,
- "totalLocalVideos": 0,
- "totalLocalVideoViews": 0,
- "totalLocalVideoDownloads": 0,
- "totalLocalVideoComments": 0,
- "totalLocalVideoFilesSize": 0,
- "totalVideos": 0,
- "totalVideoComments": 0,
- "totalLocalVideoChannels": 0,
- "totalLocalDailyActiveVideoChannels": 0,
- "totalLocalWeeklyActiveVideoChannels": 0,
- "totalLocalMonthlyActiveVideoChannels": 0,
- "totalLocalPlaylists": 0,
- "totalInstanceFollowers": 0,
- "totalInstanceFollowing": 0,
- "videosRedundancy": [
- {
- "strategy": "string",
- "totalSize": 0,
- "totalUsed": 0,
- "totalVideoFiles": 0,
- "totalVideos": 0
}
], - "totalActivityPubMessagesProcessed": 0,
- "totalActivityPubMessagesSuccesses": 0,
- "totalActivityPubMessagesErrors": 0,
- "activityPubMessagesProcessedPerSecond": 0,
- "totalActivityPubMessagesWaiting": 0,
- "averageRegistrationRequestResponseTimeMs": 0,
- "totalRegistrationRequestsProcessed": 0,
- "totalRegistrationRequests": 0,
- "averageAbuseResponseTimeMs": 0,
- "totalAbusesProcessed": 0,
- "totalAbuses": 0
}Create playback metrics
These metrics are exposed by OpenTelemetry metrics exporter if enabled.
Request Body schema: application/json
| downloadedBytesHTTP required | number How many bytes were downloaded with HTTP since the last metric creation |
| downloadedBytesP2P required | number How many bytes were downloaded with P2P since the last metric creation |
| errors required | number How many errors occurred since the last metric creation |
| p2pEnabled required | boolean |
| playerMode required | string Enum: "p2p-media-loader" "web-video" |
| resolutionChanges required | number How many resolution changes occurred since the last metric creation |
| uploadedBytesP2P required | number How many bytes were uploaded with P2P since the last metric creation |
required | id (integer) or UUIDv4 (string) or shortUUID (string) |
| bufferStalled | number How many times buffer has been stalled since the last metric creation |
| fps | number Current player video fps |
| p2pPeers | number P2P peers connected (doesn't include WebSeed peers) |
| resolution | number Current player video resolution |
Responses
Request samples
- Payload
Content type
application/json
{- "playerMode": "p2p-media-loader",
- "resolution": 0,
- "fps": 0,
- "p2pEnabled": true,
- "p2pPeers": 0,
- "resolutionChanges": 0,
- "bufferStalled": 0,
- "errors": 0,
- "downloadedBytesP2P": 0,
- "downloadedBytesHTTP": 0,
- "uploadedBytesP2P": 0,
- "videoId": 42
}Send client log
Request Body schema: application/json
| level required | any Enum: "error" "warn" |
| message required | string |
| url required | string URL of the current user page |
| meta | string Additional information regarding this log |
| stackTrace | string Stack trace of the error if there is one |
| userAgent | string User agent of the web browser that sends the message |
Responses
Request samples
- Payload
Content type
application/json
{- "message": "string",
- "url": "string",
- "level": "error",
- "stackTrace": "string",
- "userAgent": "string",
- "meta": "string"
}Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.
Pause job queue
Authorizations:
OAuth2
Request Body schema: application/json
| processRoles | Array of strings non-empty Items Enum: "primary" "secondary" Roles of the PeerTube processes that must pause their job queue. Defaults to all the roles. Other processes are notified asynchronously. |
Responses
Request samples
- Payload
Content type
application/json
{- "processRoles": [
- "primary"
]
}Resume job queue
Authorizations:
OAuth2
Request Body schema: application/json
| processRoles | Array of strings non-empty Items Enum: "primary" "secondary" Roles of the PeerTube processes that must resume their job queue. Defaults to all the roles. Other processes are notified asynchronously. |
Responses
Request samples
- Payload
Content type
application/json
{- "processRoles": [
- "primary"
]
}List instance jobs
Authorizations:
OAuth2
path Parameters
| state required | string Enum: "" "active" "completed" "failed" "waiting" "delayed" The state of the job ('' for for no filter) |
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| jobType | string (JobType) Enum: "activitypub-cleaner" "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-broadcast-parallel" "activitypub-http-fetcher" "activitypub-http-unicast" "activitypub-refresher" "actor-keys" "after-video-channel-import" "build-automatic-tags" "build-object-automatic-tags" "create-user-export" "email" "federate-video" "generate-video-storyboard" "import-user-archive" "manage-video-torrent" "move-to-file-system" "move-to-object-storage" "notify" "transcoding-job-builder" "video-channel-import" "video-file-import" "video-files-lifecycle" "video-import" "video-live-ending" "video-redundancy" "video-studio-edition" "video-transcoding" "video-transcription" "videos-stats" job type |
| sort | string Example: sort=-createdAt Sort column |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 42,
- "state": "active",
- "type": "activitypub-cleaner",
- "data": { },
- "error": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "finishedOn": "2019-08-24T14:15:22Z",
- "processedOn": "2019-08-24T14:15:22Z",
- "canCancel": true
}
]
}Cancel a job
Abort a running job and its underlying ffmpeg/child process. Only active jobs that support cancellation can be cancelled.
Authorizations:
OAuth2
path Parameters
| jobId required | string The id of the job to cancel |
| jobType required | string (JobType) Enum: "activitypub-cleaner" "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-broadcast-parallel" "activitypub-http-fetcher" "activitypub-http-unicast" "activitypub-refresher" "actor-keys" "after-video-channel-import" "build-automatic-tags" "build-object-automatic-tags" "create-user-export" "email" "federate-video" "generate-video-storyboard" "import-user-archive" "manage-video-torrent" "move-to-file-system" "move-to-object-storage" "notify" "transcoding-job-builder" "video-channel-import" "video-file-import" "video-files-lifecycle" "video-import" "video-live-ending" "video-redundancy" "video-studio-edition" "video-transcoding" "video-transcription" "videos-stats" The type of the job to cancel |
Responses
List registration tokens
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Value: "createdAt" Sort registration tokens by criteria |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 0,
- "registrationToken": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "registeredRunnersCount": 0
}
]
}Request a new job
API used by PeerTube runners
Request Body schema: application/json
| runnerToken required | string |
| jobTypes | Array of strings Filter jobs depending on their types |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobTypes": [
- "string"
]
}Response samples
- 200
Content type
application/json
{- "availableJobs": [
- {
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "type": "vod-web-video-transcoding",
- "payload": {
- "input": {
- "videoFileUrl": "string"
}, - "output": {
- "resolution": 0,
- "fps": 0
}
}
}
]
}Accept job
API used by PeerTube runners
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Request Body schema: application/json
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string"
}Response samples
- 200
Content type
application/json
{- "job": {
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "type": "vod-web-video-transcoding",
- "state": {
- "id": 1,
- "label": "Processing"
}, - "payload": {
- "input": {
- "videoFileUrl": "string"
}, - "output": {
- "resolution": 0,
- "fps": 0
}
}, - "failures": 0,
- "error": "string",
- "progress": 0,
- "priority": 0,
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "startedAt": "2019-08-24T14:15:22Z",
- "finishedAt": "2019-08-24T14:15:22Z",
- "parent": {
- "type": "vod-web-video-transcoding",
- "state": {
- "id": 1,
- "label": "Processing"
}, - "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d"
}, - "runner": {
- "id": 0,
- "name": "string",
- "description": "string"
}, - "jobToken": "string"
}
}Abort job
API used by PeerTube runners
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Request Body schema: application/json
| jobToken required | string |
| reason required | string Why the runner aborts this job |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string",
- "reason": "string"
}Update job
API used by PeerTube runners
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Request Body schema: application/json
| jobToken required | string |
| runnerToken required | string |
object | |
| progress | integer Update job progression percentage (optional) |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string",
- "progress": 0,
- "payload": {
- "type": "add-chunk",
- "masterPlaylistFile": "string",
- "resolutionPlaylistFile": "string",
- "resolutionPlaylistFilename": "string",
- "videoChunkFile": "string",
- "videoChunkFilename": "string"
}
}Post job error
API used by PeerTube runners
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Request Body schema: application/json
| jobToken required | string |
| message required | string Why the runner failed to process this job |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string",
- "message": "string"
}Post job success
API used by PeerTube runners
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Request Body schema: application/json
| jobToken required | string |
required | VOD web video transcoding (object) or VOD HLS transcoding (object) or VOD audio merge transcoding (object) or Live RTMP to HLS transcoding (object) |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string",
- "payload": {
- "videoFile": "string"
}
}Download the max-quality audio file for a job video
API used by PeerTube runners.
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
Request Body schema: application/jsonrequired
| jobToken required | string |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string"
}Download the max-quality video file for a job video
API used by PeerTube runners.
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
Request Body schema: application/jsonrequired
| jobToken required | string |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string"
}Download the max-quality thumbnail for a job video
API used by PeerTube runners.
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
Request Body schema: application/jsonrequired
| jobToken required | string |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string"
}Download the max-quality preview for a job video
API used by PeerTube runners.
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
Request Body schema: application/jsonrequired
| jobToken required | string |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string"
}Download a video studio task file for a job video
API used by PeerTube runners.
path Parameters
| filename required | string Name of the task file to download |
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
required | id (integer) or UUIDv4 (string) or shortUUID (string) Video id or UUID |
Request Body schema: application/jsonrequired
| jobToken required | string |
| runnerToken required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "runnerToken": "string",
- "jobToken": "string"
}Delete a job
The endpoint will first cancel the job if needed, and then remove it from the database. Children jobs will also be removed
Authorizations:
OAuth2
path Parameters
| jobUUID required | string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d |
Responses
List jobs
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| search | string Plain text search, applied to various parts of the model depending on endpoint |
| sort | string Enum: "updatedAt" "createdAt" "priority" "state" "progress" Sort runner jobs by criteria |
| start | integer >= 0 Offset used to paginate results |
| stateOneOf | Array of integers (RunnerJobState) Items Enum: 1 2 3 4 5 6 7 8 |
| typeOneOf | Array of strings (RunnerJobType) Items Enum: "vod-web-video-transcoding" "vod-hls-transcoding" "vod-audio-merge-transcoding" "live-rtmp-hls-transcoding" |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
- "type": "vod-web-video-transcoding",
- "state": {
- "id": 1,
- "label": "Processing"
}, - "payload": {
- "input": {
- "videoFileUrl": "string"
}, - "output": {
- "resolution": 0,
- "fps": 0
}
}, - "failures": 0,
- "error": "string",
- "progress": 0,
- "priority": 0,
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "startedAt": "2019-08-24T14:15:22Z",
- "finishedAt": "2019-08-24T14:15:22Z",
- "parent": {
- "type": "vod-web-video-transcoding",
- "state": {
- "id": 1,
- "label": "Processing"
}, - "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d"
}, - "runner": {
- "id": 0,
- "name": "string",
- "description": "string"
}, - "privatePayload": { }
}
]
}Register a new runner
API used by PeerTube runners
Request Body schema: application/json
| name required | string |
| registrationToken required | string |
| description | string |
Responses
Request samples
- Payload
Content type
application/json
{- "registrationToken": "string",
- "name": "string",
- "description": "string"
}Response samples
- 200
Content type
application/json
{- "id": 0,
- "runnerToken": "string"
}List runners
Authorizations:
OAuth2
query Parameters
| count | integer [ 1 .. 100 ] Default: 15 Number of items to return |
| sort | string Value: "createdAt" Sort runners by criteria |
| start | integer >= 0 Offset used to paginate results |
Responses
Response samples
- 200
Content type
application/json
{- "total": 1,
- "data": [
- {
- "id": 0,
- "name": "string",
- "description": "string",
- "ip": "string",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "lastContact": "2019-08-24T14:15:22Z"
}
]
}