{ "openapi": "3.0.3", "info": { "title": "PeerTube", "version": "8.1.0", "contact": { "name": "PeerTube Community", "url": "https://joinpeertube.org" }, "license": { "name": "AGPLv3.0", "url": "https://github.com/Chocobozzz/PeerTube/blob/master/LICENSE" }, "x-logo": { "url": "https://joinpeertube.org/img/brand.png", "altText": "PeerTube Project Homepage" }, "description": "The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite\nHTTP/REST library for your programming language to use PeerTube.\n\nSee the [REST API quick start](https://docs.joinpeertube.org/api/rest-getting-started) for a few\nexamples of using the PeerTube API.\n\n# Authentication\n\nWhen you sign up for an account on a PeerTube instance, you are given the possibility\nto generate sessions on it, and authenticate there using an access token. Only __one\naccess token can currently be used at a time__.\n\n## Roles\n\nAccounts are given permissions based on their role. There are three roles on\nPeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin/managing-users#roles) for a detail of their permissions.\n\n# Errors\n\nThe API uses standard HTTP status codes to indicate the success or failure\nof the API call, completed by a [RFC7807-compliant](https://tools.ietf.org/html/rfc7807) response body.\n\n```\nHTTP 1.1 404 Not Found\nContent-Type: application/problem+json; charset=utf-8\n\n{\n \"detail\": \"Video not found\",\n \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\",\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"about:blank\"\n}\n```\n\nWe provide error `type` (following RFC7807) and `code` (internal PeerTube code) values for [a growing number of cases](https://github.com/Chocobozzz/PeerTube/blob/develop/packages/models/src/server/server-error-code.enum.ts),\nbut it is still optional. Types are used to disambiguate errors that bear the same status code\nand are non-obvious:\n\n```\nHTTP 1.1 403 Forbidden\nContent-Type: application/problem+json; charset=utf-8\n\n{\n \"detail\": \"Cannot get this video regarding follow constraints\",\n \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\",\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints\"\n}\n```\n\nHere a 403 error could otherwise mean that the video is private or blocklisted.\n\n### Validation errors\n\nEach parameter is evaluated on its own against a set of rules before the route validator\nproceeds with potential testing involving parameter combinations. Errors coming from validation\nerrors appear earlier and benefit from a more detailed error description:\n\n```\nHTTP 1.1 400 Bad Request\nContent-Type: application/problem+json; charset=utf-8\n\n{\n \"detail\": \"Incorrect request parameters: id\",\n \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\",\n \"instance\": \"/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180\",\n \"invalid-params\": {\n \"id\": {\n \"location\": \"params\",\n \"msg\": \"Invalid value\",\n \"param\": \"id\",\n \"value\": \"9c9de5e8-0a1e-484a-b099-e80766180\"\n }\n },\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"type\": \"about:blank\"\n}\n```\n\nWhere `id` is the name of the field concerned by the error, within the route definition.\n`invalid-params..location` can be either 'params', 'body', 'header', 'query' or 'cookies', and\n`invalid-params..value` reports the value that didn't pass validation whose `invalid-params..msg`\nis about.\n\n### Deprecated error fields\n\nSome fields could be included with previous versions. They are still included but their use is deprecated:\n- `error`: superseded by `detail`\n\n# Rate limits\n\nWe are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators:\n\n| Endpoint (prefix: `/api/v1`) | Calls | Time frame |\n|------------------------------|---------------|--------------|\n| `/*` | 50 | 10 seconds |\n| `POST /users/token` | 15 | 5 minutes |\n| `POST /users/register` | 2* | 5 minutes |\n| `POST /users/ask-send-verify-email` | 3 | 5 minutes |\n\nDepending on the endpoint, *failed requests are not taken into account. A service\nlimit is announced by a `429 Too Many Requests` status code.\n\nYou can get details about the current state of your rate limit by reading the\nfollowing headers:\n\n| Header | Description |\n|-------------------------|------------------------------------------------------------|\n| `X-RateLimit-Limit` | Number of max requests allowed in the current time period |\n| `X-RateLimit-Remaining` | Number of remaining requests in the current time period |\n| `X-RateLimit-Reset` | Timestamp of end of current time period as UNIX timestamp |\n| `Retry-After` | Seconds to delay after the first `429` is received |\n\n# CORS\n\nThis API features [Cross-Origin Resource Sharing (CORS)](https://fetch.spec.whatwg.org/),\nallowing cross-domain communication from the browser for some routes:\n\n| Endpoint |\n|------------------------- ---|\n| `/api/*` |\n| `/download/*` |\n| `/lazy-static/*` |\n| `/.well-known/webfinger` |\n\nIn addition, all routes serving ActivityPub are CORS-enabled for all origins.\n" }, "externalDocs": { "url": "https://docs.joinpeertube.org/api-rest-reference.html" }, "tags": [ { "name": "Register", "description": "As a visitor, you can use this API to open an account (if registrations are open on\nthat PeerTube instance). As an admin, you should use the dedicated [User creation\nAPI](#operation/addUser) instead.\n" }, { "name": "Session", "x-displayName": "Login/Logout", "description": "Sessions deal with access tokens over time. Only __one session token can currently be used at a time__.\n" }, { "name": "Accounts", "description": "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.\nWhen a comment is posted, it is done with your Account's Actor.\n" }, { "name": "Users", "description": "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.\n" }, { "name": "User Exports", "description": "To create an archive of user data.\n" }, { "name": "User Imports", "description": "To import an archive of user data.\n" }, { "name": "My User", "description": "Operations related to your own User, when logged-in.\n" }, { "name": "My Subscriptions", "description": "Operations related to your subscriptions to video channels, their new videos, and how to keep up to date with their latest publications!\n" }, { "name": "My History", "description": "Operations related to your watch history.\n" }, { "name": "My Notifications", "description": "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.\n" }, { "name": "Config", "description": "Each server exposes public information regarding supported videos and options.\n" }, { "name": "Job", "description": "Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.\n" }, { "name": "Instance Follows", "description": "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.\n", "externalDocs": { "url": "https://docs.joinpeertube.org/admin/following-instances#instances-follows" } }, { "name": "Instance Redundancy", "description": "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](#tag/Video-Mirroring).\n", "externalDocs": { "url": "https://docs.joinpeertube.org/admin/following-instances#instances-redundancy" } }, { "name": "Plugins", "description": "Managing plugins installed from a local path or from NPM, or search for new ones.\n", "externalDocs": { "url": "https://docs.joinpeertube.org/api/plugins" } }, { "name": "Abuses", "description": "Abuses deal with reports of local or remote videos/comments/accounts alike.\n" }, { "name": "Video", "description": "Operations dealing with listing, uploading, fetching or modifying videos.\n" }, { "name": "Video Upload", "description": "Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes.\n\n### Upload\n\n- [_legacy_](#operation/uploadLegacy), where the video file is sent in a single request\n- [_resumable_](#operation/uploadResumableInit), where the video file is sent in chunks\n\nYou can upload videos more reliably by using the resumable variant. Its protocol lets\nyou resume an upload operation after a network interruption or other transmission failure,\nsaving time and bandwidth in the event of network failures.\n\nFavor using resumable uploads in any of the following cases:\n- You are transferring large files\n- The likelihood of a network interruption is high\n- Uploads are originating from a device with a low-bandwidth or unstable Internet connection, such as a mobile device\n\n### Import\n\n- _URL_-based: where the URL points to any service supported by [youtube-dl](https://ytdl-org.github.io/youtube-dl/)\n- _magnet_-based: where the URI resolves to a BitTorrent resource containing a single supported video file\n- _torrent_-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file\n\nThe import function is practical when the desired video/audio is available online. It makes PeerTube\ndownload it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.\n" }, { "name": "Video Imports", "description": "Operations dealing with listing, adding and removing video imports." }, { "name": "Channels Sync", "description": "Operations dealing with synchronizing PeerTube user's channel with channels of other platforms" }, { "name": "Video Captions", "description": "Operations dealing with listing, adding and removing closed captions of a video." }, { "name": "Video Chapters", "description": "Operations dealing with managing chapters of a video." }, { "name": "Video Channels", "description": "Operations dealing with the creation, modification and listing of videos within a channel." }, { "name": "Player Settings", "description": "Operations dealing with video player settings for videos and channels." }, { "name": "Video Comments", "description": "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.\n" }, { "name": "Video Blocks", "description": "Operations dealing with blocking videos (removing them from view and preventing interactions)." }, { "name": "Automatic Tags", "description": "Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)" }, { "name": "Watched Words", "description": "Manage list of watched words to detect patterns on objects (like comments of videos)" }, { "name": "Video Rates", "description": "Like/dislike a video." }, { "name": "Video Playlists", "description": "Operations dealing with playlists of videos. Playlists are bound to users and/or channels." }, { "name": "Video Files", "description": "Operations on video files" }, { "name": "Video Transcoding", "description": "Video transcoding related operations" }, { "name": "Video Stats", "description": "Video statistics" }, { "name": "Video Feeds", "description": "Server syndication feeds of videos" }, { "name": "Video Download", "description": "Download video files" }, { "name": "Logs", "description": "Operations dealing with client, server and audit logs." }, { "name": "Search", "description": "The search helps to find _videos_ or _channels_ from within the instance and beyond.\nVideos from other instances federated by the instance (that is, instances\nfollowed by the instance) can be found via keywords and other criteria of\nthe advanced search.\n\nAdministrators can also enable the use of a remote search system, indexing\nvideos and channels that may not be federated by the instance.\n" }, { "name": "Homepage", "description": "Get and update the custom homepage" }, { "name": "Video Mirroring", "description": "PeerTube instances can mirror videos from one another, and help distribute some videos.\n\nFor importing videos as your own, refer to [video imports](#operation/importVideo).\n" }, { "name": "Stats", "description": "Statistics\n" }, { "name": "Contact", "description": "Send a message to the instance administrators." }, { "name": "Debug", "description": "Administrative debug endpoints." }, { "name": "Runner Registration Token", "description": "Manage runner registration tokens.\n" }, { "name": "Runner Jobs", "description": "Manage runner jobs and runner-side job execution." }, { "name": "Runners", "description": "Register, list and remove remote runners." }, { "name": "Video Passwords", "description": "Operations on video passwords." }, { "name": "Client Config", "description": "Configuration of the web client." } ], "x-tagGroups": [ { "name": "Static endpoints", "tags": [ "Static Video Files" ] }, { "name": "Download", "tags": [ "Video Download" ] }, { "name": "Feeds", "tags": [ "Video Feeds" ] }, { "name": "Auth", "tags": [ "Register", "Session" ] }, { "name": "Accounts", "tags": [ "Accounts", "Users", "User Exports", "User Imports", "My User", "My Subscriptions", "My Notifications", "My History" ] }, { "name": "Videos", "tags": [ "Video", "Video Upload", "Video Imports", "Video Captions", "Video Chapters", "Video Channels", "Video Comments", "Video Rates", "Video Playlists", "Video Stats", "Ownership Change", "Video Mirroring", "Video Files", "Video Transcoding", "Live Videos", "Channels Sync", "Video Passwords", "Video Embed Privacy" ] }, { "name": "Search", "tags": [ "Search" ] }, { "name": "Moderation", "tags": [ "Abuses", "Video Blocks", "Account Blocklist", "Server Blocklist", "Automatic Tags", "Watched Words" ] }, { "name": "Instance", "tags": [ "Config", "Client Config", "Homepage", "Instance Follows", "Instance Redundancy", "Plugins", "Stats", "Logs", "Job" ] }, { "name": "Remote Jobs", "tags": [ "Runner Registration Token", "Runner Jobs", "Runners" ] } ], "paths": { "/static/web-videos/{filename}": { "get": { "tags": [ "Static Video Files" ], "summary": "Get public Web Video file", "description": "**PeerTube >= 6.0**", "parameters": [ { "$ref": "#/components/parameters/staticFilename" } ], "responses": { "200": { "description": "successful operation" }, "404": { "description": "not found" } } } }, "/static/web-videos/private/{filename}": { "get": { "tags": [ "Static Video Files" ], "summary": "Get private Web Video file", "description": "**PeerTube >= 6.0**", "parameters": [ { "$ref": "#/components/parameters/staticFilename" }, { "$ref": "#/components/parameters/videoFileToken" } ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation" }, "403": { "description": "invalid auth" }, "404": { "description": "not found" } } } }, "/static/streaming-playlists/hls/{filename}": { "get": { "tags": [ "Static Video Files" ], "summary": "Get public HLS video file", "parameters": [ { "$ref": "#/components/parameters/staticFilename" } ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation" }, "403": { "description": "invalid auth" }, "404": { "description": "not found" } } } }, "/static/streaming-playlists/hls/private/{filename}": { "get": { "tags": [ "Static Video Files" ], "summary": "Get private HLS video file", "parameters": [ { "$ref": "#/components/parameters/staticFilename" }, { "$ref": "#/components/parameters/videoFileToken" }, { "$ref": "#/components/parameters/reinjectVideoFileToken" } ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation" }, "403": { "description": "invalid auth" }, "404": { "description": "not found" } } } }, "/download/videos/generate/{videoIdOrUUID}": { "get": { "tags": [ "Video Download" ], "summary": "Download video file", "description": "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.", "parameters": [ { "$ref": "#/components/parameters/videoIdOrUUID" }, { "name": "videoFileIds", "in": "query", "required": true, "description": "streams of video files to mux in the output", "schema": { "type": "array", "items": { "type": "integer" } } }, { "$ref": "#/components/parameters/videoFileToken" } ], "responses": { "200": { "description": "successful operation" } } } }, "/feeds/video-comments.{format}": { "get": { "tags": [ "Video Feeds" ], "summary": "Comments on videos feeds", "operationId": "getSyndicatedComments", "parameters": [ { "name": "format", "in": "path", "required": true, "description": "format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))", "schema": { "type": "string", "enum": [ "xml", "rss", "rss2", "atom", "atom1", "json", "json1" ] } }, { "name": "videoId", "in": "query", "description": "limit listing comments to a specific video", "schema": { "type": "string" } }, { "name": "accountId", "in": "query", "description": "limit listing comments to videos of a specific account", "schema": { "type": "string" } }, { "name": "accountName", "in": "query", "description": "limit listing comments to videos of a specific account", "schema": { "type": "string" } }, { "name": "videoChannelId", "in": "query", "description": "limit listing comments to videos of a specific video channel", "schema": { "type": "string" } }, { "name": "videoChannelName", "in": "query", "description": "limit listing comments to videos of a specific video channel", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "headers": { "Cache-Control": { "schema": { "type": "string", "default": "max-age=900" } } }, "content": { "application/xml": { "schema": { "$ref": "#/components/schemas/VideoCommentsForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 13:41:19 GMT\n @thelinuxexperiment\n@thelinuxEXP

Got #OCR in #Spectacle working on #NixOS

https://codeberg.org/boredsquirrel/Nixos-Config/src/branch/main/Level%202%20-%20Medium/configuration/modules/kde-plasma.nix

Using the nice overwrite from this comment

https://github.com/NixOS/nixpkgs/issues/491913#issuecomment-4477337623

It seems to all work, at least Spectacle detects all languages now.

#KDE #KDEPlasma

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 12:36:00 GMT\n @thelinuxexperiment

20:54

So funny, I also have no idea how to get #OCR working in #Spectacle!

@kde this should have been there since a long time and there are always changes, but how do I use it?

#Tesseract is installed (NixOS)

#KDE #KDEPlasma #Plasma67

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - Edoardo Regni]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n Tue, 16 Jun 2026 20:56:07 GMT\n Another in-depth review. Thank you!

\n]]>\n Edoardo Regni\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - sigmaprout152]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 15:35:00 GMT\n hahaha

\n]]>\n sigmaprout152\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - rb411]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 14:13:41 GMT\n 2:05 I just switched to Cosmic instead of Plasma on my dual monitor desktop setup because you couldn't do this 😭

\n]]>\n rb411\n \n \n <![CDATA[Koa and the Five Pirates of Mara : Chapitre 1 - Sokatra]]>\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n Tue, 16 Jun 2026 13:19:26 GMT\n @theadvancegirl C'est tout mignon comme jeu ;)

]]>\n Sokatra\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 08:58:48 GMT\n @arnaud_tabarly@mastodon.social Merci Arnaud ! 😃

\n]]>\n MonViolon TV\n \n \n <![CDATA[TorTour de Ruhr - Operation Münsterland]]>\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n Tue, 16 Jun 2026 08:22:59 GMT\n Respekt.

\n]]>\n Operation Münsterland\n \n \n <![CDATA[News de juin 2026 - Arnaud Tabarly]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 07:39:40 GMT\n @monviolon Ça fait plaisir d'avoir des nouvelles et puis très chouette cette petite vidéo !!

]]>\n Arnaud Tabarly\n \n \n <![CDATA[Metroid Fusion - Chapitre 1 - Lucilia]]>\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n Tue, 16 Jun 2026 07:33:22 GMT\n Notification désactivée sur YouTube mais malheureusement pas ici
\nAprès, c'est là tout l’intérêt d'avoirs plusieurs chaînes différentes sur Peertube

\n]]>\n Lucilia\n \n \n <![CDATA[Affaire Lyhanna : la faillite ultime de la macronie - Lien Rag]]>\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n Mon, 15 Jun 2026 23:22:38 GMT\n @blast

euh la phrase finale elle est pas carrément problématique ?\n\"On a tous classé sans suite des procédures où on savait qu'un enfant nous décrivait quelque chose qui avait eu lieu (...) mais on nous impulsait pas l'idée qu'il fallait aller au-delà de ces simples auditions\".

Y'a besoin qu'on vous dise qu'il faut sanctionner pénalement les viols d'enfants ?\nVous êtes pas juges, à la base ? C'est pas un peu votre métier ?

]]>\n Lien Rag\n \n \n <![CDATA[BQN: From Zero to Game of Life in 20 Minutes - yeti]]>\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n Mon, 15 Jun 2026 15:19:13 GMT\n @johnny jonathan

]]>\n yeti\n \n \n <![CDATA[Le défi d'éduquer à un numérique acceptable - 3 juin - Partie 1/2 - DansLeRuSН]]>\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n Mon, 15 Jun 2026 14:44:05 GMT\n @louis_derrac Triste d'avoir raté le temps d'échange (j'ai eu un impondérable de dernière minute) mais très intéressantes (et oui denses) présentations … on a de quoi jouer aux cartes 😉

]]>\n DansLeRuSН\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Mon, 15 Jun 2026 12:04:25 GMT\n @boulyprod@video.liberta.vip Merci ! Après mon appel désespéré, j'aurai peut-être de la main d'œuvre (on peut toujours rêver après tout) 😉

\n]]>\n MonViolon TV\n \n \n <![CDATA[Cachy OS benchmarked (on Tuxedo InfinityBook Max 16): Hype or Real performance? - Marcus Fihlon]]>\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n Mon, 15 Jun 2026 10:55:32 GMT\n @dariusmiles2123@tilvids.com @Rhababerbarbar@tux.social
\nAfter two weeks the max available resolution is still 360p which makes the video blurry. Usually the video quality of Nicks videos is much better, so here must happened something unusual to this video.

\n]]>\n Marcus Fihlon\n \n \n <![CDATA[Tux-Flash-2026-06-11-pixeledi Tech Hub, Streamen unter Arch, Nix und NixOS, Krisenvorsorge - m23hauke]]>\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n Mon, 15 Jun 2026 04:37:22 GMT\n @anonymos678@tube.xy-space.de 😃

\n]]>\n m23hauke\n \n \n <![CDATA[Gaza : enquête sur la complicité et l'aveuglement des médias français - InternetDev-Anti-Communicant🍉]]>\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n Mon, 15 Jun 2026 03:34:28 GMT\n @blast

Il y a peut-être (je dis \"Peut-être\") un aveuglement de certain chiens de garde, mais aucun aveuglement de la direction de ces médias eux-mêmes.

Il y en a eut même des médias alternatifs, mais eux ne peuvent pas être accusés de l'avoir fait sciemment, alors que les médias de masse, si.

Les propagandes pro-génocide ont commencé avant même le 07 Octobre 2023. Il y a eu des préparations de long terme à ce génocide.

]]>\n InternetDev-Anti-Communicant🍉\n \n \n <![CDATA[Das bessere Social Media ist unbekannt - rebel]]>\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n Sun, 14 Jun 2026 18:59:07 GMT\n @cthulhu_breakfast@makertube.net probiere mal die passenden Suchmaschinen dafür, um Inhalte in Peertube zu finden https://sepiasearch.org/ und https://peertube.chefblogger.me/index.php

\n]]>\n rebel\n \n \n <![CDATA[News de juin 2026 - BoulyProd]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Sun, 14 Jun 2026 15:40:10 GMT\n Bon courage pour les travaux 😉

\n]]>\n BoulyProd\n \n \n <![CDATA[pan - Verbund offener Werkstätten]]>\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n Sun, 14 Jun 2026 14:41:19 GMT\n #pan

\n]]>\n Verbund offener Werkstätten\n \n \n" } } }, "application/rss+xml": { "schema": { "$ref": "#/components/schemas/VideoCommentsForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 13:41:19 GMT\n @thelinuxexperiment\n@thelinuxEXP

Got #OCR in #Spectacle working on #NixOS

https://codeberg.org/boredsquirrel/Nixos-Config/src/branch/main/Level%202%20-%20Medium/configuration/modules/kde-plasma.nix

Using the nice overwrite from this comment

https://github.com/NixOS/nixpkgs/issues/491913#issuecomment-4477337623

It seems to all work, at least Spectacle detects all languages now.

#KDE #KDEPlasma

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 12:36:00 GMT\n @thelinuxexperiment

20:54

So funny, I also have no idea how to get #OCR working in #Spectacle!

@kde this should have been there since a long time and there are always changes, but how do I use it?

#Tesseract is installed (NixOS)

#KDE #KDEPlasma #Plasma67

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - Edoardo Regni]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n Tue, 16 Jun 2026 20:56:07 GMT\n Another in-depth review. Thank you!

\n]]>\n Edoardo Regni\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - sigmaprout152]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 15:35:00 GMT\n hahaha

\n]]>\n sigmaprout152\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - rb411]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 14:13:41 GMT\n 2:05 I just switched to Cosmic instead of Plasma on my dual monitor desktop setup because you couldn't do this 😭

\n]]>\n rb411\n \n \n <![CDATA[Koa and the Five Pirates of Mara : Chapitre 1 - Sokatra]]>\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n Tue, 16 Jun 2026 13:19:26 GMT\n @theadvancegirl C'est tout mignon comme jeu ;)

]]>\n Sokatra\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 08:58:48 GMT\n @arnaud_tabarly@mastodon.social Merci Arnaud ! 😃

\n]]>\n MonViolon TV\n \n \n <![CDATA[TorTour de Ruhr - Operation Münsterland]]>\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n Tue, 16 Jun 2026 08:22:59 GMT\n Respekt.

\n]]>\n Operation Münsterland\n \n \n <![CDATA[News de juin 2026 - Arnaud Tabarly]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 07:39:40 GMT\n @monviolon Ça fait plaisir d'avoir des nouvelles et puis très chouette cette petite vidéo !!

]]>\n Arnaud Tabarly\n \n \n <![CDATA[Metroid Fusion - Chapitre 1 - Lucilia]]>\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n Tue, 16 Jun 2026 07:33:22 GMT\n Notification désactivée sur YouTube mais malheureusement pas ici
\nAprès, c'est là tout l’intérêt d'avoirs plusieurs chaînes différentes sur Peertube

\n]]>\n Lucilia\n \n \n <![CDATA[Affaire Lyhanna : la faillite ultime de la macronie - Lien Rag]]>\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n Mon, 15 Jun 2026 23:22:38 GMT\n @blast

euh la phrase finale elle est pas carrément problématique ?\n\"On a tous classé sans suite des procédures où on savait qu'un enfant nous décrivait quelque chose qui avait eu lieu (...) mais on nous impulsait pas l'idée qu'il fallait aller au-delà de ces simples auditions\".

Y'a besoin qu'on vous dise qu'il faut sanctionner pénalement les viols d'enfants ?\nVous êtes pas juges, à la base ? C'est pas un peu votre métier ?

]]>\n Lien Rag\n \n \n <![CDATA[BQN: From Zero to Game of Life in 20 Minutes - yeti]]>\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n Mon, 15 Jun 2026 15:19:13 GMT\n @johnny jonathan

]]>\n yeti\n \n \n <![CDATA[Le défi d'éduquer à un numérique acceptable - 3 juin - Partie 1/2 - DansLeRuSН]]>\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n Mon, 15 Jun 2026 14:44:05 GMT\n @louis_derrac Triste d'avoir raté le temps d'échange (j'ai eu un impondérable de dernière minute) mais très intéressantes (et oui denses) présentations … on a de quoi jouer aux cartes 😉

]]>\n DansLeRuSН\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Mon, 15 Jun 2026 12:04:25 GMT\n @boulyprod@video.liberta.vip Merci ! Après mon appel désespéré, j'aurai peut-être de la main d'œuvre (on peut toujours rêver après tout) 😉

\n]]>\n MonViolon TV\n \n \n <![CDATA[Cachy OS benchmarked (on Tuxedo InfinityBook Max 16): Hype or Real performance? - Marcus Fihlon]]>\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n Mon, 15 Jun 2026 10:55:32 GMT\n @dariusmiles2123@tilvids.com @Rhababerbarbar@tux.social
\nAfter two weeks the max available resolution is still 360p which makes the video blurry. Usually the video quality of Nicks videos is much better, so here must happened something unusual to this video.

\n]]>\n Marcus Fihlon\n \n \n <![CDATA[Tux-Flash-2026-06-11-pixeledi Tech Hub, Streamen unter Arch, Nix und NixOS, Krisenvorsorge - m23hauke]]>\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n Mon, 15 Jun 2026 04:37:22 GMT\n @anonymos678@tube.xy-space.de 😃

\n]]>\n m23hauke\n \n \n <![CDATA[Gaza : enquête sur la complicité et l'aveuglement des médias français - InternetDev-Anti-Communicant🍉]]>\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n Mon, 15 Jun 2026 03:34:28 GMT\n @blast

Il y a peut-être (je dis \"Peut-être\") un aveuglement de certain chiens de garde, mais aucun aveuglement de la direction de ces médias eux-mêmes.

Il y en a eut même des médias alternatifs, mais eux ne peuvent pas être accusés de l'avoir fait sciemment, alors que les médias de masse, si.

Les propagandes pro-génocide ont commencé avant même le 07 Octobre 2023. Il y a eu des préparations de long terme à ce génocide.

]]>\n InternetDev-Anti-Communicant🍉\n \n \n <![CDATA[Das bessere Social Media ist unbekannt - rebel]]>\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n Sun, 14 Jun 2026 18:59:07 GMT\n @cthulhu_breakfast@makertube.net probiere mal die passenden Suchmaschinen dafür, um Inhalte in Peertube zu finden https://sepiasearch.org/ und https://peertube.chefblogger.me/index.php

\n]]>\n rebel\n \n \n <![CDATA[News de juin 2026 - BoulyProd]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Sun, 14 Jun 2026 15:40:10 GMT\n Bon courage pour les travaux 😉

\n]]>\n BoulyProd\n \n \n <![CDATA[pan - Verbund offener Werkstätten]]>\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n Sun, 14 Jun 2026 14:41:19 GMT\n #pan

\n]]>\n Verbund offener Werkstätten\n \n \n" } } }, "text/xml": { "schema": { "$ref": "#/components/schemas/VideoCommentsForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 13:41:19 GMT\n @thelinuxexperiment\n@thelinuxEXP

Got #OCR in #Spectacle working on #NixOS

https://codeberg.org/boredsquirrel/Nixos-Config/src/branch/main/Level%202%20-%20Medium/configuration/modules/kde-plasma.nix

Using the nice overwrite from this comment

https://github.com/NixOS/nixpkgs/issues/491913#issuecomment-4477337623

It seems to all work, at least Spectacle detects all languages now.

#KDE #KDEPlasma

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n Wed, 17 Jun 2026 12:36:00 GMT\n @thelinuxexperiment

20:54

So funny, I also have no idea how to get #OCR working in #Spectacle!

@kde this should have been there since a long time and there are always changes, but how do I use it?

#Tesseract is installed (NixOS)

#KDE #KDEPlasma #Plasma67

]]>\n boredsquirrel\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - Edoardo Regni]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n Tue, 16 Jun 2026 20:56:07 GMT\n Another in-depth review. Thank you!

\n]]>\n Edoardo Regni\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - sigmaprout152]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 15:35:00 GMT\n hahaha

\n]]>\n sigmaprout152\n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - rb411]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n Tue, 16 Jun 2026 14:13:41 GMT\n 2:05 I just switched to Cosmic instead of Plasma on my dual monitor desktop setup because you couldn't do this 😭

\n]]>\n rb411\n \n \n <![CDATA[Koa and the Five Pirates of Mara : Chapitre 1 - Sokatra]]>\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n Tue, 16 Jun 2026 13:19:26 GMT\n @theadvancegirl C'est tout mignon comme jeu ;)

]]>\n Sokatra\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 08:58:48 GMT\n @arnaud_tabarly@mastodon.social Merci Arnaud ! 😃

\n]]>\n MonViolon TV\n \n \n <![CDATA[TorTour de Ruhr - Operation Münsterland]]>\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n Tue, 16 Jun 2026 08:22:59 GMT\n Respekt.

\n]]>\n Operation Münsterland\n \n \n <![CDATA[News de juin 2026 - Arnaud Tabarly]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n Tue, 16 Jun 2026 07:39:40 GMT\n @monviolon Ça fait plaisir d'avoir des nouvelles et puis très chouette cette petite vidéo !!

]]>\n Arnaud Tabarly\n \n \n <![CDATA[Metroid Fusion - Chapitre 1 - Lucilia]]>\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n Tue, 16 Jun 2026 07:33:22 GMT\n Notification désactivée sur YouTube mais malheureusement pas ici
\nAprès, c'est là tout l’intérêt d'avoirs plusieurs chaînes différentes sur Peertube

\n]]>\n Lucilia\n \n \n <![CDATA[Affaire Lyhanna : la faillite ultime de la macronie - Lien Rag]]>\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n Mon, 15 Jun 2026 23:22:38 GMT\n @blast

euh la phrase finale elle est pas carrément problématique ?\n\"On a tous classé sans suite des procédures où on savait qu'un enfant nous décrivait quelque chose qui avait eu lieu (...) mais on nous impulsait pas l'idée qu'il fallait aller au-delà de ces simples auditions\".

Y'a besoin qu'on vous dise qu'il faut sanctionner pénalement les viols d'enfants ?\nVous êtes pas juges, à la base ? C'est pas un peu votre métier ?

]]>\n Lien Rag\n \n \n <![CDATA[BQN: From Zero to Game of Life in 20 Minutes - yeti]]>\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n Mon, 15 Jun 2026 15:19:13 GMT\n @johnny jonathan

]]>\n yeti\n \n \n <![CDATA[Le défi d'éduquer à un numérique acceptable - 3 juin - Partie 1/2 - DansLeRuSН]]>\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n Mon, 15 Jun 2026 14:44:05 GMT\n @louis_derrac Triste d'avoir raté le temps d'échange (j'ai eu un impondérable de dernière minute) mais très intéressantes (et oui denses) présentations … on a de quoi jouer aux cartes 😉

]]>\n DansLeRuSН\n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Mon, 15 Jun 2026 12:04:25 GMT\n @boulyprod@video.liberta.vip Merci ! Après mon appel désespéré, j'aurai peut-être de la main d'œuvre (on peut toujours rêver après tout) 😉

\n]]>\n MonViolon TV\n \n \n <![CDATA[Cachy OS benchmarked (on Tuxedo InfinityBook Max 16): Hype or Real performance? - Marcus Fihlon]]>\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n Mon, 15 Jun 2026 10:55:32 GMT\n @dariusmiles2123@tilvids.com @Rhababerbarbar@tux.social
\nAfter two weeks the max available resolution is still 360p which makes the video blurry. Usually the video quality of Nicks videos is much better, so here must happened something unusual to this video.

\n]]>\n Marcus Fihlon\n \n \n <![CDATA[Tux-Flash-2026-06-11-pixeledi Tech Hub, Streamen unter Arch, Nix und NixOS, Krisenvorsorge - m23hauke]]>\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n Mon, 15 Jun 2026 04:37:22 GMT\n @anonymos678@tube.xy-space.de 😃

\n]]>\n m23hauke\n \n \n <![CDATA[Gaza : enquête sur la complicité et l'aveuglement des médias français - InternetDev-Anti-Communicant🍉]]>\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n Mon, 15 Jun 2026 03:34:28 GMT\n @blast

Il y a peut-être (je dis \"Peut-être\") un aveuglement de certain chiens de garde, mais aucun aveuglement de la direction de ces médias eux-mêmes.

Il y en a eut même des médias alternatifs, mais eux ne peuvent pas être accusés de l'avoir fait sciemment, alors que les médias de masse, si.

Les propagandes pro-génocide ont commencé avant même le 07 Octobre 2023. Il y a eu des préparations de long terme à ce génocide.

]]>\n InternetDev-Anti-Communicant🍉\n \n \n <![CDATA[Das bessere Social Media ist unbekannt - rebel]]>\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n Sun, 14 Jun 2026 18:59:07 GMT\n @cthulhu_breakfast@makertube.net probiere mal die passenden Suchmaschinen dafür, um Inhalte in Peertube zu finden https://sepiasearch.org/ und https://peertube.chefblogger.me/index.php

\n]]>\n rebel\n \n \n <![CDATA[News de juin 2026 - BoulyProd]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n Sun, 14 Jun 2026 15:40:10 GMT\n Bon courage pour les travaux 😉

\n]]>\n BoulyProd\n \n \n <![CDATA[pan - Verbund offener Werkstätten]]>\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n Sun, 14 Jun 2026 14:41:19 GMT\n #pan

\n]]>\n Verbund offener Werkstätten\n \n \n" } } }, "application/atom+xml": { "schema": { "$ref": "#/components/schemas/VideoCommentsForXML" }, "examples": { "nightly": { "value": "\n\n https://peertube2.cpy.re\n PeerTube Nightly\n 2026-06-18T03:03:47.390Z\n PeerTube - https://peertube2.cpy.re\n \n \n 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.\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png\n 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.\n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n \n 2026-06-17T13:41:19.000Z\n @thelinuxexperiment\n@thelinuxEXP

Got #OCR in #Spectacle working on #NixOS

https://codeberg.org/boredsquirrel/Nixos-Config/src/branch/main/Level%202%20-%20Medium/configuration/modules/kde-plasma.nix

Using the nice overwrite from this comment

https://github.com/NixOS/nixpkgs/issues/491913#issuecomment-4477337623

It seems to all work, at least Spectacle detects all languages now.

#KDE #KDEPlasma

]]>\n \n boredsquirrel\n https://tux.social/users/Rhababerbarbar\n \n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401\n \n 2026-06-17T12:36:00.000Z\n @thelinuxexperiment

20:54

So funny, I also have no idea how to get #OCR working in #Spectacle!

@kde this should have been there since a long time and there are always changes, but how do I use it?

#Tesseract is installed (NixOS)

#KDE #KDEPlasma #Plasma67

]]>\n \n boredsquirrel\n https://tux.social/users/Rhababerbarbar\n \n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - Edoardo Regni]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399\n \n 2026-06-16T20:56:07.809Z\n Another in-depth review. Thank you!

\n]]>\n \n Edoardo Regni\n https://tilvids.com/accounts/eregni\n \n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - sigmaprout152]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n \n 2026-06-16T15:35:00.784Z\n hahaha

\n]]>\n \n sigmaprout152\n https://peerate.fr/accounts/sigmaprout152\n \n \n \n <![CDATA[KDE Plasma 6.7 review: still the best Linux Desktop IMO - rb411]]>\n https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395\n \n 2026-06-16T14:13:41.645Z\n 2:05 I just switched to Cosmic instead of Plasma on my dual monitor desktop setup because you couldn't do this 😭

\n]]>\n \n rb411\n https://tilvids.com/accounts/rb411\n \n \n \n <![CDATA[Koa and the Five Pirates of Mara : Chapitre 1 - Sokatra]]>\n https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394\n \n 2026-06-16T13:19:26.000Z\n @theadvancegirl C'est tout mignon comme jeu ;)

]]>\n \n Sokatra\n https://mastodon.mg/users/Sokatra\n \n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n \n 2026-06-16T08:58:48.616Z\n @arnaud_tabarly@mastodon.social Merci Arnaud ! 😃

\n]]>\n \n MonViolon TV\n https://exode.me/accounts/monviolon\n \n \n \n <![CDATA[TorTour de Ruhr - Operation Münsterland]]>\n https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386\n \n 2026-06-16T08:22:59.366Z\n Respekt.

\n]]>\n \n Operation Münsterland\n https://tube.tchncs.de/accounts/malte_peertube\n \n \n \n <![CDATA[News de juin 2026 - Arnaud Tabarly]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385\n \n 2026-06-16T07:39:40.000Z\n @monviolon Ça fait plaisir d'avoir des nouvelles et puis très chouette cette petite vidéo !!

]]>\n \n Arnaud Tabarly\n https://mastodon.social/users/arnaud_tabarly\n \n \n \n <![CDATA[Metroid Fusion - Chapitre 1 - Lucilia]]>\n https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384\n \n 2026-06-16T07:33:22.927Z\n Notification désactivée sur YouTube mais malheureusement pas ici
\nAprès, c'est là tout l’intérêt d'avoirs plusieurs chaînes différentes sur Peertube

\n]]>\n \n Lucilia\n https://videos.pair2jeux.tube/accounts/theadvancegirl\n \n \n \n <![CDATA[Affaire Lyhanna : la faillite ultime de la macronie - Lien Rag]]>\n https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383\n \n 2026-06-15T23:22:38.000Z\n @blast

euh la phrase finale elle est pas carrément problématique ?\n\"On a tous classé sans suite des procédures où on savait qu'un enfant nous décrivait quelque chose qui avait eu lieu (...) mais on nous impulsait pas l'idée qu'il fallait aller au-delà de ces simples auditions\".

Y'a besoin qu'on vous dise qu'il faut sanctionner pénalement les viols d'enfants ?\nVous êtes pas juges, à la base ? C'est pas un peu votre métier ?

]]>\n \n Lien Rag\n https://mastodon.tedomum.net/users/lienrag\n \n \n \n <![CDATA[BQN: From Zero to Game of Life in 20 Minutes - yeti]]>\n https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334\n \n 2026-06-15T15:19:13.000Z\n @johnny jonathan

]]>\n \n yeti\n https://social.nouveau.community/users/yeti\n \n \n \n <![CDATA[Le défi d'éduquer à un numérique acceptable - 3 juin - Partie 1/2 - DansLeRuSН]]>\n https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333\n \n 2026-06-15T14:44:05.000Z\n @louis_derrac Triste d'avoir raté le temps d'échange (j'ai eu un impondérable de dernière minute) mais très intéressantes (et oui denses) présentations … on a de quoi jouer aux cartes 😉

]]>\n \n DansLeRuSН\n https://framapiaf.org/users/danslerush\n \n \n \n <![CDATA[News de juin 2026 - MonViolon TV]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n \n 2026-06-15T12:04:25.096Z\n @boulyprod@video.liberta.vip Merci ! Après mon appel désespéré, j'aurai peut-être de la main d'œuvre (on peut toujours rêver après tout) 😉

\n]]>\n \n MonViolon TV\n https://exode.me/accounts/monviolon\n \n \n \n <![CDATA[Cachy OS benchmarked (on Tuxedo InfinityBook Max 16): Hype or Real performance? - Marcus Fihlon]]>\n https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973\n \n 2026-06-15T10:55:32.079Z\n @dariusmiles2123@tilvids.com @Rhababerbarbar@tux.social
\nAfter two weeks the max available resolution is still 360p which makes the video blurry. Usually the video quality of Nicks videos is much better, so here must happened something unusual to this video.

\n]]>\n \n Marcus Fihlon\n https://tube.tchncs.de/accounts/mcpringle\n \n \n \n <![CDATA[Tux-Flash-2026-06-11-pixeledi Tech Hub, Streamen unter Arch, Nix und NixOS, Krisenvorsorge - m23hauke]]>\n https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307\n \n 2026-06-15T04:37:22.543Z\n @anonymos678@tube.xy-space.de 😃

\n]]>\n \n m23hauke\n https://tube.tchncs.de/accounts/m23hauke\n \n \n \n <![CDATA[Gaza : enquête sur la complicité et l'aveuglement des médias français - InternetDev-Anti-Communicant🍉]]>\n https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325\n \n 2026-06-15T03:34:28.000Z\n @blast

Il y a peut-être (je dis \"Peut-être\") un aveuglement de certain chiens de garde, mais aucun aveuglement de la direction de ces médias eux-mêmes.

Il y en a eut même des médias alternatifs, mais eux ne peuvent pas être accusés de l'avoir fait sciemment, alors que les médias de masse, si.

Les propagandes pro-génocide ont commencé avant même le 07 Octobre 2023. Il y a eu des préparations de long terme à ce génocide.

]]>\n \n InternetDev-Anti-Communicant🍉\n https://mastodon.social/users/InternetDev\n \n \n \n <![CDATA[Das bessere Social Media ist unbekannt - rebel]]>\n https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375\n \n 2026-06-14T18:59:07.847Z\n @cthulhu_breakfast@makertube.net probiere mal die passenden Suchmaschinen dafür, um Inhalte in Peertube zu finden https://sepiasearch.org/ und https://peertube.chefblogger.me/index.php

\n]]>\n \n rebel\n https://tube.tchncs.de/accounts/rebel\n \n \n \n <![CDATA[News de juin 2026 - BoulyProd]]>\n https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319\n \n 2026-06-14T15:40:10.793Z\n Bon courage pour les travaux 😉

\n]]>\n \n BoulyProd\n https://video.liberta.vip/accounts/boulyprod\n \n \n \n <![CDATA[pan - Verbund offener Werkstätten]]>\n https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318\n \n 2026-06-14T14:41:19.109Z\n #pan

\n]]>\n \n Verbund offener Werkstätten\n https://tube.tchncs.de/accounts/vow\n \n \n" } } }, "application/json": { "schema": { "type": "object" }, "examples": { "nightly": { "value": { "version": "https://jsonfeed.org/version/1", "title": "PeerTube Nightly", "home_page_url": "https://peertube2.cpy.re", "feed_url": "https://peertube2.cpy.re/feeds/video-comments.json?scope=local", "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.", "icon": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "items": [ { "id": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401", "content_html": "

@thelinuxexperiment\n@thelinuxEXP

Got #OCR in #Spectacle working on #NixOS

https://codeberg.org/boredsquirrel/Nixos-Config/src/branch/main/Level%202%20-%20Medium/configuration/modules/kde-plasma.nix

Using the nice overwrite from this comment

https://github.com/NixOS/nixpkgs/issues/491913#issuecomment-4477337623

It seems to all work, at least Spectacle detects all languages now.

#KDE #KDEPlasma

", "url": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401", "title": "KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel", "date_modified": "2026-06-17T13:41:19.000Z", "author": { "name": "boredsquirrel", "url": "https://tux.social/users/Rhababerbarbar" } }, { "id": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401", "content_html": "

@thelinuxexperiment

20:54

So funny, I also have no idea how to get #OCR working in #Spectacle!

@kde this should have been there since a long time and there are always changes, but how do I use it?

#Tesseract is installed (NixOS)

#KDE #KDEPlasma #Plasma67

", "url": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192401", "title": "KDE Plasma 6.7 review: still the best Linux Desktop IMO - boredsquirrel", "date_modified": "2026-06-17T12:36:00.000Z", "author": { "name": "boredsquirrel", "url": "https://tux.social/users/Rhababerbarbar" } }, { "id": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399", "content_html": "

Another in-depth review. Thank you!

\n", "url": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192399", "title": "KDE Plasma 6.7 review: still the best Linux Desktop IMO - Edoardo Regni", "date_modified": "2026-06-16T20:56:07.809Z", "author": { "name": "Edoardo Regni", "url": "https://tilvids.com/accounts/eregni" } }, { "id": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395", "content_html": "

hahaha

\n", "url": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395", "title": "KDE Plasma 6.7 review: still the best Linux Desktop IMO - sigmaprout152", "date_modified": "2026-06-16T15:35:00.784Z", "author": { "name": "sigmaprout152", "url": "https://peerate.fr/accounts/sigmaprout152" } }, { "id": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395", "content_html": "

2:05 I just switched to Cosmic instead of Plasma on my dual monitor desktop setup because you couldn't do this 😭

\n", "url": "https://peertube2.cpy.re/w/1PzVNGBJGeQ5X14BGVkkhx;threadId=192395", "title": "KDE Plasma 6.7 review: still the best Linux Desktop IMO - rb411", "date_modified": "2026-06-16T14:13:41.645Z", "author": { "name": "rb411", "url": "https://tilvids.com/accounts/rb411" } }, { "id": "https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394", "content_html": "

@theadvancegirl C'est tout mignon comme jeu ;)

", "url": "https://peertube2.cpy.re/w/hEQNQgjufQFzP7eAZW1EwB;threadId=192394", "title": "Koa and the Five Pirates of Mara : Chapitre 1 - Sokatra", "date_modified": "2026-06-16T13:19:26.000Z", "author": { "name": "Sokatra", "url": "https://mastodon.mg/users/Sokatra" } }, { "id": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385", "content_html": "

@arnaud_tabarly@mastodon.social Merci Arnaud ! 😃

\n", "url": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385", "title": "News de juin 2026 - MonViolon TV", "date_modified": "2026-06-16T08:58:48.616Z", "author": { "name": "MonViolon TV", "url": "https://exode.me/accounts/monviolon" } }, { "id": "https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386", "content_html": "

Respekt.

\n", "url": "https://peertube2.cpy.re/w/u82teWcfLTWbPTx24j31BM;threadId=192386", "title": "TorTour de Ruhr - Operation Münsterland", "date_modified": "2026-06-16T08:22:59.366Z", "author": { "name": "Operation Münsterland", "url": "https://tube.tchncs.de/accounts/malte_peertube" } }, { "id": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385", "content_html": "

@monviolon Ça fait plaisir d'avoir des nouvelles et puis très chouette cette petite vidéo !!

", "url": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192385", "title": "News de juin 2026 - Arnaud Tabarly", "date_modified": "2026-06-16T07:39:40.000Z", "author": { "name": "Arnaud Tabarly", "url": "https://mastodon.social/users/arnaud_tabarly" } }, { "id": "https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384", "content_html": "

Notification désactivée sur YouTube mais malheureusement pas ici
\nAprès, c'est là tout l’intérêt d'avoirs plusieurs chaînes différentes sur Peertube

\n", "url": "https://peertube2.cpy.re/w/b1PYuq11qXBBTL3phDsVK7;threadId=192384", "title": "Metroid Fusion - Chapitre 1 - Lucilia", "date_modified": "2026-06-16T07:33:22.927Z", "author": { "name": "Lucilia", "url": "https://videos.pair2jeux.tube/accounts/theadvancegirl" } }, { "id": "https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383", "content_html": "

@blast

euh la phrase finale elle est pas carrément problématique ?\n\"On a tous classé sans suite des procédures où on savait qu'un enfant nous décrivait quelque chose qui avait eu lieu (...) mais on nous impulsait pas l'idée qu'il fallait aller au-delà de ces simples auditions\".

Y'a besoin qu'on vous dise qu'il faut sanctionner pénalement les viols d'enfants ?\nVous êtes pas juges, à la base ? C'est pas un peu votre métier ?

", "url": "https://peertube2.cpy.re/w/3eJrvs2vfnqZ8CrK8E3G9K;threadId=192383", "title": "Affaire Lyhanna : la faillite ultime de la macronie - Lien Rag", "date_modified": "2026-06-15T23:22:38.000Z", "author": { "name": "Lien Rag", "url": "https://mastodon.tedomum.net/users/lienrag" } }, { "id": "https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334", "content_html": "

@johnny jonathan

", "url": "https://peertube2.cpy.re/w/wMGHoEDMeG3nVrBB4L4WvG;threadId=192334", "title": "BQN: From Zero to Game of Life in 20 Minutes - yeti", "date_modified": "2026-06-15T15:19:13.000Z", "author": { "name": "yeti", "url": "https://social.nouveau.community/users/yeti" } }, { "id": "https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333", "content_html": "

@louis_derrac Triste d'avoir raté le temps d'échange (j'ai eu un impondérable de dernière minute) mais très intéressantes (et oui denses) présentations … on a de quoi jouer aux cartes 😉

", "url": "https://peertube2.cpy.re/w/gw4Sf82HgzRZxzAKuR9PAn;threadId=192333", "title": "Le défi d'éduquer à un numérique acceptable - 3 juin - Partie 1/2 - DansLeRuSН", "date_modified": "2026-06-15T14:44:05.000Z", "author": { "name": "DansLeRuSН", "url": "https://framapiaf.org/users/danslerush" } }, { "id": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319", "content_html": "

@boulyprod@video.liberta.vip Merci ! Après mon appel désespéré, j'aurai peut-être de la main d'œuvre (on peut toujours rêver après tout) 😉

\n", "url": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319", "title": "News de juin 2026 - MonViolon TV", "date_modified": "2026-06-15T12:04:25.096Z", "author": { "name": "MonViolon TV", "url": "https://exode.me/accounts/monviolon" } }, { "id": "https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973", "content_html": "

@dariusmiles2123@tilvids.com @Rhababerbarbar@tux.social
\nAfter two weeks the max available resolution is still 360p which makes the video blurry. Usually the video quality of Nicks videos is much better, so here must happened something unusual to this video.

\n", "url": "https://peertube2.cpy.re/w/kuTYMmJUmg54F6rN6Gj2j8;threadId=191973", "title": "Cachy OS benchmarked (on Tuxedo InfinityBook Max 16): Hype or Real performance? - Marcus Fihlon", "date_modified": "2026-06-15T10:55:32.079Z", "author": { "name": "Marcus Fihlon", "url": "https://tube.tchncs.de/accounts/mcpringle" } }, { "id": "https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307", "content_html": "

@anonymos678@tube.xy-space.de 😃

\n", "url": "https://peertube2.cpy.re/w/7mWgh52SbK1DGjpTskYHdf;threadId=192307", "title": "Tux-Flash-2026-06-11-pixeledi Tech Hub, Streamen unter Arch, Nix und NixOS, Krisenvorsorge - m23hauke", "date_modified": "2026-06-15T04:37:22.543Z", "author": { "name": "m23hauke", "url": "https://tube.tchncs.de/accounts/m23hauke" } }, { "id": "https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325", "content_html": "

@blast

Il y a peut-être (je dis \"Peut-être\") un aveuglement de certain chiens de garde, mais aucun aveuglement de la direction de ces médias eux-mêmes.

Il y en a eut même des médias alternatifs, mais eux ne peuvent pas être accusés de l'avoir fait sciemment, alors que les médias de masse, si.

Les propagandes pro-génocide ont commencé avant même le 07 Octobre 2023. Il y a eu des préparations de long terme à ce génocide.

", "url": "https://peertube2.cpy.re/w/g7RxoJF1JY9fXU7CUXq5Lf;threadId=192325", "title": "Gaza : enquête sur la complicité et l'aveuglement des médias français - InternetDev-Anti-Communicant🍉", "date_modified": "2026-06-15T03:34:28.000Z", "author": { "name": "InternetDev-Anti-Communicant🍉", "url": "https://mastodon.social/users/InternetDev" } }, { "id": "https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375", "content_html": "

@cthulhu_breakfast@makertube.net probiere mal die passenden Suchmaschinen dafür, um Inhalte in Peertube zu finden https://sepiasearch.org/ und https://peertube.chefblogger.me/index.php

\n", "url": "https://peertube2.cpy.re/w/a7Bk5Gsp7oRzyRLkdPXjJ5;threadId=192375", "title": "Das bessere Social Media ist unbekannt - rebel", "date_modified": "2026-06-14T18:59:07.847Z", "author": { "name": "rebel", "url": "https://tube.tchncs.de/accounts/rebel" } }, { "id": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319", "content_html": "

Bon courage pour les travaux 😉

\n", "url": "https://peertube2.cpy.re/w/qDNHQa7L35qTgACXmY633g;threadId=192319", "title": "News de juin 2026 - BoulyProd", "date_modified": "2026-06-14T15:40:10.793Z", "author": { "name": "BoulyProd", "url": "https://video.liberta.vip/accounts/boulyprod" } }, { "id": "https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318", "content_html": "

#pan

\n", "url": "https://peertube2.cpy.re/w/4hnrbC8QYSrgojC2vv3hvM;threadId=192318", "title": "pan - Verbund offener Werkstätten", "date_modified": "2026-06-14T14:41:19.109Z", "author": { "name": "Verbund offener Werkstätten", "url": "https://tube.tchncs.de/accounts/vow" } } ] } } } } } }, "400": { "x-summary": "field inconsistencies", "description": "Arises when:\n - videoId filter is mixed with a channel filter\n" }, "404": { "description": "video, video channel or account not found" }, "406": { "description": "accept header unsupported" } } } }, "/feeds/videos.{format}": { "get": { "tags": [ "Video Feeds" ], "summary": "Common videos feeds", "operationId": "getSyndicatedVideos", "parameters": [ { "name": "format", "in": "path", "required": true, "description": "format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))", "schema": { "type": "string", "enum": [ "xml", "rss", "rss2", "atom", "atom1", "json", "json1" ] } }, { "name": "accountId", "in": "query", "description": "limit listing to a specific account", "schema": { "type": "string" } }, { "name": "accountName", "in": "query", "description": "limit listing to a specific account", "schema": { "type": "string" } }, { "name": "videoChannelId", "in": "query", "description": "limit listing to a specific video channel", "schema": { "type": "string" } }, { "name": "videoChannelName", "in": "query", "description": "limit listing to a specific video channel", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" } ], "responses": { "200": { "description": "successful operation", "headers": { "Cache-Control": { "schema": { "type": "string", "default": "max-age=900" } } }, "content": { "application/xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[PiL - Warrior - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n Wed, 17 Jun 2026 23:24:14 GMT\n \n PiL - Warrior - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Warrior - Paris - 04/06/2026\n PiL - Warrior - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Know Now - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n Wed, 17 Jun 2026 23:18:45 GMT\n \n PiL - Know Now - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Know Now - Paris - 04/06/2026\n PiL - Know Now - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Public Image - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n Wed, 17 Jun 2026 23:10:31 GMT\n \n PiL - Public Image - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Public Image - Paris - 04/06/2026\n PiL - Public Image - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Split Second - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n Wed, 17 Jun 2026 23:09:58 GMT\n \n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Split Second - Paris - 17/06/2026\n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[anonradio-record-2026-06-06]]>\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n Wed, 17 Jun 2026 23:07:26 GMT\n tanakian dj sets\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n anonradio-record-2026-06-06\n \n \n <![CDATA[Dogstar - Shallow Easy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n Wed, 17 Jun 2026 23:07:22 GMT\n \n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shallow Easy - Paris - 17/06/2026\n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - What Is + Marmalade - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n Wed, 17 Jun 2026 23:06:01 GMT\n \n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - What Is + Marmalade - Paris - 17/06/2026\n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Breach - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n Wed, 17 Jun 2026 23:05:48 GMT\n \n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Breach - Paris - 17/06/2026\n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Shards of Rain - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n Wed, 17 Jun 2026 23:02:43 GMT\n \n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shards of Rain - Paris - 17/06/2026\n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n Wed, 17 Jun 2026 23:01:49 GMT\n \n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026\n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Guessing Games - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n Wed, 17 Jun 2026 22:59:13 GMT\n \n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Guessing Games - Paris - 17/06/2026\n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Blonde - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n Wed, 17 Jun 2026 22:56:15 GMT\n \n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Blonde - Paris - 17/06/2026\n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Joy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n Wed, 17 Jun 2026 22:53:22 GMT\n \n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Joy - Paris - 17/06/2026\n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Siren - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n Wed, 17 Jun 2026 22:51:23 GMT\n \n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Siren - Paris - 17/06/2026\n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Chewing Glass - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n Wed, 17 Jun 2026 22:51:04 GMT\n \n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Chewing Glass - Paris - 17/06/2026\n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n Wed, 17 Jun 2026 22:42:07 GMT\n \n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026\n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n Wed, 17 Jun 2026 22:33:57 GMT\n \n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026\n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n Wed, 17 Jun 2026 22:29:39 GMT\n \n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PORTACINT]]>\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n Wed, 17 Jun 2026 22:14:51 GMT\n \n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites.
\nPuedes elegir tus patadas o llaves favoritas.
\nLos estamos fabricando en:
\nPerú, Chile, México, Argentina, Guatemala, Panamá, USA, Costa Rica, Uruguay, Colombia, Ecuador, Brasil, Indonesia....
\nSi te gustaría uno solo envíamos un mensaje o escríbenos al Whatsapp central del perfil
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTACINT\n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites. Puedes elegir tus patadas o...\n \n \n <![CDATA[PORTA CINT]]>\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n Wed, 17 Jun 2026 22:11:18 GMT\n \n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable.
\nLos estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica, Uruguay, Brasil , Indonesia...

\n

Enviarnos un mensaje o escribirnos al Whatsapp central de pedidos:
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTA CINT\n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable. Los estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica,...\n \n \n" } } }, "application/rss+xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[PiL - Warrior - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n Wed, 17 Jun 2026 23:24:14 GMT\n \n PiL - Warrior - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Warrior - Paris - 04/06/2026\n PiL - Warrior - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Know Now - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n Wed, 17 Jun 2026 23:18:45 GMT\n \n PiL - Know Now - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Know Now - Paris - 04/06/2026\n PiL - Know Now - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Public Image - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n Wed, 17 Jun 2026 23:10:31 GMT\n \n PiL - Public Image - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Public Image - Paris - 04/06/2026\n PiL - Public Image - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Split Second - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n Wed, 17 Jun 2026 23:09:58 GMT\n \n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Split Second - Paris - 17/06/2026\n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[anonradio-record-2026-06-06]]>\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n Wed, 17 Jun 2026 23:07:26 GMT\n tanakian dj sets\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n anonradio-record-2026-06-06\n \n \n <![CDATA[Dogstar - Shallow Easy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n Wed, 17 Jun 2026 23:07:22 GMT\n \n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shallow Easy - Paris - 17/06/2026\n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - What Is + Marmalade - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n Wed, 17 Jun 2026 23:06:01 GMT\n \n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - What Is + Marmalade - Paris - 17/06/2026\n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Breach - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n Wed, 17 Jun 2026 23:05:48 GMT\n \n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Breach - Paris - 17/06/2026\n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Shards of Rain - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n Wed, 17 Jun 2026 23:02:43 GMT\n \n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shards of Rain - Paris - 17/06/2026\n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n Wed, 17 Jun 2026 23:01:49 GMT\n \n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026\n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Guessing Games - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n Wed, 17 Jun 2026 22:59:13 GMT\n \n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Guessing Games - Paris - 17/06/2026\n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Blonde - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n Wed, 17 Jun 2026 22:56:15 GMT\n \n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Blonde - Paris - 17/06/2026\n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Joy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n Wed, 17 Jun 2026 22:53:22 GMT\n \n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Joy - Paris - 17/06/2026\n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Siren - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n Wed, 17 Jun 2026 22:51:23 GMT\n \n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Siren - Paris - 17/06/2026\n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Chewing Glass - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n Wed, 17 Jun 2026 22:51:04 GMT\n \n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Chewing Glass - Paris - 17/06/2026\n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n Wed, 17 Jun 2026 22:42:07 GMT\n \n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026\n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n Wed, 17 Jun 2026 22:33:57 GMT\n \n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026\n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n Wed, 17 Jun 2026 22:29:39 GMT\n \n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PORTACINT]]>\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n Wed, 17 Jun 2026 22:14:51 GMT\n \n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites.
\nPuedes elegir tus patadas o llaves favoritas.
\nLos estamos fabricando en:
\nPerú, Chile, México, Argentina, Guatemala, Panamá, USA, Costa Rica, Uruguay, Colombia, Ecuador, Brasil, Indonesia....
\nSi te gustaría uno solo envíamos un mensaje o escríbenos al Whatsapp central del perfil
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTACINT\n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites. Puedes elegir tus patadas o...\n \n \n <![CDATA[PORTA CINT]]>\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n Wed, 17 Jun 2026 22:11:18 GMT\n \n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable.
\nLos estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica, Uruguay, Brasil , Indonesia...

\n

Enviarnos un mensaje o escribirnos al Whatsapp central de pedidos:
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTA CINT\n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable. Los estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica,...\n \n \n" } } }, "text/xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" }, "examples": { "nightly": { "value": "\n\n \n PeerTube Nightly\n https://peertube2.cpy.re\n 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.\n Thu, 18 Jun 2026 03:03:47 GMT\n https://validator.w3.org/feed/docs/rss2.html\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re\n \n 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.\n \n \n <![CDATA[PiL - Warrior - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n Wed, 17 Jun 2026 23:24:14 GMT\n \n PiL - Warrior - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Warrior - Paris - 04/06/2026\n PiL - Warrior - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Know Now - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n Wed, 17 Jun 2026 23:18:45 GMT\n \n PiL - Know Now - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Know Now - Paris - 04/06/2026\n PiL - Know Now - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PiL - Public Image - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n Wed, 17 Jun 2026 23:10:31 GMT\n \n PiL - Public Image - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - Public Image - Paris - 04/06/2026\n PiL - Public Image - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Split Second - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n Wed, 17 Jun 2026 23:09:58 GMT\n \n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Split Second - Paris - 17/06/2026\n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[anonradio-record-2026-06-06]]>\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n Wed, 17 Jun 2026 23:07:26 GMT\n tanakian dj sets\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n anonradio-record-2026-06-06\n \n \n <![CDATA[Dogstar - Shallow Easy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n Wed, 17 Jun 2026 23:07:22 GMT\n \n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shallow Easy - Paris - 17/06/2026\n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - What Is + Marmalade - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n Wed, 17 Jun 2026 23:06:01 GMT\n \n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - What Is + Marmalade - Paris - 17/06/2026\n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Breach - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n Wed, 17 Jun 2026 23:05:48 GMT\n \n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Breach - Paris - 17/06/2026\n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Shards of Rain - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n Wed, 17 Jun 2026 23:02:43 GMT\n \n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Shards of Rain - Paris - 17/06/2026\n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n Wed, 17 Jun 2026 23:01:49 GMT\n \n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026\n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Guessing Games - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n Wed, 17 Jun 2026 22:59:13 GMT\n \n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Guessing Games - Paris - 17/06/2026\n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Blonde - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n Wed, 17 Jun 2026 22:56:15 GMT\n \n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Blonde - Paris - 17/06/2026\n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Joy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n Wed, 17 Jun 2026 22:53:22 GMT\n \n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Joy - Paris - 17/06/2026\n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[Dogstar - Siren - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n Wed, 17 Jun 2026 22:51:23 GMT\n \n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n Dogstar - Siren - Paris - 17/06/2026\n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[James And The Cold Gun - Chewing Glass - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n Wed, 17 Jun 2026 22:51:04 GMT\n \n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n James And The Cold Gun - Chewing Glass - Paris - 17/06/2026\n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n Wed, 17 Jun 2026 22:42:07 GMT\n \n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026\n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n Wed, 17 Jun 2026 22:33:57 GMT\n \n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026\n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n Wed, 17 Jun 2026 22:29:39 GMT\n \n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026

\n]]>\n flo200\n Music\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026\n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026\n \n \n <![CDATA[PORTACINT]]>\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n Wed, 17 Jun 2026 22:14:51 GMT\n \n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites.
\nPuedes elegir tus patadas o llaves favoritas.
\nLos estamos fabricando en:
\nPerú, Chile, México, Argentina, Guatemala, Panamá, USA, Costa Rica, Uruguay, Colombia, Ecuador, Brasil, Indonesia....
\nSi te gustaría uno solo envíamos un mensaje o escríbenos al Whatsapp central del perfil
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTACINT\n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites. Puedes elegir tus patadas o...\n \n \n <![CDATA[PORTA CINT]]>\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n Wed, 17 Jun 2026 22:11:18 GMT\n \n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable.
\nLos estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica, Uruguay, Brasil , Indonesia...

\n

Enviarnos un mensaje o escribirnos al Whatsapp central de pedidos:
\n+51994679206

\n]]>\n Karate Kombat\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n nonadult\n PORTA CINT\n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable. Los estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica,...\n \n \n" } } }, "application/atom+xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" }, "examples": { "nightly": { "value": "\n\n https://peertube2.cpy.re\n PeerTube Nightly\n 2026-06-18T03:03:47.443Z\n PeerTube - https://peertube2.cpy.re\n \n PeerTube Nightly\n \n \n \n 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.\n https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png\n https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png\n 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.\n \n <![CDATA[PiL - Warrior - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2\n \n 2026-06-17T23:24:14.835Z\n \n PiL - Warrior - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[PiL - Know Now - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2\n \n 2026-06-17T23:18:45.989Z\n \n PiL - Know Now - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[PiL - Public Image - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE\n \n 2026-06-17T23:10:31.268Z\n \n PiL - Public Image - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[James And The Cold Gun - Split Second - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW\n \n 2026-06-17T23:09:58.486Z\n \n James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[anonradio-record-2026-06-06]]>\n https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw\n \n 2026-06-17T23:07:26.196Z\n \n tanakian dj sets\n https://peertube2.cpy.re/c/tanakian_channel@toobnix.org/videos\n \n \n \n \n <![CDATA[Dogstar - Shallow Easy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2\n \n 2026-06-17T23:07:22.970Z\n \n Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - What Is + Marmalade - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga\n \n 2026-06-17T23:06:01.358Z\n \n Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - Breach - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA\n \n 2026-06-17T23:05:48.569Z\n \n Dogstar - Breach - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - Shards of Rain - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt\n \n 2026-06-17T23:02:43.789Z\n \n Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ\n \n 2026-06-17T23:01:49.638Z\n \n PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[James And The Cold Gun - Guessing Games - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a\n \n 2026-06-17T22:59:13.542Z\n \n James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - Blonde - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o\n \n 2026-06-17T22:56:15.931Z\n \n Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - Joy - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh\n \n 2026-06-17T22:53:22.641Z\n \n Dogstar - Joy - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[Dogstar - Siren - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu\n \n 2026-06-17T22:51:23.858Z\n \n Dogstar - Siren - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[James And The Cold Gun - Chewing Glass - Paris - 17/06/2026]]>\n https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL\n \n 2026-06-17T22:51:04.457Z\n \n James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f\n \n 2026-06-17T22:42:07.210Z\n \n RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX\n \n 2026-06-17T22:33:57.965Z\n \n RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026]]>\n https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx\n \n 2026-06-17T22:29:39.211Z\n \n RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026

\n]]>\n \n flo200\n https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos\n \n \n \n \n <![CDATA[PORTACINT]]>\n https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah\n \n 2026-06-17T22:14:51.764Z\n \n KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites.
\nPuedes elegir tus patadas o llaves favoritas.
\nLos estamos fabricando en:
\nPerú, Chile, México, Argentina, Guatemala, Panamá, USA, Costa Rica, Uruguay, Colombia, Ecuador, Brasil, Indonesia....
\nSi te gustaría uno solo envíamos un mensaje o escríbenos al Whatsapp central del perfil
\n+51994679206

\n]]>\n \n Karate Kombat\n https://peertube2.cpy.re/c/karate_kombat@peertube.uno/videos\n \n \n \n <![CDATA[PORTA CINT]]>\n https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t\n \n 2026-06-17T22:11:18.379Z\n \n El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable.
\nLos estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica, Uruguay, Brasil , Indonesia...

\n

Enviarnos un mensaje o escribirnos al Whatsapp central de pedidos:
\n+51994679206

\n]]>\n \n Karate Kombat\n https://peertube2.cpy.re/c/karate_kombat@peertube.uno/videos\n \n \n" } } }, "application/json": { "schema": { "type": "object" }, "examples": { "nightly": { "value": { "version": "https://jsonfeed.org/version/1", "title": "PeerTube Nightly", "home_page_url": "https://peertube2.cpy.re", "feed_url": "https://peertube2.cpy.re/feeds/videos.json?scope=local", "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.", "icon": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "author": { "name": "PeerTube Nightly" }, "items": [ { "id": "https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2", "content_html": "

PiL - Warrior - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/siMWx9JxqmV4LPKkGAoXn2", "title": "PiL - Warrior - Paris - 04/06/2026", "summary": "PiL - Warrior - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/277b476e-2f30-4d0f-a72f-b546b5c869fa-0.torrent", "size_in_bytes": 21697182, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/414bac5e-6607-443a-be2a-5947cae75fa5-1080-hls.torrent", "size_in_bytes": 309705905, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/54accafd-9786-4624-93ff-a1165a4f49e8-720-hls.torrent", "size_in_bytes": 144918578, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/0b346c37-a521-436a-85cd-44bd4c302ad9-480-hls.torrent", "size_in_bytes": 82974531, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/c02195ac-0c56-410c-9c96-d34a5ddeec97-240-hls.torrent", "size_in_bytes": 36427074, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Warrior - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/fbdfbd25-36ba-4d87-b76a-c13bbec3a4a9-0-hls.torrent", "size_in_bytes": 11019412, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:24:14.835Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2", "content_html": "

PiL - Know Now - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/snKvqArsr5Y4ciD3XM8Tr2", "title": "PiL - Know Now - Paris - 04/06/2026", "summary": "PiL - Know Now - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/66a8044c-4ea4-4aeb-a5b9-9d07f82e51fa-0.torrent", "size_in_bytes": 6144315, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/694f6d68-1ae9-408e-89db-dfec39a71e09-1080-hls.torrent", "size_in_bytes": 153954596, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/0015d144-06f3-4657-8d44-8544d8956098-720-hls.torrent", "size_in_bytes": 71725647, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/9cb35f2a-5ab2-4d81-aecf-e6b9acc53fdb-480-hls.torrent", "size_in_bytes": 37007104, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/1c15281e-1cde-4f3d-9f73-e3d3c6e2f054-240-hls.torrent", "size_in_bytes": 14667364, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Know Now - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/99b495f9-3f9a-4d14-ab59-460f633af70a-0-hls.torrent", "size_in_bytes": 3140207, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:18:45.989Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE", "content_html": "

PiL - Public Image - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/byyBLp4M1NMofSfroRDabE", "title": "PiL - Public Image - Paris - 04/06/2026", "summary": "PiL - Public Image - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/91026a3c-cc30-4cf7-8da9-8378cf070f62-0.torrent", "size_in_bytes": 6935919, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/4d8a4cde-7466-4f32-8ca7-dc57ff266cc2-1080-hls.torrent", "size_in_bytes": 148687691, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/22b9c209-1602-4948-a40f-eddf43347dc0-720-hls.torrent", "size_in_bytes": 72698344, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/460fde16-34ad-4e84-a763-1b405a737fb2-480-hls.torrent", "size_in_bytes": 39781667, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/4557f245-3b28-4673-9b4a-dd721630c80c-240-hls.torrent", "size_in_bytes": 16480792, "mime_type": "application/x-bittorrent" }, { "title": "PiL - Public Image - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/b7f22d32-6dfb-4923-9123-ecf9e0608466-0-hls.torrent", "size_in_bytes": 3515864, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:10:31.268Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW", "content_html": "

James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/s2nnJSV4godRYadUBjQXhW", "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "summary": "James And The Cold Gun - Split Second (Hometown Crew) - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/97a05197-80ca-42ba-bc6d-836a6963f4fd-0.torrent", "size_in_bytes": 10001245, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/d89ba169-a4d3-448d-a41a-ca7fab42b496-1080-hls.torrent", "size_in_bytes": 185735495, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/7d47ae12-df3e-4a14-ab5e-83959bfe0aa4-720-hls.torrent", "size_in_bytes": 91729896, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5079167f-fc0a-42e2-a464-9cd90e2f2598-480-hls.torrent", "size_in_bytes": 49798640, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/49412836-2e38-4e2d-a8cf-547d6ca9452d-240-hls.torrent", "size_in_bytes": 20799749, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Split Second - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/6beff3c3-a083-4e81-93ec-422956de4d48-0-hls.torrent", "size_in_bytes": 5067597, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:09:58.486Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw", "content_html": "", "url": "https://peertube2.cpy.re/w/u574yWRNsFdkgdXqMjtfEw", "title": "anonradio-record-2026-06-06", "attachments": [ { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/87f821b7-e26b-4fe8-bd5e-29db46f1cf04-1080.torrent", "size_in_bytes": 1060226829, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/69d08023-1433-4d0e-9152-8107890bbf4e-720.torrent", "size_in_bytes": 435512788, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/4588afd0-e606-41b6-8d82-7a4de9333655-480.torrent", "size_in_bytes": 294438863, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/e87a271f-9a76-4d44-9740-b5d64f3ddec9-360.torrent", "size_in_bytes": 239351549, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/199c0bcc-9afb-4e33-9f2c-51870e7de46e-240.torrent", "size_in_bytes": 191735162, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/f538a946-6ae9-4aa0-aff5-f92bcafd91c4-0.torrent", "size_in_bytes": 145201098, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/83efb140-8704-4534-9123-4935d589633f-1080-hls.torrent", "size_in_bytes": 1059718879, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/06d9c24a-1eb8-4967-a924-487e51faf8a0-240-hls.torrent", "size_in_bytes": 191231836, "mime_type": "application/x-bittorrent" }, { "title": "anonradio-record-2026-06-06", "url": "https://peertube2.cpy.re/lazy-static/torrents/fd038938-36bc-4d58-9d48-98f584f7ff11-0-hls.torrent", "size_in_bytes": 145340348, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:07:26.196Z", "author": { "name": "tanakian dj sets", "url": "https://peertube2.cpy.re/c/tanakian_channel@toobnix.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2", "content_html": "

Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/6ERLUrCdFLJPzf2JrfA8z2", "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "summary": "Dogstar - Shallow Easy - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/834f6d3e-035f-4891-8204-4eed99730f6d-0.torrent", "size_in_bytes": 8528667, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/423c9e35-9f3e-4602-b6a9-6c3e5a112b05-1080-hls.torrent", "size_in_bytes": 119507182, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/a7e52f92-7c13-4972-a3ed-5c7dcf0ec85e-720-hls.torrent", "size_in_bytes": 57085853, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/2b590674-d1fb-49e5-a8cf-7bd94ae725ad-480-hls.torrent", "size_in_bytes": 31445077, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/9c69aef1-4f51-437a-b6e7-c17304859f2e-240-hls.torrent", "size_in_bytes": 13784825, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shallow Easy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/722c1b6a-00a7-45a1-9bd1-d4c085a95603-0-hls.torrent", "size_in_bytes": 4346008, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:07:22.970Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga", "content_html": "

Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/hws6uFUGMEfAxfDqUMwzga", "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "summary": "Dogstar - What Is + Marmalade - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/f6ac13f8-e82e-46a1-b584-f733156d1ce4-0.torrent", "size_in_bytes": 10078634, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/0b0d824d-c995-47e3-a208-df11c2dd8e4b-1080-hls.torrent", "size_in_bytes": 214372098, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/bfd85d3c-26a1-41bc-a579-496bf323fa00-720-hls.torrent", "size_in_bytes": 101781752, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/e54ab9fc-3892-4903-b82f-6b8e781e843f-480-hls.torrent", "size_in_bytes": 53971183, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/43cbb96b-fa87-4c76-b603-8abde83cad31-240-hls.torrent", "size_in_bytes": 21847985, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - What Is + Marmalade - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/16b95a3b-77b0-45c7-b385-f6f573164d80-0-hls.torrent", "size_in_bytes": 5127883, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:06:01.358Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA", "content_html": "

Dogstar - Breach - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/tNVB6rZLtFNTZmX4vKiaPA", "title": "Dogstar - Breach - Paris - 17/06/2026", "summary": "Dogstar - Breach - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/e5632eb6-99f2-427e-9e6c-147ebddd9487-0.torrent", "size_in_bytes": 7063517, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/a4bb64c3-1f37-4e02-af7a-a8835afbbaaf-1080-hls.torrent", "size_in_bytes": 92103338, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/6e1d3f0d-1426-4762-a57a-8863d91c6089-720-hls.torrent", "size_in_bytes": 46368597, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/73a249b4-928b-48dd-8056-6479b1098f09-480-hls.torrent", "size_in_bytes": 26487010, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/cb3d7d64-dab7-418b-b84c-4c6e936a53ff-240-hls.torrent", "size_in_bytes": 11621746, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Breach - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/f5318892-ab0e-45d2-8863-b3ad7ce7ce0e-0-hls.torrent", "size_in_bytes": 3584692, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:05:48.569Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt", "content_html": "

Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/i7e34hZSnucw8frHQyrzzt", "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "summary": "Dogstar - Shards of Rain - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/1e012943-ea90-4825-975f-a394afc09087-0.torrent", "size_in_bytes": 7382990, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/eb613373-809f-4afb-94b7-54ac01d8f5d5-1080-hls.torrent", "size_in_bytes": 134494521, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5fee17fc-013b-4de9-9237-dab666f762ff-720-hls.torrent", "size_in_bytes": 49009208, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/71365cfc-b803-4774-be98-14a2607f53aa-480-hls.torrent", "size_in_bytes": 25015401, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5d2a3179-5f96-41c4-a86a-368ba906bb4a-240-hls.torrent", "size_in_bytes": 10217142, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Shards of Rain - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/dfa92a24-b3a8-41db-8b7f-b24f830fdb10-0-hls.torrent", "size_in_bytes": 3749143, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:02:43.789Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ", "content_html": "

PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/gZPE4duZX8XJh7aMaRwsQJ", "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "summary": "PiL - This Is Not a Love Song + Poptones - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ba573911-fe29-4f53-886a-95f482b03a17-0.torrent", "size_in_bytes": 26546890, "mime_type": "application/x-bittorrent" }, { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5b9ee04a-fafe-43f4-94bc-a105bf260499-1080-hls.torrent", "size_in_bytes": 548221883, "mime_type": "application/x-bittorrent" }, { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/f31c1b6e-43a7-4417-ab9d-c52f80e86c7c-720-hls.torrent", "size_in_bytes": 243539975, "mime_type": "application/x-bittorrent" }, { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/8cc309e6-2eb4-4de9-9fc2-5cee8e46feaf-480-hls.torrent", "size_in_bytes": 132176486, "mime_type": "application/x-bittorrent" }, { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/7ca13807-cda8-47e0-96ee-ed25875eb64e-240-hls.torrent", "size_in_bytes": 53027454, "mime_type": "application/x-bittorrent" }, { "title": "PiL - This Is Not a Love Song + Poptones - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/4cbc9aff-ad5f-4787-9503-dd6188f45b7b-0-hls.torrent", "size_in_bytes": 13486389, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T23:01:49.638Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a", "content_html": "

James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/cAhhWi1M8JWGbDsJx7Xi7a", "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "summary": "James And The Cold Gun - Guessing Games - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/78b70482-5e1c-4924-b980-7993924858f0-0.torrent", "size_in_bytes": 8689722, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/6f0ff443-21dc-4fe4-88a7-f46ae317f862-1080-hls.torrent", "size_in_bytes": 183850588, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/02cb9a5f-53d0-41b5-a535-8cb95a2e9980-720-hls.torrent", "size_in_bytes": 87872068, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/86f10723-7d16-4d10-90d3-f1b917175aac-480-hls.torrent", "size_in_bytes": 46357893, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ada9d809-4dab-4495-9486-6ffd82b23fcd-240-hls.torrent", "size_in_bytes": 19115633, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Guessing Games - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/fe903006-5be0-4586-877c-6619f06adc07-0-hls.torrent", "size_in_bytes": 4414842, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:59:13.542Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o", "content_html": "

Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/nYUYDfzRovnpJ9Ssj9pQ3o", "title": "Dogstar - Blonde - Paris - 17/06/2026", "summary": "Dogstar - Blonde - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/7bcb410e-5a3f-4f86-956f-12e21e267b9a-0.torrent", "size_in_bytes": 6742137, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/4a650f26-d095-485e-97ce-ad9e8ee03912-1080-hls.torrent", "size_in_bytes": 95421419, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/dd063dbd-698a-4c48-9758-a9e905444c67-720-hls.torrent", "size_in_bytes": 43628296, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/0e82d232-24b6-425e-a541-89abd47ab189-480-hls.torrent", "size_in_bytes": 23791156, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/c5e3e8b0-8380-4ece-8c85-c7de8609e371-240-hls.torrent", "size_in_bytes": 10122635, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Blonde - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/d8827a91-a3cc-4ac3-b88a-e1cdd8ff0a78-0-hls.torrent", "size_in_bytes": 3422970, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:56:15.931Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh", "content_html": "

Dogstar - Joy - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/gUapScPqrc5isbn1PMM1Gh", "title": "Dogstar - Joy - Paris - 17/06/2026", "summary": "Dogstar - Joy - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/2215fe60-0b6c-42e0-8a45-bb87851cf8a9-0.torrent", "size_in_bytes": 7672340, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5405e474-b8c8-4f01-8807-6513978b90aa-1080-hls.torrent", "size_in_bytes": 139043806, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/28771009-d5b6-4d60-ba72-a89daed94107-720-hls.torrent", "size_in_bytes": 64315283, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/18df08ca-4a9e-4b27-ab20-63470751c4b8-480-hls.torrent", "size_in_bytes": 33974802, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/a1371b8b-fa55-41c9-8130-c94cb825728e-240-hls.torrent", "size_in_bytes": 13639856, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Joy - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/faf43d49-33ea-427a-86c5-f37b63c86f1b-0-hls.torrent", "size_in_bytes": 3903962, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:53:22.641Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu", "content_html": "

Dogstar - Siren - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/pinw7grjGciF752SXDKuiu", "title": "Dogstar - Siren - Paris - 17/06/2026", "summary": "Dogstar - Siren - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/c02faea7-820d-4d15-9521-01f04cbcc1eb-0.torrent", "size_in_bytes": 6463672, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/83cf0d25-bbcb-4798-af42-b937f46a2ef4-1080-hls.torrent", "size_in_bytes": 94591856, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/02116f66-f5e8-435a-b324-8e18fe9db3ba-720-hls.torrent", "size_in_bytes": 44724061, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/8b8543fc-4e75-4174-9821-98e71fa9117c-480-hls.torrent", "size_in_bytes": 25001239, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/dc3a445d-8725-428f-b4c0-bd9f72970531-240-hls.torrent", "size_in_bytes": 10701628, "mime_type": "application/x-bittorrent" }, { "title": "Dogstar - Siren - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ff37ebee-3440-4008-bd99-d1c69e449725-0-hls.torrent", "size_in_bytes": 3286343, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:51:23.858Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL", "content_html": "

James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026

\n", "url": "https://peertube2.cpy.re/w/gPWagUfqEvmvPfbVZvE8RL", "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "summary": "James And The Cold Gun - Chewing Glass - L'Olympia, Paris - 17 juin 2026", "attachments": [ { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/9c4e6396-2493-4011-a37e-ab2fc40d6e09-0.torrent", "size_in_bytes": 8806401, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/a7dea7f4-3b89-4695-bb6c-d924d98ba1df-1080-hls.torrent", "size_in_bytes": 172015080, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ca0c1fb4-9724-4b99-bf45-f40866fb0df4-720-hls.torrent", "size_in_bytes": 85492366, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ff0aef9b-44be-4763-99a6-5b3364c23a27-480-hls.torrent", "size_in_bytes": 45472955, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5a6e5161-64c1-4e5b-a9d8-268eb1a3ef8f-240-hls.torrent", "size_in_bytes": 18924888, "mime_type": "application/x-bittorrent" }, { "title": "James And The Cold Gun - Chewing Glass - Paris - 17/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/e9987104-47ef-422a-ba78-531248e67ff5-0-hls.torrent", "size_in_bytes": 4468642, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:51:04.457Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f", "content_html": "

RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/tYvgbD2mTUVB1MGsZZhK9f", "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "summary": "RENDEZ-VOUS - LAST STOP - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/d5c327e4-cdef-466c-8c2b-a4aa2fbd086d-0.torrent", "size_in_bytes": 20349989, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/43088172-b464-4586-8e3f-6e4ce8a299b3-1080-hls.torrent", "size_in_bytes": 464426520, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/81598e83-9c89-4144-b87d-cb95b108f854-720-hls.torrent", "size_in_bytes": 225178185, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/7ea85327-1f88-4a23-87d1-eb50c4ad7999-480-hls.torrent", "size_in_bytes": 116553688, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/6bcdf9de-97c4-4d34-94ff-f5687074f8e6-240-hls.torrent", "size_in_bytes": 48266514, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - LAST STOP - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/ec6902fc-785b-46ea-b189-c7089ac1c99c-0-hls.torrent", "size_in_bytes": 10343813, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:42:07.210Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX", "content_html": "

RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/uUpZURRSrzHrt8ZRSu7GbX", "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "summary": "RENDEZ-VOUS - DOUBLE ZERO - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/3f0279a7-e6b4-4572-a37b-0da7572c600a-0.torrent", "size_in_bytes": 10645227, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/2b676fb4-766b-4f49-af88-d09948d74446-1080-hls.torrent", "size_in_bytes": 246696047, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/73199391-bfb3-4fd1-af03-7f0c8441a772-720-hls.torrent", "size_in_bytes": 120496201, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/270e7545-5325-4254-828c-79979a36096e-480-hls.torrent", "size_in_bytes": 61571987, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/cb328784-d942-411c-9be0-e7f990e2b979-240-hls.torrent", "size_in_bytes": 25431128, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - DOUBLE ZERO - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/5df2227d-a2c7-4968-9295-fa259253712a-0-hls.torrent", "size_in_bytes": 5403059, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:33:57.965Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx", "content_html": "

RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026

\n", "url": "https://peertube2.cpy.re/w/v6uqhgaPTrea81u6oTBXkx", "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "summary": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Le Trianon, Paris - 4 juin 2026", "attachments": [ { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/d896cae4-0a31-41d5-b460-4ac2c98b1218-0.torrent", "size_in_bytes": 8819553, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/43de6da5-7f47-4201-91c9-68f7dfd9ad96-1080-hls.torrent", "size_in_bytes": 197719143, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/6d3a69e0-9c8c-480c-91f5-9ff2394d2b85-720-hls.torrent", "size_in_bytes": 96503159, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/a7e65e4b-b85a-4aeb-ba52-0e893299b263-480-hls.torrent", "size_in_bytes": 49734572, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/c4c6b400-5f5e-41db-8691-d7b1d19b57ed-240-hls.torrent", "size_in_bytes": 20729188, "mime_type": "application/x-bittorrent" }, { "title": "RENDEZ-VOUS - SENTIMENTAL ANIMAL - Paris - 04/06/2026", "url": "https://peertube2.cpy.re/lazy-static/torrents/731ba64a-75ce-46dc-a0f1-1abf09e1d024-0-hls.torrent", "size_in_bytes": 4485351, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:29:39.211Z", "author": { "name": "flo200", "url": "https://peertube2.cpy.re/c/22fb3227-21c7-4afa-954f-020ac3c3feea@www.yiny.org/videos" }, "tags": [ "Music" ] }, { "id": "https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah", "content_html": "

KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites.
\nPuedes elegir tus patadas o llaves favoritas.
\nLos estamos fabricando en:
\nPerú, Chile, México, Argentina, Guatemala, Panamá, USA, Costa Rica, Uruguay, Colombia, Ecuador, Brasil, Indonesia....
\nSi te gustaría uno solo envíamos un mensaje o escríbenos al Whatsapp central del perfil
\n+51994679206

\n", "url": "https://peertube2.cpy.re/w/7mWK1ubdp1JevYtVU7h6ah", "title": "PORTACINT", "summary": "KARATE, TAEKWONDO, JIUJITSU y para cualquier arte marcial. Diseñamos a tu gusto estos hermosos porta cinturones en acero inoxidable 304, le ponemos tu nombre y los hacemos para la cantidad de cinturones que necesites. Puedes elegir tus patadas o...", "attachments": [ { "title": "PORTACINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/833891f0-e3f7-4c4d-b347-5eb475630d9f-0.torrent", "size_in_bytes": 303500, "mime_type": "application/x-bittorrent" }, { "title": "PORTACINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/dc48b6a7-5b7f-4f2e-bd38-be553f8705da-1936-hls.torrent", "size_in_bytes": 4960964, "mime_type": "application/x-bittorrent" }, { "title": "PORTACINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/a4ee12ba-3d2f-4165-b208-9853256c2b6b-0-hls.torrent", "size_in_bytes": 304246, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:14:51.764Z", "author": { "name": "Karate Kombat", "url": "https://peertube2.cpy.re/c/karate_kombat@peertube.uno/videos" } }, { "id": "https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t", "content_html": "

El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable.
\nLos estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica, Uruguay, Brasil , Indonesia...

\n

Enviarnos un mensaje o escribirnos al Whatsapp central de pedidos:
\n+51994679206

\n", "url": "https://peertube2.cpy.re/w/oNWiKj8WDM3xh42x8Qtz2t", "title": "PORTA CINT", "summary": "El lujo llegó a las artes marciales. El mejor accesorio para tus logros: PORTA CINTURONES PERSONALIZADOS en acero inoxidable. Los estamos fabricando en Perú, México, Chile, Ecuador, Colombia, Guatemala, Panamá, USA, Argentina, Brasil, Costa Rica,...", "attachments": [ { "title": "PORTA CINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/17c6ba14-e94b-4cdf-9723-296d7e81ce09-0.torrent", "size_in_bytes": 214638, "mime_type": "application/x-bittorrent" }, { "title": "PORTA CINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/e0150729-1b9b-4cba-9561-1f18c41d335f-1936-hls.torrent", "size_in_bytes": 2850845, "mime_type": "application/x-bittorrent" }, { "title": "PORTA CINT", "url": "https://peertube2.cpy.re/lazy-static/torrents/eddf2939-8080-49e1-9f7d-2308685a713a-0-hls.torrent", "size_in_bytes": 215224, "mime_type": "application/x-bittorrent" } ], "date_modified": "2026-06-17T22:11:18.379Z", "author": { "name": "Karate Kombat", "url": "https://peertube2.cpy.re/c/karate_kombat@peertube.uno/videos" } } ] } } } } } }, "404": { "description": "video channel or account not found" }, "406": { "description": "accept header unsupported" } } } }, "/feeds/subscriptions.{format}": { "get": { "tags": [ "Video Feeds" ], "summary": "Videos of subscriptions feeds", "operationId": "getSyndicatedSubscriptionVideos", "parameters": [ { "name": "format", "in": "path", "required": true, "description": "format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))", "schema": { "type": "string", "enum": [ "xml", "rss", "rss2", "atom", "atom1", "json", "json1" ] } }, { "name": "accountId", "in": "query", "description": "limit listing to a specific account", "schema": { "type": "string" }, "required": true }, { "name": "token", "in": "query", "description": "private token allowing access", "schema": { "type": "string" }, "required": true }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" } ], "responses": { "200": { "description": "successful operation", "headers": { "Cache-Control": { "schema": { "type": "string", "default": "max-age=900" } } }, "content": { "application/xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" } }, "application/rss+xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" } }, "application/atom+xml": { "schema": { "$ref": "#/components/schemas/VideosForXML" } }, "application/json": { "schema": { "type": "object" } } } }, "406": { "description": "accept header unsupported" } } } }, "/feeds/podcast/videos.xml": { "get": { "tags": [ "Video Feeds" ], "summary": "Videos podcast feed", "operationId": "getVideosPodcastFeed", "parameters": [ { "name": "videoChannelId", "in": "query", "description": "Limit listing to a specific video channel", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "headers": { "Cache-Control": { "schema": { "type": "string", "default": "max-age=900" } } } }, "404": { "description": "video channel not found" } } } }, "/api/v1/accounts/{name}": { "get": { "tags": [ "Accounts" ], "summary": "Get an account", "operationId": "getAccount", "parameters": [ { "$ref": "#/components/parameters/name" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Account" } } } }, "404": { "description": "account not found" } } } }, "/api/v1/accounts/{name}/videos": { "get": { "tags": [ "Accounts", "Video" ], "summary": "List videos of an account", "operationId": "getAccountVideos", "parameters": [ { "$ref": "#/components/parameters/name" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } }, "x-codeSamples": [ { "lang": "JavaScript", "source": "fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')\n.then(function(response) {\n return response.json()\n}).then(function(data) {\n console.log(data)\n})\n" }, { "lang": "Shell", "source": "## DEPENDENCIES: jq\ncurl -s https://peertube2.cpy.re/api/v1/accounts/{name}/videos | jq\n" }, { "lang": "Ruby", "source": "require 'net/http'\nrequire 'json'\n\nuri = URI.parse(\"https://peertube2.cpy.re/api/v1/accounts/{name}/videos\")\n\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = true\n\nresponse = http.get(uri.request_uri)\n\nputs JSON.parse(response.read_body)\n" }, { "lang": "Python", "source": "import requests\n\nr = requests.get(\"https://peertube2.cpy.re/api/v1//accounts/{name}/videos\")\njson = r.json()\n\nprint(json)\n" } ] } }, "/api/v1/accounts/{name}/followers": { "get": { "tags": [ "Accounts" ], "summary": "List followers of an account", "security": [ { "OAuth2": [] } ], "operationId": "getAccountFollowers", "parameters": [ { "$ref": "#/components/parameters/name" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/followersSort" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Follow" } } } } } } } } } }, "/api/v1/accounts": { "get": { "tags": [ "Accounts" ], "summary": "List accounts", "operationId": "getAccounts", "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Account" } } } } } } } } } }, "/api/v1/config": { "get": { "tags": [ "Config" ], "summary": "Get instance public configuration", "operationId": "getConfig", "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerConfig" }, "examples": { "nightly": { "value": { "client": { "newFeaturesInfo": true, "header": { "hideInstanceName": false }, "videos": { "miniature": { "preferAuthorDisplayName": true }, "resumableUpload": { "maxChunkSize": 0 } }, "browseVideos": { "defaultSort": "-publishedAt", "defaultScope": "federated" }, "menu": { "login": { "redirectOnSingleExternalAuth": false } }, "openInApp": { "android": { "intent": { "enabled": true, "host": "joinpeertube.org", "scheme": "peertube", "fallbackUrl": "https://play.google.com/store/apps/details?id=org.framasoft.peertube" } }, "ios": { "enabled": true, "host": "joinpeertube.org", "scheme": "peertube", "fallbackUrl": "https://apps.apple.com/fr/app/peertube/id6737834858" } } }, "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", "avatars": [ { "height": 1500, "width": 1500, "path": "/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "isFallback": true }, { "height": 600, "width": 600, "type": "favicon", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png", "isFallback": true }, { "height": 120, "width": 120, "type": "favicon", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png", "isFallback": true }, { "height": 48, "width": 48, "type": "favicon", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png", "isFallback": true }, { "height": 1500, "width": 1500, "type": "header-square", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "isFallback": true }, { "height": 600, "width": 600, "type": "header-square", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png", "isFallback": true }, { "height": 120, "width": 120, "type": "header-square", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png", "isFallback": true }, { "height": 48, "width": 48, "type": "header-square", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png", "isFallback": true }, { "height": 1500, "width": 1500, "type": "header-wide", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "isFallback": true }, { "height": 600, "width": 600, "type": "header-wide", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png", "isFallback": true }, { "height": 120, "width": 120, "type": "header-wide", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png", "isFallback": true }, { "height": 48, "width": 48, "type": "header-wide", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png", "isFallback": true }, { "height": 1500, "width": 1500, "type": "opengraph", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png", "isFallback": true }, { "height": 600, "width": 600, "type": "opengraph", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png", "isFallback": true }, { "height": 120, "width": 120, "type": "opengraph", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/1163da44-0367-4df9-bf10-a1b0dc0e3fb9.png", "isFallback": true }, { "height": 48, "width": 48, "type": "opengraph", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png", "isFallback": true } ] }, "search": { "remoteUri": { "users": true, "anonymous": false }, "searchIndex": { "enabled": true, "url": "https://sepiasearch.org", "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-ldap", "name": "auth-ldap", "version": "0.0.14", "description": "Add LDAP support to login form in PeerTube.", "clientScripts": {} }, { "npmName": "peertube-plugin-akismet", "name": "akismet", "version": "0.1.2", "description": "Reject local comments, remote comments and registrations based on Akismet service", "clientScripts": { "dist/common-client-plugin.js": { "script": "dist/common-client-plugin.js", "scopes": [ "common" ] } } }, { "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-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.2.1-nightly-2026-06-17", "serverCommit": "", "transcoding": { "remoteRunners": { "enabled": true }, "hls": { "enabled": true }, "web_videos": { "enabled": false }, "enabledResolutions": [ 0, 240, 480 ], "profile": "custom-quality", "availableProfiles": [ "default", "custom-quality" ] }, "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" ] }, "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 } }, "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": { "instance": { "autoFollowIndex": { "indexUrl": "https://instances.joinpeertube.org" } } }, "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": false }, "homepage": { "enabled": true }, "openTelemetry": { "metrics": { "enabled": true, "playbackStatsInterval": 15000 } }, "views": { "videos": { "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 } } } } } } } } } }, "/api/v1/config/about": { "get": { "summary": "Get instance \"About\" information", "operationId": "getAbout", "tags": [ "Config" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerConfigAbout" }, "examples": { "nightly": { "value": { "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": "", "administrator": "", "maintenanceLifetime": "", "businessModel": "", "languages": [ "fr" ], "categories": [ 16 ], "banners": [ { "height": 100, "width": 600, "path": "/lazy-static/banners/d853452c-f020-4c6f-a4ea-9fc582d68ff2.jpg", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/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", "fileUrl": "https://peertube2.cpy.re/lazy-static/avatars/abace30f-69ad-4ff2-a954-dea06c5db6eb.png", "createdAt": "2024-05-15T09:12:38.749Z", "updatedAt": "2024-05-15T09:12:38.749Z" } ] } } } } } } } } } }, "/api/v1/config/custom": { "get": { "summary": "Get instance runtime configuration", "operationId": "getCustomConfig", "tags": [ "Config" ], "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerConfigCustom" } } } } } }, "put": { "summary": "Set instance runtime configuration", "operationId": "putCustomConfig", "tags": [ "Config" ], "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation" }, "400": { "x-summary": "field inconsistencies", "description": "Arises when:\n - the emailer is disabled and the instance is open to registrations\n - web videos and hls are disabled with transcoding enabled - you need at least one enabled\n" } } }, "delete": { "summary": "Delete instance runtime configuration", "operationId": "delCustomConfig", "tags": [ "Config" ], "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation" } } } }, "/api/v1/config/instance-banner/pick": { "post": { "summary": "Update instance banner", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "responses": { "204": { "description": "successful operation" }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the banner" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "bannerfile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "bannerfile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/config/instance-banner": { "delete": { "summary": "Delete instance banner", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/config/instance-avatar/pick": { "post": { "summary": "Update instance avatar", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "responses": { "204": { "description": "successful operation" }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the avatar" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "avatarfile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "avatarfile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/config/instance-avatar": { "delete": { "summary": "Delete instance avatar", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/config/instance-logo/{logoType}/pick": { "post": { "summary": "Update instance logo", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "parameters": [ { "$ref": "#/components/parameters/logoTypeParam" } ], "responses": { "204": { "description": "successful operation" }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the banner" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "logofile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "logofile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/config/instance-logo/{logoType}": { "delete": { "summary": "Delete instance logo", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Config" ], "parameters": [ { "$ref": "#/components/parameters/logoTypeParam" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/custom-pages/homepage/instance": { "get": { "summary": "Get instance custom homepage", "tags": [ "Homepage" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomHomepage" } } } }, "404": { "description": "No homepage set" } } }, "put": { "summary": "Set instance custom homepage", "tags": [ "Homepage" ], "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "content": { "type": "string", "description": "content of the homepage, that will be injected in the client" } } } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/jobs/pause": { "post": { "summary": "Pause job queue", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Job" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/jobs/resume": { "post": { "summary": "Resume job queue", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Job" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/jobs/{state}": { "get": { "summary": "List instance jobs", "operationId": "getJobs", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Job" ], "parameters": [ { "name": "state", "in": "path", "required": true, "description": "The state of the job ('' for for no filter)", "schema": { "type": "string", "enum": [ "", "active", "completed", "failed", "waiting", "delayed" ] } }, { "$ref": "#/components/parameters/jobType" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Job" } } } } } } } } } }, "/api/v1/server/followers": { "get": { "tags": [ "Instance Follows" ], "summary": "List instances following the server", "parameters": [ { "$ref": "#/components/parameters/followState" }, { "$ref": "#/components/parameters/actorType" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Follow" } } } } } } } } } }, "/api/v1/server/followers/{handle}": { "delete": { "summary": "Remove or reject a follower to your server", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Instance Follows" ], "parameters": [ { "name": "handle", "in": "path", "required": true, "description": "The remote actor handle to remove from your followers", "schema": { "type": "string", "format": "email" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "follower not found" } } } }, "/api/v1/server/followers/{handle}/reject": { "post": { "summary": "Reject a pending follower to your server", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Instance Follows" ], "parameters": [ { "name": "handle", "in": "path", "required": true, "description": "The remote actor handle to remove from your followers", "schema": { "type": "string", "format": "email" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "follower not found" } } } }, "/api/v1/server/followers/{handle}/accept": { "post": { "summary": "Accept a pending follower to your server", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Instance Follows" ], "parameters": [ { "name": "handle", "in": "path", "required": true, "description": "The remote actor handle to remove from your followers", "schema": { "type": "string", "format": "email" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "follower not found" } } } }, "/api/v1/server/following": { "get": { "tags": [ "Instance Follows" ], "summary": "List instances followed by the server", "parameters": [ { "$ref": "#/components/parameters/followState" }, { "$ref": "#/components/parameters/actorType" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Follow" } } } } } } } } }, "post": { "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Instance Follows" ], "summary": "Follow a list of actors (PeerTube instance, channel or account)", "responses": { "204": { "description": "successful operation" }, "500": { "description": "cannot follow a non-HTTPS server" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "hosts": { "type": "array", "items": { "type": "string", "format": "hostname" }, "uniqueItems": true }, "handles": { "type": "array", "items": { "type": "string" }, "uniqueItems": true } } } } } } } }, "/api/v1/server/following/{hostOrHandle}": { "delete": { "summary": "Unfollow an actor (PeerTube instance, channel or account)", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Instance Follows" ], "parameters": [ { "name": "hostOrHandle", "in": "path", "required": true, "description": "The hostOrHandle to unfollow", "schema": { "type": "string" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "host or handle not found" } } } }, "/api/v1/users": { "post": { "summary": "Create a user", "operationId": "addUser", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Users" ], "responses": { "200": { "description": "user created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddUserResponse" } } }, "links": { "GetUser": { "operationId": "getUser", "parameters": { "id": "$response.body#/user/id" } }, "PutUser": { "operationId": "putUser", "parameters": { "id": "$response.body#/user/id" } }, "DelUser": { "operationId": "delUser", "parameters": { "id": "$response.body#/user/id" } } } }, "403": { "description": "insufficient authority to create an admin or moderator" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddUser" } } }, "description": "If the smtp server is configured, you can leave the password empty and an email will be sent\nasking the user to set it first.\n", "required": true } }, "get": { "summary": "List users", "operationId": "getUsers", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/usersSearch" }, { "$ref": "#/components/parameters/usersBlocked" }, { "$ref": "#/components/parameters/usersRole" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/usersSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/User" } } } } } } } }, "/api/v1/users/{id}": { "parameters": [ { "$ref": "#/components/parameters/id" } ], "delete": { "summary": "Delete a user", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Users" ], "operationId": "delUser", "responses": { "204": { "description": "successful operation" } } }, "get": { "summary": "Get a user", "security": [ { "OAuth2": [] } ], "tags": [ "Users" ], "operationId": "getUser", "parameters": [ { "name": "withStats", "in": "query", "description": "include statistics about the user (only available as a moderator/admin)", "schema": { "type": "boolean" } } ], "responses": { "200": { "x-summary": "successful operation", "description": "As an admin/moderator, you can request a response augmented with statistics about the user's\nmoderation relations and videos usage, by using the `withStats` parameter.\n", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/User" }, { "$ref": "#/components/schemas/UserWithStats" } ] } } } } } }, "put": { "summary": "Update a user", "security": [ { "OAuth2": [] } ], "tags": [ "Users" ], "operationId": "putUser", "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateUser" } } }, "required": true } } }, "/api/v1/users/{id}/block": { "post": { "summary": "Block a user", "description": "Prevent a user from logging in and interacting with the instance", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "type": "string", "description": "Optional reason for blocking the user", "minLength": 0, "maxLength": 500 } } } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "invalid user id" }, "403": { "description": "insufficient permissions to block users" }, "404": { "description": "user not found" } } } }, "/api/v1/users/{id}/unblock": { "post": { "summary": "Unblock a user", "description": "Allow a previously blocked user to login and interact with the instance", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "invalid user id" }, "403": { "description": "insufficient permissions to unblock users" }, "404": { "description": "user not found" } } } }, "/api/v1/oauth-clients/local": { "get": { "summary": "Login prerequisite", "description": "You need to retrieve a client id and secret before [logging in](#operation/getOAuthToken).", "operationId": "getOAuthClient", "tags": [ "Session" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthClient" } } }, "links": { "UseOAuthClientToLogin": { "operationId": "getOAuthToken", "parameters": { "client_id": "$response.body#/client_id", "client_secret": "$response.body#/client_secret" } } } } }, "x-codeSamples": [ { "lang": "Shell", "source": "API=\"https://peertube2.cpy.re/api/v1\"\n\n## AUTH\ncurl -s \"$API/oauth-clients/local\"\n" } ] } }, "/api/v1/users/token": { "post": { "summary": "Login", "operationId": "getOAuthToken", "description": "With your [client id and secret](#operation/getOAuthClient), you can retrieve an access and refresh tokens.", "tags": [ "Session" ], "parameters": [ { "name": "x-peertube-otp", "in": "header", "schema": { "type": "string" }, "required": false, "description": "If the user enabled two factor authentication, you need to provide the OTP code in this header" } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/OAuthToken-password" }, { "$ref": "#/components/schemas/OAuthToken-refresh_token" } ], "discriminator": { "propertyName": "grant_type", "mapping": { "password": "#/components/schemas/OAuthToken-password", "refresh_token": "#/components/schemas/OAuthToken-refresh_token" } } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "token_type": { "type": "string", "example": "Bearer" }, "access_token": { "type": "string", "example": "90286a0bdf0f7315d9d3fe8dabf9e1d2be9c97d0", "description": "valid for 1 day" }, "refresh_token": { "type": "string", "example": "2e0d675df9fc96d2e4ec8a3ebbbf45eca9137bb7", "description": "valid for 2 weeks" }, "expires_in": { "type": "integer", "minimum": 0, "example": 14399 }, "refresh_token_expires_in": { "type": "integer", "minimum": 0, "example": 1209600 } } } } } }, "400": { "x-summary": "client or credentials are invalid", "description": "Disambiguate via `code`:\n- `invalid_client` for an unmatched `client_id`\n- `invalid_grant` for unmatched credentials\n" }, "401": { "x-summary": "token expired or two factor header is missing", "description": "Disambiguate via `code`:\n- default value for a regular authentication failure\n- `invalid_token` for an expired token\n- `missing_two_factor` if two factor header is missing\n" } }, "x-codeSamples": [ { "lang": "Shell", "source": "## DEPENDENCIES: jq\nAPI=\"https://peertube2.cpy.re/api/v1\"\nUSERNAME=\"\"\nPASSWORD=\"\"\n\n## AUTH\nclient_id=$(curl -s \"$API/oauth-clients/local\" | jq -r \".client_id\")\nclient_secret=$(curl -s \"$API/oauth-clients/local\" | jq -r \".client_secret\")\ncurl -s \"$API/users/token\" \\\n --data client_id=\"$client_id\" \\\n --data client_secret=\"$client_secret\" \\\n --data grant_type=password \\\n --data username=\"$USERNAME\" \\\n --data-urlencode password=\"$PASSWORD\" \\\n | jq -r \".access_token\"\n" } ] } }, "/api/v1/users/revoke-token": { "post": { "summary": "Logout", "description": "Revokes your access token and its associated refresh token, destroying your current session.", "operationId": "revokeOAuthToken", "tags": [ "Session" ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation" } } } }, "/api/v1/users/{id}/token-sessions": { "get": { "summary": "List token sessions", "parameters": [ { "$ref": "#/components/parameters/id" } ], "tags": [ "Session" ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TokenSession" } } } } } } } } } }, "/api/v1/users/{id}/token-sessions/{tokenSessionId}/revoke": { "get": { "summary": "List token sessions", "parameters": [ { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/tokenSessionId" } ], "tags": [ "Session" ], "security": [ { "OAuth2": [] } ], "responses": { "200": { "description": "successful operation" } } } }, "/api/v1/users/ask-send-verify-email": { "post": { "summary": "Resend user verification link", "operationId": "resendEmailToVerifyUser", "tags": [ "Users", "Register" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "User email" } }, "required": [ "email" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/registrations/ask-send-verify-email": { "post": { "summary": "Resend verification link to registration request email", "operationId": "resendEmailToVerifyRegistration", "tags": [ "Register" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Registration email" } }, "required": [ "email" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/{id}/verify-email": { "post": { "summary": "Verify a user", "operationId": "verifyUser", "description": "Following a user registration, the new user will receive an email asking to click a link\ncontaining a secret.\nThis endpoint can also be used to verify a new email set in the user account.\n", "tags": [ "Users", "Register" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "verificationString": { "type": "string", "format": "url" }, "isPendingEmail": { "type": "boolean" } }, "required": [ "verificationString" ] } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "invalid verification string" }, "404": { "description": "user not found" } } } }, "/api/v1/users/registrations/{registrationId}/verify-email": { "post": { "summary": "Verify a registration email", "operationId": "verifyRegistrationEmail", "description": "Following a user registration request, the user will receive an email asking to click a link\ncontaining a secret.\n", "tags": [ "Register" ], "parameters": [ { "$ref": "#/components/parameters/registrationId" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "verificationString": { "type": "string", "format": "url" } }, "required": [ "verificationString" ] } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "invalid verification string" }, "404": { "description": "registration not found" } } } }, "/api/v1/users/ask-reset-password": { "post": { "summary": "Ask to reset password", "description": "An email containing a reset password link", "tags": [ "Users" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "User email" } }, "required": [ "email" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/{id}/reset-password": { "post": { "summary": "Reset password", "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "verificationString": { "type": "string", "format": "url" }, "password": { "type": "string" } }, "required": [ "verificationString", "password" ] } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "invalid verification string" }, "404": { "description": "user not found" } } } }, "/api/v1/users/{id}/two-factor/request": { "post": { "summary": "Request two factor auth", "operationId": "requestTwoFactor", "description": "Request two factor authentication for a user", "security": [ { "OAuth2": [] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "currentPassword": { "type": "string", "description": "Password of the currently authenticated user" } } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RequestTwoFactorResponse" } } } } }, "403": { "description": "invalid password" }, "404": { "description": "user not found" } } } }, "/api/v1/users/{id}/two-factor/confirm-request": { "post": { "summary": "Confirm two factor auth", "operationId": "confirmTwoFactorRequest", "description": "Confirm a two factor authentication request", "security": [ { "OAuth2": [] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "requestToken": { "type": "string", "description": "Token to identify the two factor request" }, "otpToken": { "type": "string", "description": "OTP token generated by the app" } }, "required": [ "requestToken", "otpToken" ] } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "invalid request token or OTP token" }, "404": { "description": "user not found" } } } }, "/api/v1/users/{id}/two-factor/disable": { "post": { "summary": "Disable two factor auth", "operationId": "disableTwoFactor", "description": "Disable two factor authentication of a user", "security": [ { "OAuth2": [] } ], "tags": [ "Users" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "currentPassword": { "type": "string", "description": "Password of the currently authenticated user" } } } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "invalid password" }, "404": { "description": "user not found" } } } }, "/api/v1/users/{userId}/imports/import-resumable": { "post": { "summary": "Initialize the resumable user import", "description": "**PeerTube >= 6.1** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to initialize the import of the archive", "operationId": "userImportResumableInit", "security": [ { "OAuth2": [] } ], "tags": [ "User Imports" ], "parameters": [ { "$ref": "#/components/parameters/userId" }, { "$ref": "#/components/parameters/resumableUploadInitContentLengthHeader" }, { "$ref": "#/components/parameters/resumableUploadInitContentTypeHeader" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserImportResumable" } } } }, "responses": { "201": { "description": "created", "headers": { "Location": { "schema": { "type": "string", "format": "url" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } } } }, "put": { "summary": "Send chunk for the resumable user import", "description": "**PeerTube >= 6.1** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to continue, pause or resume the import of the archive", "operationId": "userImportResumable", "security": [ { "OAuth2": [] } ], "tags": [ "User Imports" ], "parameters": [ { "$ref": "#/components/parameters/userId" }, { "$ref": "#/components/parameters/resumableUploadId" }, { "$ref": "#/components/parameters/resumableUploadChunkContentRangeHeader" }, { "$ref": "#/components/parameters/resumableUploadChunkContentLengthHeader" } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "204": { "description": "last chunk received: successful operation" }, "308": { "description": "resume incomplete", "headers": { "Range": { "schema": { "type": "string", "example": "bytes=0-262143" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } } } }, "delete": { "summary": "Cancel the resumable user import", "description": "**PeerTube >= 6.1** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to cancel the resumable user import", "operationId": "userImportResumableCancel", "security": [ { "OAuth2": [] } ], "tags": [ "User Imports" ], "parameters": [ { "$ref": "#/components/parameters/userId" }, { "$ref": "#/components/parameters/resumableUploadId" }, { "name": "Content-Length", "in": "header", "required": true, "schema": { "type": "number", "example": 0 } } ], "responses": { "204": { "description": "import cancelled", "headers": { "Content-Length": { "schema": { "type": "number", "example": 0 } } } } } } }, "/api/v1/users/{userId}/imports/latest": { "get": { "summary": "Get latest user import", "description": "**PeerTube >= 6.1**", "operationId": "getLatestUserImport", "security": [ { "OAuth2": [] } ], "tags": [ "User Imports" ], "parameters": [ { "$ref": "#/components/parameters/userId" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserImportState" }, "label": { "type": "string" } } }, "createdAt": { "type": "string", "format": "date-time" } } } } } } } } }, "/api/v1/users/{userId}/exports/request": { "post": { "summary": "Request user export", "operationId": "requestUserExport", "description": "Request an archive of user data. An email is sent when the archive is ready.", "security": [ { "OAuth2": [] } ], "tags": [ "User Exports" ], "parameters": [ { "$ref": "#/components/parameters/userId" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "withVideoFiles": { "type": "boolean", "description": "Whether to include video files in the archive" } } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "export": { "type": "object", "properties": { "id": { "type": "integer" } } } } } } } } } } }, "/api/v1/users/{userId}/exports": { "get": { "summary": "List user exports", "description": "**PeerTube >= 6.1**", "operationId": "listUserExports", "security": [ { "OAuth2": [] } ], "tags": [ "User Exports" ], "parameters": [ { "$ref": "#/components/parameters/userId" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserExportState" }, "label": { "type": "string" } } }, "size": { "type": "integer", "description": "Size of the archive file in bytes" }, "privateDownloadUrl": { "type": "string", "description": "This URL already contains the JWT token, so no additional authentication credentials are required" }, "createdAt": { "type": "string", "format": "date-time" }, "expiresOn": { "type": "string", "format": "date-time" } } } } } } } } }, "/api/v1/users/{userId}/exports/{id}": { "delete": { "summary": "Delete a user export", "description": "**PeerTube >= 6.1**", "operationId": "deleteUserExport", "security": [ { "OAuth2": [] } ], "tags": [ "User Exports" ], "parameters": [ { "$ref": "#/components/parameters/userId" }, { "$ref": "#/components/parameters/id" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me": { "get": { "summary": "Get my user information", "operationId": "getUserInfo", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My User" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/User" } } } } } } }, "put": { "summary": "Update my user information", "operationId": "putUserInfo", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My User" ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMe" } } }, "required": true } }, "delete": { "summary": "Delete my account", "operationId": "deleteMe", "description": "Delete the authenticated user's account and all associated data", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My User" ], "responses": { "204": { "description": "successful operation - account deleted" }, "400": { "description": "invalid request parameters" }, "401": { "description": "authentication required" } } } }, "/api/v1/users/me/videos/comments": { "get": { "summary": "List comments on user's videos", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/searchAccountForComments" }, { "$ref": "#/components/parameters/searchVideoForComments" }, { "$ref": "#/components/parameters/videoId" }, { "$ref": "#/components/parameters/videoChannelId" }, { "$ref": "#/components/parameters/autoTagOneOfComment" }, { "$ref": "#/components/parameters/isHeldForReview" }, { "$ref": "#/components/parameters/includeCollaborations" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoCommentForOwnerOrAdmin" } } } } } } } } } }, "/api/v1/users/me/videos/imports": { "get": { "summary": "Get video imports of my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Videos", "My User" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/includeCollaborations" }, { "name": "videoId", "in": "query", "required": false, "description": "Filter on import video ID", "schema": { "type": "integer" } }, { "name": "targetUrl", "in": "query", "required": false, "description": "Filter on import target URL", "schema": { "type": "string" } }, { "name": "videoChannelSyncId", "in": "query", "required": false, "description": "Filter on imports created by a specific channel synchronization", "schema": { "type": "number" } }, { "name": "search", "in": "query", "required": false, "description": "Search in video names", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoImportsList" } } } } } } }, "/api/v1/users/me/video-quota-used": { "get": { "summary": "Get my user used quota", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My User" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoQuotaUsed": { "type": "number", "description": "The user video quota used so far in bytes", "example": 16810141515 }, "videoQuotaUsedDaily": { "type": "number", "description": "The user video quota used today in bytes", "example": 1681014151 } } } } } } } } }, "/api/v1/users/me/videos/{videoIdOrUUID}/rating": { "get": { "summary": "Get rate of my user for a video", "security": [ { "OAuth2": [] } ], "tags": [ "My User", "Video Rates" ], "parameters": [ { "$ref": "#/components/parameters/videoIdOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMeVideoRating" } } } } } } }, "/api/v1/users/me/videos": { "get": { "summary": "List videos of my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My User", "Videos" ], "parameters": [ { "$ref": "#/components/parameters/channelNameOneOf" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/includeCollaborations" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } } } }, "/api/v1/users/me/subscriptions": { "get": { "summary": "List my user subscriptions", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My Subscriptions" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/mySubscriptionSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelList" } } } } } }, "post": { "tags": [ "My Subscriptions" ], "summary": "Add subscription to my user", "security": [ { "OAuth2": [ "user" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri", "description": "uri of the video channels to subscribe to" } }, "required": [ "uri" ] }, "examples": { "default": { "value": { "uri": "008a0e54-375d-49d0-8379-143202e24152@video.lqdn.fr" } } } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/subscriptions/exist": { "get": { "summary": "Get if subscriptions exist for my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My Subscriptions" ], "parameters": [ { "$ref": "#/components/parameters/subscriptionsUris" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/users/me/subscriptions/videos": { "get": { "summary": "List videos of subscriptions of my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My Subscriptions", "Videos" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } } } }, "/api/v1/users/me/subscriptions/{subscriptionHandle}": { "get": { "summary": "Get subscription of my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My Subscriptions" ], "parameters": [ { "$ref": "#/components/parameters/subscriptionHandle" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannel" } } } } } }, "delete": { "summary": "Delete subscription of my user", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "My Subscriptions" ], "parameters": [ { "$ref": "#/components/parameters/subscriptionHandle" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/notifications": { "get": { "summary": "List my notifications", "security": [ { "OAuth2": [] } ], "tags": [ "My Notifications" ], "parameters": [ { "name": "typeOneOf", "in": "query", "description": "only list notifications of these types", "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NotificationType" } } }, { "name": "unread", "in": "query", "description": "only list unread notifications", "schema": { "type": "boolean" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationListResponse" } } } } } } }, "/api/v1/users/me/notifications/read": { "post": { "summary": "Mark notifications as read by their id", "security": [ { "OAuth2": [] } ], "tags": [ "My Notifications" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "description": "ids of the notifications to mark as read", "items": { "type": "integer" } } }, "required": [ "ids" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/notifications/read-all": { "post": { "summary": "Mark all my notification as read", "security": [ { "OAuth2": [] } ], "tags": [ "My Notifications" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/notification-settings": { "put": { "summary": "Update my notification settings", "security": [ { "OAuth2": [] } ], "tags": [ "My Notifications" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserNotificationSettings" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/new-feature-info/read": { "post": { "tags": [ "My User" ], "summary": "Mark feature info as read", "description": "**PeerTube >= v8.0.0", "security": [ { "OAuth2": [ "user" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "feature": { "$ref": "#/components/schemas/NewFeatureInfoType" } }, "required": [ "feature" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/history/videos": { "get": { "summary": "List watched videos history", "security": [ { "OAuth2": [] } ], "tags": [ "My History" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } } } }, "/api/v1/users/me/history/videos/{videoIdOrUUID}": { "delete": { "summary": "Delete history element", "security": [ { "OAuth2": [] } ], "tags": [ "My History" ], "parameters": [ { "$ref": "#/components/parameters/videoIdOrUUID" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/history/videos/remove": { "post": { "summary": "Clear video history", "security": [ { "OAuth2": [] } ], "tags": [ "My History" ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "beforeDate": { "description": "history before this date will be deleted", "type": "string", "format": "date-time" } } } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/avatar/pick": { "post": { "summary": "Update my user avatar", "security": [ { "OAuth2": [] } ], "tags": [ "My User" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } } } } }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the avatar" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "avatarfile": { "description": "The file to upload", "type": "string", "format": "binary" } } }, "encoding": { "avatarfile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/users/me/avatar": { "delete": { "summary": "Delete my avatar", "security": [ { "OAuth2": [] } ], "tags": [ "My User" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/register": { "post": { "summary": "Register a user", "operationId": "registerUser", "description": "Signup has to be enabled and signup approval is not required", "tags": [ "Register" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserRegistrationState" }, "label": { "type": "string" } } } } } } } }, "400": { "description": "request error" }, "403": { "description": "user registration is not enabled, user limit is reached, registration is not allowed for the ip, requires approval or blocked by a plugin" }, "409": { "description": "a user with this username, channel name or email already exists" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegisterUser" } } }, "required": true } } }, "/api/v1/users/registrations/request": { "post": { "summary": "Request registration", "description": "Signup has to be enabled and require approval on the instance", "operationId": "requestRegistration", "tags": [ "Register" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserRegistrationState" }, "label": { "type": "string" } } } } } } } }, "400": { "description": "request error or signup approval is not enabled on the instance" }, "403": { "description": "user registration is not enabled, user limit is reached, registration is not allowed for the ip or blocked by a plugin" }, "409": { "description": "a user or registration with this username, channel name or email already exists" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserRegistrationRequest" } } } } } }, "/api/v1/users/registrations/{registrationId}/accept": { "post": { "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "summary": "Accept registration", "operationId": "acceptRegistration", "tags": [ "Register" ], "parameters": [ { "$ref": "#/components/parameters/registrationId" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserRegistrationAcceptOrReject" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/registrations/{registrationId}/reject": { "post": { "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "summary": "Reject registration", "operationId": "rejectRegistration", "tags": [ "Register" ], "parameters": [ { "$ref": "#/components/parameters/registrationId" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserRegistrationAcceptOrReject" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/registrations/{registrationId}": { "delete": { "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "summary": "Delete registration", "description": "Delete the registration entry. It will not remove the user associated with this registration (if any)", "operationId": "deleteRegistration", "tags": [ "Register" ], "parameters": [ { "$ref": "#/components/parameters/registrationId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/registrations": { "get": { "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "summary": "List registrations", "operationId": "listRegistrations", "tags": [ "Register" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-createdAt", "createdAt", "state", "-state" ] } }, { "name": "stateOneOf", "in": "query", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserRegistrationState" } } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/UserRegistration" } } } } } } } } } }, "/api/v1/videos/ownership": { "get": { "summary": "List video ownership changes", "description": "List ownership change requests received by the authenticated user and requests sent by a channel managed by the authenticated user", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-createdAt", "createdAt" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeOwnership" } } } } } } }, "401": { "description": "authentication required" } } } }, "/api/v1/videos/ownership/{id}/accept": { "post": { "summary": "Accept ownership change request", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channelId": { "type": "integer", "description": "Target channel id owned by the authenticated user" } }, "required": [ "channelId" ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership change request already accepted/refused or invalid target channel id" }, "403": { "description": "cannot terminate an ownership change of another user" }, "404": { "description": "video ownership change not found" }, "413": { "description": "quota exceeded for the target account/channel" } } } }, "/api/v1/videos/ownership/{id}/refuse": { "post": { "summary": "Refuse ownership change request", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership change request already accepted/refused" }, "403": { "description": "cannot terminate an ownership change of another user" }, "404": { "description": "video ownership change not found" } } } }, "/api/v1/videos/ownership/{id}": { "delete": { "summary": "Delete ownership change request", "description": "Delete an ownership change request. Only users who can manage the video can delete the request.", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership request already accepted or refused" }, "403": { "description": "only users who can manage the video can delete an ownership change request" }, "404": { "description": "video ownership change not found" } } } }, "/api/v1/videos/{videoIdOrUUID}/ownership": { "get": { "summary": "List ownership change requests for a video", "description": "List all ownership change requests for a specific video. The authenticated user must be able to manage the video.", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/videoIdOrUUID" }, { "name": "state", "in": "query", "required": false, "description": "Filter by ownership change state", "schema": { "$ref": "#/components/schemas/ChangeOwnershipState" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-createdAt", "createdAt" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeOwnership" } } } } } } }, "403": { "description": "cannot manage the video" }, "404": { "description": "video not found" } } } }, "/api/v1/videos/{videoIdOrUUID}/give-ownership": { "post": { "summary": "Request ownership change", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/videoIdOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" } }, "required": [ "username" ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "changing video ownership to a remote account is not supported yet or there is already a pending ownership request" }, "403": { "description": "cannot change ownership of this video" }, "404": { "description": "video not found" } } } }, "/api/v1/video-channels/ownership": { "get": { "summary": "List channel ownership changes", "description": "List ownership change requests received by the authenticated user and requests sent by channels managed by the authenticated user", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-createdAt", "createdAt" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeOwnership" } } } } } } }, "401": { "description": "authentication required" } } } }, "/api/v1/video-channels/ownership/{id}/accept": { "post": { "summary": "Accept channel ownership change request", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership change request already accepted/refused or request type mismatch" }, "403": { "description": "cannot terminate an ownership change of another user" }, "404": { "description": "channel ownership change not found" }, "409": { "description": "cannot accept transferring the last channel of the initiator account" }, "413": { "description": "quota exceeded for the target account" } } } }, "/api/v1/video-channels/ownership/{id}/refuse": { "post": { "summary": "Refuse channel ownership change request", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership change request already accepted/refused or request type mismatch" }, "403": { "description": "cannot terminate an ownership change of another user" }, "404": { "description": "channel ownership change not found" } } } }, "/api/v1/video-channels/ownership/{id}": { "delete": { "summary": "Delete channel ownership change request", "description": "Delete a channel ownership change request. Only channel owners can delete the request.", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "ownership request already accepted/refused or request type mismatch" }, "403": { "description": "only channel owners can delete a channel ownership change request" }, "404": { "description": "channel ownership change not found" } } } }, "/api/v1/video-channels/{channelHandle}/ownership": { "get": { "summary": "List ownership change requests for a channel", "description": "List all ownership change requests for a specific channel. The authenticated user must be able to manage the channel.", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "name": "state", "in": "query", "required": false, "description": "Filter by ownership change state", "schema": { "$ref": "#/components/schemas/ChangeOwnershipState" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-createdAt", "createdAt" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeOwnership" } } } } } } }, "400": { "description": "invalid parameters" }, "403": { "description": "cannot manage the channel" }, "404": { "description": "channel not found" } } } }, "/api/v1/video-channels/{channelHandle}/give-ownership": { "post": { "summary": "Request channel ownership change", "tags": [ "Ownership Change" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" } }, "required": [ "username" ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "changing channel ownership to this target is invalid or there is already a pending ownership request" }, "403": { "description": "cannot change ownership of this channel" }, "404": { "description": "channel not found" } } } }, "/api/v1/videos/{id}/token": { "post": { "summary": "Request video token", "operationId": "requestVideoToken", "description": "Request special tokens that expire quickly to use them in some context (like accessing private static files)", "tags": [ "Video" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoTokenResponse" } } } }, "400": { "description": "incorrect parameters" }, "404": { "description": "video not found" } } } }, "/api/v1/videos/{id}/studio/edit": { "post": { "summary": "Create a studio task", "tags": [ "Video Transcoding", "Video" ], "description": "Create a task to edit a video (cut, add intro/outro etc)", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VideoStudioCreateTask" } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "incorrect parameters" }, "404": { "description": "video not found" } } } }, "/api/v1/videos": { "get": { "summary": "List videos", "operationId": "getVideos", "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } } } }, "/api/v1/videos/categories": { "get": { "summary": "List available video categories", "operationId": "getCategories", "tags": [ "Video" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "examples": { "nightly": { "value": { "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" } } } } } } } } }, "/api/v1/videos/licences": { "get": { "summary": "List available video licences", "operationId": "getLicences", "tags": [ "Video" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "examples": { "nightly": { "value": { "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" } } } } } } } } }, "/api/v1/videos/languages": { "get": { "summary": "List available video languages", "operationId": "getLanguages", "tags": [ "Video" ], "parameters": [ { "name": "scope", "in": "query", "description": "**PeerTube >= 8.2** Filter languages by scope. Use `subtitle` to exclude sign languages and other languages that don't make sense for subtitles.", "required": false, "schema": { "type": "string", "enum": [ "subtitle" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "examples": { "nightly": { "value": { "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 (Brazilian)", "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-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" } } } } } } } } }, "/api/v1/videos/privacies": { "get": { "summary": "List available video privacy policies", "operationId": "getVideoPrivacyPolicies", "tags": [ "Video" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "examples": { "nightly": { "value": { "1": "Public", "2": "Unlisted", "3": "Private", "4": "Internal", "5": "Password protected" } } } } } } } } }, "/api/v1/videos/{id}": { "put": { "summary": "Update a video", "operationId": "putVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "channelId": { "type": "integer", "description": "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." }, "thumbnailfile": { "description": "Video thumbnail file", "type": "string", "format": "binary" }, "previewfile": { "description": "Deprecated in PeerTube v8.1, use thumbnailfile instead", "deprecated": true, "type": "string", "format": "binary" }, "category": { "$ref": "#/components/schemas/VideoCategorySet" }, "licence": { "$ref": "#/components/schemas/VideoLicenceSet" }, "language": { "$ref": "#/components/schemas/VideoLanguageSet" }, "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" }, "description": { "description": "Video description", "type": "string" }, "waitTranscoding": { "description": "Whether or not we wait transcoding before publish the video", "type": "string" }, "support": { "description": "A text tell the audience how to support the video creator", "example": "Please support our work on https://soutenir.framasoft.org/en/ <3", "type": "string" }, "nsfw": { "description": "Whether or not this video contains sensitive content", "type": "boolean" }, "nsfwSummary": { "description": "More information about the sensitive content of the video" }, "nsfwFlags": { "$ref": "#/components/schemas/NSFWFlag" }, "name": { "description": "Video name", "type": "string", "minLength": 3, "maxLength": 120 }, "tags": { "description": "Video tags (maximum 5 tags each between 2 and 30 characters)", "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "string", "minLength": 2, "maxLength": 30 } }, "commentsPolicy": { "$ref": "#/components/schemas/VideoCommentsPolicySet" }, "downloadEnabled": { "description": "Enable or disable downloading for this video", "type": "boolean" }, "originallyPublishedAt": { "description": "Date when the content was originally published", "type": "string", "format": "date-time", "nullable": true }, "scheduleUpdate": { "$ref": "#/components/schemas/VideoScheduledUpdate" }, "videoPasswords": { "$ref": "#/components/schemas/AddVideoPasswords" } } }, "encoding": { "thumbnailfile": { "contentType": "image/jpeg" }, "previewfile": { "contentType": "image/jpeg" }, "tags": { "style": "form", "explode": true } } } } } }, "get": { "summary": "Get a video", "operationId": "getVideo", "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoDetails" } } } }, "401": { "description": "Requires authentication or the video requires a password", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerError" } } } }, "403": { "description": "Invalid authentication or the video requires a password", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerError" } } } } } }, "delete": { "summary": "Delete a video", "operationId": "delVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/{id}/views": { "post": { "summary": "Notify user is watching a video", "description": "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.", "operationId": "addView", "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserViewingVideo" } } }, "required": true }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/{id}/stats/overall": { "get": { "summary": "Get overall stats of a video", "tags": [ "Video Stats" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "name": "startDate", "in": "query", "description": "Filter stats by start date", "schema": { "type": "string", "format": "date-time" } }, { "name": "endDate", "in": "query", "description": "Filter stats by end date", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoStatsOverall" } } } } } } }, "/api/v1/videos/{id}/stats/user-agent": { "get": { "summary": "Get user agent stats of a video", "tags": [ "Video Stats" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "name": "startDate", "in": "query", "description": "Filter stats by start date", "schema": { "type": "string", "format": "date-time" } }, { "name": "endDate", "in": "query", "description": "Filter stats by end date", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoStatsUserAgent" } } } } } } }, "/api/v1/videos/{id}/stats/retention": { "get": { "summary": "Get retention stats of a video", "tags": [ "Video Stats" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoStatsRetention" } } } } } } }, "/api/v1/videos/{id}/stats/timeseries/{metric}": { "get": { "summary": "Get timeserie stats of a video", "tags": [ "Video Stats" ], "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "name": "metric", "in": "path", "required": true, "description": "The metric to get", "schema": { "type": "string", "enum": [ "viewers", "aggregateWatchTime" ] } }, { "name": "startDate", "in": "query", "description": "Filter stats by start date", "schema": { "type": "string", "format": "date-time" } }, { "name": "endDate", "in": "query", "description": "Filter stats by end date", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoStatsTimeserie" } } } } } } }, "/api/v1/videos/upload": { "post": { "summary": "Upload a video", "description": "Uses a single request to upload a video.", "operationId": "uploadLegacy", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoUploadResponse" } } } }, "403": { "description": "video didn't pass upload filter" }, "408": { "description": "upload has timed out" }, "413": { "x-summary": "video file too large, due to quota or max body size limit set by the reverse-proxy", "description": "If the response has no body, it means the reverse-proxy didn't let it through. Otherwise disambiguate via `code`:\n- `quota_reached` for quota limits whether daily or global\n", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the video" } } }, "415": { "description": "video type unsupported" }, "422": { "description": "video unreadable" } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VideoUploadRequestLegacy" }, "encoding": { "videofile": { "contentType": "video/mp4, video/webm, video/ogg, video/avi, video/quicktime, video/x-msvideo, video/x-flv, video/x-matroska, application/octet-stream" }, "thumbnailfile": { "contentType": "image/jpeg" }, "previewfile": { "contentType": "image/jpeg" } } } } }, "x-codeSamples": [ { "lang": "Shell", "source": "## DEPENDENCIES: jq\nUSERNAME=\"\"\nPASSWORD=\"\"\nFILE_PATH=\"\"\nCHANNEL_ID=\"\"\nNAME=\"\"\nAPI=\"https://peertube2.cpy.re/api/v1\"\n\n## AUTH\nclient_id=$(curl -s \"$API/oauth-clients/local\" | jq -r \".client_id\")\nclient_secret=$(curl -s \"$API/oauth-clients/local\" | jq -r \".client_secret\")\ntoken=$(curl -s \"$API/users/token\" \\\n --data client_id=\"$client_id\" \\\n --data client_secret=\"$client_secret\" \\\n --data grant_type=password \\\n --data username=\"$USERNAME\" \\\n --data password=\"$PASSWORD\" \\\n | jq -r \".access_token\")\n\n## VIDEO UPLOAD\ncurl -s \"$API/videos/upload\" \\\n -H \"Authorization: Bearer $token\" \\\n --max-time 600 \\\n --form videofile=@\"$FILE_PATH\" \\\n --form channelId=$CHANNEL_ID \\\n --form name=\"$NAME\"\n" } ] } }, "/api/v1/videos/upload-resumable": { "post": { "summary": "Initialize the resumable upload of a video", "description": "Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to initialize the upload of a video", "operationId": "uploadResumableInit", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/resumableUploadInitContentLengthHeader" }, { "$ref": "#/components/parameters/resumableUploadInitContentTypeHeader" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoUploadRequestResumable" } } } }, "responses": { "200": { "description": "file already exists, send a [`resume`](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) request instead" }, "201": { "description": "created", "headers": { "Location": { "schema": { "type": "string", "format": "url", "example": "/api/v1/videos/upload-resumable?upload_id=471e97554f21dec3b8bb5d4602939c51" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "413": { "x-summary": "video file too large, due to quota, absolute max file size or concurrent partial upload limit", "description": "Disambiguate via `code`:\n- `max_file_size_reached` for the absolute file size limit\n- `quota_reached` for quota limits whether daily or global\n" }, "415": { "description": "video type unsupported" } } }, "put": { "summary": "Send chunk for the resumable upload of a video", "description": "Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to continue, pause or resume the upload of a video", "operationId": "uploadResumable", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/resumableUploadId" }, { "$ref": "#/components/parameters/resumableUploadChunkContentRangeHeader" }, { "$ref": "#/components/parameters/resumableUploadChunkContentLengthHeader" } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "200": { "description": "last chunk received", "headers": { "Content-Length": { "schema": { "type": "number" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoUploadResponse" } } } }, "308": { "description": "resume incomplete", "headers": { "Range": { "schema": { "type": "string", "example": "bytes=0-262143" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "403": { "description": "video didn't pass upload filter" }, "404": { "description": "upload not found" }, "409": { "description": "chunk doesn't match range" }, "422": { "description": "video unreadable" }, "429": { "description": "too many concurrent requests" }, "503": { "description": "upload is already being processed", "headers": { "Retry-After": { "schema": { "type": "number", "example": 300 } } } } } }, "delete": { "summary": "Cancel the resumable upload of a video, deleting any data uploaded so far", "description": "Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to cancel the upload of a video", "operationId": "uploadResumableCancel", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/resumableUploadId" }, { "name": "Content-Length", "in": "header", "required": true, "schema": { "type": "number", "example": 0 } } ], "responses": { "204": { "description": "upload cancelled", "headers": { "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "404": { "description": "upload not found" } } } }, "/api/v1/videos/imports": { "post": { "summary": "Import a video", "description": "Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)", "operationId": "importVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Video Imports", "Video Upload" ], "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VideoCreateImport" }, "encoding": { "torrentfile": { "contentType": "application/x-bittorrent" }, "thumbnailfile": { "contentType": "image/jpeg" }, "previewfile": { "contentType": "image/jpeg" } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoUploadResponse" } } } }, "400": { "description": "`magnetUri` or `targetUrl` or a torrent file missing" }, "403": { "description": "video didn't pass pre-import filter" }, "409": { "description": "HTTP or Torrent/magnetURI import not enabled" } } } }, "/api/v1/videos/imports/{id}/cancel": { "post": { "summary": "Cancel video import", "description": "Cancel a pending video import", "security": [ { "OAuth2": [] } ], "tags": [ "Video Imports" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/imports/{id}/retry": { "post": { "summary": "Retry video import", "description": "**PeerTube >= 8.0** Retry a pending video import", "security": [ { "OAuth2": [] } ], "tags": [ "Video Imports" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/imports/{id}": { "delete": { "summary": "Delete video import", "description": "Delete ended video import", "security": [ { "OAuth2": [] } ], "tags": [ "Video Imports" ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/live": { "post": { "summary": "Create a live", "operationId": "addLive", "security": [ { "OAuth2": [] } ], "tags": [ "Live Videos", "Video" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoUploadResponse" } } } }, "400": { "x-summary": "validation error, or conflicting `saveReplay` and `permanentLive` parameter set", "description": "Disambiguate via `code`:\n- default type for a validation error\n- `live_conflicting_permanent_and_save_replay` for conflicting parameters set\n" }, "403": { "x-summary": "live is not enabled, allow replay is not enabled, or max instance/user live videos limit is exceeded", "description": "Disambiguate via `code`:\n- `live_not_enabled` for a disabled live feature\n- `live_not_allowing_replay` for a disabled replay feature\n- `max_instance_lives_limit_reached` for the absolute concurrent live limit\n- `max_user_lives_limit_reached` for the user concurrent live limit\n" } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "channelId": { "description": "Channel id that will contain this live video", "type": "integer" }, "saveReplay": { "type": "boolean" }, "replaySettings": { "$ref": "#/components/schemas/LiveVideoReplaySettings" }, "permanentLive": { "description": "User can stream multiple times in a permanent live", "type": "boolean" }, "latencyMode": { "description": "User can select live latency mode if enabled by the instance", "allOf": [ { "$ref": "#/components/schemas/LiveVideoLatencyMode" } ] }, "thumbnailfile": { "description": "Live video/replay thumbnail file", "type": "string", "format": "binary" }, "previewfile": { "description": "Deprecated in PeerTube v8.1, use thumbnailfile instead", "deprecated": true, "type": "string", "format": "binary" }, "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" }, "category": { "$ref": "#/components/schemas/VideoCategorySet" }, "licence": { "$ref": "#/components/schemas/VideoLicenceSet" }, "language": { "$ref": "#/components/schemas/VideoLanguageSet" }, "description": { "description": "Live video/replay description", "type": "string" }, "support": { "description": "A text tell the audience how to support the creator", "example": "Please support our work on https://soutenir.framasoft.org/en/ <3", "type": "string" }, "nsfw": { "description": "Whether or not this live video/replay contains sensitive content", "type": "boolean" }, "nsfwSummary": { "description": "More information about the sensitive content of the video" }, "nsfwFlags": { "$ref": "#/components/schemas/NSFWFlag" }, "name": { "description": "Live video/replay name", "type": "string", "minLength": 3, "maxLength": 120 }, "tags": { "description": "Live video/replay tags (maximum 5 tags each between 2 and 30 characters)", "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "string", "minLength": 2, "maxLength": 30 } }, "commentsPolicy": { "$ref": "#/components/schemas/VideoCommentsPolicySet" }, "downloadEnabled": { "description": "Enable or disable downloading for the replay of this live video", "type": "boolean" }, "schedules": { "type": "array", "items": { "$ref": "#/components/schemas/LiveSchedule" } } }, "required": [ "channelId", "name" ] }, "encoding": { "thumbnailfile": { "contentType": "image/jpeg" }, "previewfile": { "contentType": "image/jpeg" } } } } } } }, "/api/v1/videos/live/{id}": { "get": { "summary": "Get information about a live", "operationId": "getLiveId", "security": [ { "OAuth2": [] } ], "tags": [ "Live Videos", "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveVideoResponse" } } } } } }, "put": { "summary": "Update information about a live", "operationId": "updateLiveId", "security": [ { "OAuth2": [] } ], "tags": [ "Live Videos", "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveVideoUpdate" } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "bad parameters or trying to update a live that has already started" }, "403": { "description": "trying to save replay of the live but saving replay is not enabled on the instance" } } } }, "/api/v1/videos/live/{id}/sessions": { "get": { "summary": "List live sessions", "description": "List all sessions created in a particular live", "security": [ { "OAuth2": [] } ], "tags": [ "Live Videos" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LiveVideoSessionResponse" } } } } } } } } } }, "/api/v1/videos/{id}/live-session": { "get": { "summary": "Get live session of a replay", "description": "If the video is a replay of a live, you can find the associated live session using this endpoint", "security": [ { "OAuth2": [] } ], "tags": [ "Live Videos" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveVideoSessionResponse" } } } } } } }, "/api/v1/videos/{id}/source": { "get": { "summary": "Get video source file metadata", "description": "Get metadata and download link of original video file", "operationId": "getVideoSource", "security": [ { "OAuth2": [] } ], "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoSource" } } } } } } }, "/api/v1/videos/{id}/source/file": { "delete": { "summary": "Delete video source file", "operationId": "deleteVideoSourceFile", "tags": [ "Video" ], "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "video source not found" } } } }, "/api/v1/videos/{id}/source/replace-resumable": { "post": { "summary": "Initialize the resumable replacement of a video", "description": "**PeerTube >= 6.0** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to initialize the replacement of a video", "operationId": "replaceVideoSourceResumableInit", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/resumableUploadInitContentLengthHeader" }, { "$ref": "#/components/parameters/resumableUploadInitContentTypeHeader" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoReplaceSourceRequestResumable" } } } }, "responses": { "200": { "description": "file already exists, send a [`resume`](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) request instead" }, "201": { "description": "created", "headers": { "Location": { "schema": { "type": "string", "format": "url" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "413": { "x-summary": "video file too large, due to quota, absolute max file size or concurrent partial upload limit", "description": "Disambiguate via `code`:\n- `max_file_size_reached` for the absolute file size limit\n- `quota_reached` for quota limits whether daily or global\n" }, "415": { "description": "video type unsupported" } } }, "put": { "summary": "Send chunk for the resumable replacement of a video", "description": "**PeerTube >= 6.0** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to continue, pause or resume the replacement of a video", "operationId": "replaceVideoSourceResumable", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/resumableUploadId" }, { "$ref": "#/components/parameters/resumableUploadChunkContentRangeHeader" }, { "$ref": "#/components/parameters/resumableUploadChunkContentLengthHeader" } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "204": { "description": "last chunk received: successful operation" }, "308": { "description": "resume incomplete", "headers": { "Range": { "schema": { "type": "string", "example": "bytes=0-262143" } }, "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "403": { "description": "video didn't pass file replacement filter" }, "404": { "description": "replace upload not found" }, "409": { "description": "chunk doesn't match range" }, "422": { "description": "video unreadable" }, "429": { "description": "too many concurrent requests" }, "503": { "description": "upload is already being processed", "headers": { "Retry-After": { "schema": { "type": "number", "example": 300 } } } } } }, "delete": { "summary": "Cancel the resumable replacement of a video", "description": "**PeerTube >= 6.0** Uses [a resumable protocol](https://github.com/kukhariev/node-uploadx/blob/master/proto.md) to cancel the replacement of a video", "operationId": "replaceVideoSourceResumableCancel", "security": [ { "OAuth2": [] } ], "tags": [ "Video", "Video Upload" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/resumableUploadId" }, { "name": "Content-Length", "in": "header", "required": true, "schema": { "type": "number", "example": 0 } } ], "responses": { "204": { "description": "source file replacement cancelled", "headers": { "Content-Length": { "schema": { "type": "number", "example": 0 } } } }, "404": { "description": "source file replacement not found" } } } }, "/api/v1/users/me/abuses": { "get": { "summary": "List my abuses", "operationId": "getMyAbuses", "security": [ { "OAuth2": [] } ], "tags": [ "Abuses", "My User" ], "parameters": [ { "name": "id", "in": "query", "description": "only list the report with this id", "schema": { "type": "integer" } }, { "name": "state", "in": "query", "schema": { "$ref": "#/components/schemas/AbuseStateSet" } }, { "$ref": "#/components/parameters/abusesSort" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Abuse" } } } } } } } } } }, "/api/v1/abuses": { "get": { "summary": "List abuses", "operationId": "getAbuses", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Abuses" ], "parameters": [ { "name": "id", "in": "query", "description": "only list the report with this id", "schema": { "type": "integer" } }, { "name": "predefinedReason", "in": "query", "description": "predefined reason the listed reports should contain", "schema": { "$ref": "#/components/schemas/PredefinedAbuseReasons" } }, { "name": "search", "in": "query", "description": "plain search that will match with video titles, reporter names and more", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "$ref": "#/components/schemas/AbuseStateSet" } }, { "name": "searchReporter", "in": "query", "description": "only list reports of a specific reporter", "schema": { "type": "string" } }, { "name": "searchReportee", "description": "only list reports of a specific reportee", "in": "query", "schema": { "type": "string" } }, { "name": "searchVideo", "in": "query", "description": "only list reports of a specific video", "schema": { "type": "string" } }, { "name": "searchVideoChannel", "in": "query", "description": "only list reports of a specific video channel", "schema": { "type": "string" } }, { "name": "videoIs", "in": "query", "description": "only list deleted or blocklisted videos", "schema": { "type": "string", "enum": [ "deleted", "blacklisted" ] } }, { "name": "filter", "in": "query", "description": "only list account, comment or video reports", "schema": { "type": "string", "enum": [ "video", "comment", "account" ] } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/abusesSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Abuse" } } } } } } } } }, "post": { "summary": "Report an abuse", "security": [ { "OAuth2": [] } ], "tags": [ "Abuses" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "description": "Reason why the user reports this video", "type": "string", "minLength": 2, "maxLength": 3000 }, "predefinedReasons": { "$ref": "#/components/schemas/PredefinedAbuseReasons" }, "video": { "type": "object", "properties": { "id": { "description": "Video id to report", "allOf": [ { "$ref": "#/components/schemas/Video/properties/id" } ] }, "startAt": { "type": "integer", "format": "seconds", "description": "Timestamp in the video that marks the beginning of the report", "minimum": 0 }, "endAt": { "type": "integer", "format": "seconds", "description": "Timestamp in the video that marks the ending of the report", "minimum": 0 } } }, "comment": { "type": "object", "properties": { "id": { "description": "Comment id to report", "allOf": [ { "$ref": "#/components/schemas/VideoComment/properties/id" } ] } } }, "account": { "type": "object", "properties": { "id": { "description": "Account id to report", "type": "integer" } } } }, "required": [ "reason" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "abuse": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" } } } } } } } }, "400": { "description": "incorrect request parameters" } } } }, "/api/v1/abuses/{abuseId}": { "put": { "summary": "Update an abuse", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Abuses" ], "parameters": [ { "$ref": "#/components/parameters/abuseId" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "$ref": "#/components/schemas/AbuseStateSet" }, "moderationComment": { "type": "string", "description": "Update the report comment visible only to the moderation team", "minLength": 2, "maxLength": 3000 } } } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "abuse not found" } } }, "delete": { "tags": [ "Abuses" ], "summary": "Delete an abuse", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "$ref": "#/components/parameters/abuseId" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "block not found" } } } }, "/api/v1/abuses/{abuseId}/messages": { "get": { "summary": "List messages of an abuse", "security": [ { "OAuth2": [] } ], "tags": [ "Abuses" ], "parameters": [ { "$ref": "#/components/parameters/abuseId" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AbuseMessage" } } } } } } } } }, "post": { "summary": "Add message to an abuse", "security": [ { "OAuth2": [] } ], "tags": [ "Abuses" ], "parameters": [ { "$ref": "#/components/parameters/abuseId" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "description": "Message to send", "type": "string", "minLength": 2, "maxLength": 3000 } }, "required": [ "message" ] } } } }, "responses": { "200": { "description": "successful operation" }, "400": { "description": "incorrect request parameters" } } } }, "/api/v1/abuses/{abuseId}/messages/{abuseMessageId}": { "delete": { "summary": "Delete an abuse message", "security": [ { "OAuth2": [] } ], "tags": [ "Abuses" ], "parameters": [ { "$ref": "#/components/parameters/abuseId" }, { "$ref": "#/components/parameters/abuseMessageId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/{id}/blacklist": { "post": { "summary": "Block a video", "operationId": "addVideoBlock", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Video Blocks" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoBlacklistCreate" } } } }, "responses": { "204": { "description": "successful operation" } } }, "put": { "summary": "Update a video block", "operationId": "updateVideoBlock", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Video Blocks" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoBlacklistUpdate" } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "block not found" } } }, "delete": { "summary": "Unblock a video by its id", "operationId": "delVideoBlock", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Video Blocks" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "block not found" } } } }, "/api/v1/videos/blacklist": { "get": { "tags": [ "Video Blocks" ], "summary": "List video blocks", "operationId": "getVideoBlocks", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "name": "type", "in": "query", "description": "list only blocks that match this type:\n- `1`: manual block\n- `2`: automatic block that needs review\n", "schema": { "type": "integer", "enum": [ 1, 2 ] } }, { "name": "search", "in": "query", "description": "plain search that will match with video titles, and more", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/blacklistsSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoBlacklist" } } } } } } } } } }, "/api/v1/videos/{id}/storyboards": { "get": { "summary": "List storyboards of a video", "description": "**PeerTube >= 6.0**", "operationId": "listVideoStoryboards", "tags": [ "Video" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "storyboards": { "type": "array", "items": { "$ref": "#/components/schemas/Storyboard" } } } } } } } } } }, "/api/v1/videos/{id}/captions": { "get": { "summary": "List captions of a video", "operationId": "getVideoCaptions", "tags": [ "Video Captions" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoCaption" } } } } } } } } } }, "/api/v1/videos/{id}/captions/generate": { "post": { "summary": "Generate a video caption", "operationId": "generateVideoCaption", "description": "**PeerTube >= 6.2** This feature has to be enabled by the administrator", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Captions" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "forceTranscription": { "type": "boolean", "default": false } } } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "video not found" } } } }, "/api/v1/videos/{id}/captions/{captionLanguage}": { "put": { "summary": "Add or replace a video caption", "operationId": "addVideoCaption", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Captions" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/captionLanguage" } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "captionfile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "captionfile": { "contentType": "text/vtt, application/x-subrip, text/plain" } } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "video or language not found" } } }, "delete": { "summary": "Delete a video caption", "operationId": "delVideoCaption", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Captions" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/captionLanguage" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "video or language or caption for that language not found" } } } }, "/api/v1/videos/{id}/chapters": { "get": { "summary": "Get chapters of a video", "description": "**PeerTube >= 6.0**", "operationId": "getVideoChapters", "tags": [ "Video Chapters" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChapters" } } } } } }, "put": { "summary": "Replace video chapters", "description": "**PeerTube >= 6.0**", "operationId": "replaceVideoChapters", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Chapters" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "chapters": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "timecode": { "type": "integer" } } } } } } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "video not found" } } } }, "/api/v1/videos/{id}/embed-privacy": { "get": { "summary": "Get video embed privacy", "description": "**PeerTube >= 8.1**", "operationId": "getVideoEmbedPrivacy", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Embed Privacy" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/VideoEmbedPrivacy" }, "label": { "type": "string", "example": "Allowlist" } } }, "domains": { "type": "array", "items": { "type": "string", "example": "example.com" } } } } } } }, "400": { "description": "invalid request" } } }, "put": { "summary": "Update video embed privacy", "description": "**PeerTube >= 8.1**", "operationId": "updateVideoEmbedPrivacy", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Embed Privacy" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "policy": { "$ref": "#/components/schemas/VideoEmbedPrivacy" }, "domains": { "type": "array", "items": { "type": "string", "example": "example.com" } } } } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "invalid request" } } } }, "/api/v1/videos/{id}/embed-privacy/allowed": { "get": { "summary": "Check if embed is allowed", "description": "**PeerTube >= 8.1** Check if video embed is allowed on a specific domain according to the video embed privacy settings", "operationId": "isVideoEmbedOnDomainAllowed", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Embed Privacy" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The domain to check if embed is allowed" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "domainAllowed": { "type": "boolean" }, "userBypassAllowed": { "description": "Whether the user can bypass embed restrictions for this video, either because they are the owner/editor of the video or because they have a moderator or admin role", "nullable": true, "type": "boolean" } } } } } }, "400": { "description": "invalid request" } } } }, "/api/v1/videos/{id}/passwords": { "get": { "summary": "List video passwords", "description": "**PeerTube >= 6.0**", "operationId": "listVideoPasswords", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Passwords" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoPasswordList" } } } }, "400": { "description": "video is not password protected" } } }, "put": { "summary": "Update video passwords", "description": "**PeerTube >= 6.0**", "operationId": "updateVideoPasswordList", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Passwords" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "passwords": { "$ref": "#/components/schemas/AddVideoPasswords" } } } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "video is not password protected" } } }, "post": { "summary": "Add a video password", "description": "**PeerTube >= 8.0**", "operationId": "addVideoPassword", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Passwords" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "password": { "type": "string" } } } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "video is not password protected" } } } }, "/api/v1/videos/{id}/passwords/{passwordId}": { "delete": { "summary": "Delete a video password", "description": "**PeerTube >= 6.0**", "operationId": "removeVideoPassword", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Video Passwords" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/passwordId" } ], "responses": { "204": { "description": "successful operation" }, "400": { "description": "video is not password protected" }, "403": { "description": "cannot delete the last password of the protected video" } } } }, "/api/v1/video-channels": { "get": { "summary": "List video channels", "operationId": "getVideoChannels", "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelList" } } } } } }, "post": { "summary": "Create a video channel", "operationId": "addVideoChannel", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoChannel": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" } } } } } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelCreate" } } } } } }, "/api/v1/video-channels/{channelHandle}": { "get": { "summary": "Get a video channel", "operationId": "getVideoChannel", "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannel" } } } } } }, "put": { "summary": "Update a video channel", "operationId": "putVideoChannel", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelUpdate" } } } } }, "delete": { "summary": "Delete a video channel", "operationId": "delVideoChannel", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channels/{channelHandle}/videos": { "get": { "summary": "List videos of a video channel", "operationId": "getVideoChannelVideos", "tags": [ "Video", "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } } } } }, "/api/v1/video-channels/{channelHandle}/activities": { "get": { "summary": "List activities of a video channel", "description": "**PeerTube >= 8.0**", "operationId": "listVideoChannelActivities", "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelActivityListResponse" } } } } } } }, "/api/v1/video-channels/{channelHandle}/video-playlists": { "get": { "summary": "List playlists of a channel", "tags": [ "Video Playlists", "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/videoPlaylistType" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPlaylist" } } } } } } } } } }, "/api/v1/video-channels/{channelHandle}/video-playlists/reorder": { "post": { "summary": "Reorder channel playlists", "operationId": "reorderVideoPlaylistsOfChannel", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists", "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "startPosition": { "type": "integer", "description": "Start position of the element to reorder", "minimum": 1 }, "insertAfterPosition": { "type": "integer", "description": "New position for the block to reorder, to add the block before the first element", "minimum": 0 }, "reorderLength": { "type": "integer", "description": "How many element from `startPosition` to reorder", "minimum": 1 } }, "required": [ "startPosition", "insertAfterPosition" ] } } } } } }, "/api/v1/video-channels/{channelHandle}/followers": { "get": { "tags": [ "Video Channels" ], "summary": "List followers of a video channel", "security": [ { "OAuth2": [] } ], "operationId": "getVideoChannelFollowers", "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/followersSort" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Follow" } } } } } } } } } }, "/api/v1/video-channels/{channelHandle}/avatar/pick": { "post": { "summary": "Update channel avatar", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } } } } }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the avatar" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "avatarfile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "avatarfile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/video-channels/{channelHandle}/avatar": { "delete": { "summary": "Delete channel avatar", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channels/{channelHandle}/banner/pick": { "post": { "summary": "Update channel banner", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "banners": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } } } } }, "413": { "description": "image file too large", "headers": { "X-File-Maximum-Size": { "schema": { "type": "string", "format": "Nginx size" }, "description": "Maximum file size for the banner" } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "bannerfile": { "description": "The file to upload.", "type": "string", "format": "binary" } } }, "encoding": { "bannerfile": { "contentType": "image/png, image/jpeg" } } } } } } }, "/api/v1/video-channels/{channelHandle}/banner": { "delete": { "summary": "Delete channel banner", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channels/{channelHandle}/import-videos": { "post": { "summary": "Import videos in channel", "description": "Import a remote channel/playlist videos into a channel", "security": [ { "OAuth2": [] } ], "tags": [ "Video Channels", "Channels Sync" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportVideosInChannelCreate" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channel-syncs": { "post": { "summary": "Create a synchronization for a video channel", "operationId": "addVideoChannelSync", "security": [ { "OAuth2": [] } ], "tags": [ "Channels Sync" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelSyncCreate" } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoChannelSync": { "$ref": "#/components/schemas/VideoChannelSync" } } } } } } } } }, "/api/v1/video-channel-syncs/{channelSyncId}": { "delete": { "summary": "Delete a video channel synchronization", "operationId": "delVideoChannelSync", "security": [ { "OAuth2": [] } ], "tags": [ "Channels Sync" ], "parameters": [ { "$ref": "#/components/parameters/channelSyncId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channel-syncs/{channelSyncId}/sync": { "post": { "summary": "Triggers the channel synchronization job, fetching all the videos from the remote channel", "operationId": "triggerVideoChannelSync", "security": [ { "OAuth2": [] } ], "tags": [ "Channels Sync" ], "parameters": [ { "$ref": "#/components/parameters/channelSyncId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/player-settings/videos/{id}": { "get": { "summary": "Get video player settings", "description": "Get player settings for a specific video. Returns video-specific settings merged with channel player settings.", "operationId": "getVideoPlayerSettings", "tags": [ "Player Settings" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "name": "raw", "in": "query", "required": false, "description": "Return raw settings without merging channel defaults", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerVideoSettings" } } } }, "404": { "description": "video not found" } } }, "put": { "summary": "Update video player settings", "description": "Update player settings for a specific video", "operationId": "updateVideoPlayerSettings", "security": [ { "OAuth2": [] } ], "tags": [ "Player Settings" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerVideoSettingsUpdate" } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerVideoSettings" } } } }, "404": { "description": "video not found" } } } }, "/api/v1/player-settings/video-channels/{channelHandle}": { "get": { "summary": "Get channel player settings", "description": "Get player settings for a video channel.", "operationId": "getChannelPlayerSettings", "tags": [ "Player Settings" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "name": "raw", "in": "query", "required": false, "description": "Return raw settings without applying instance defaults", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerChannelSettings" } } } }, "404": { "description": "video channel not found" } } }, "put": { "summary": "Update channel player settings", "description": "Update default player settings for a video channel.", "operationId": "updateChannelPlayerSettings", "security": [ { "OAuth2": [] } ], "tags": [ "Player Settings" ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerChannelSettingsUpdate" } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerChannelSettings" } } } }, "404": { "description": "video channel not found" } } } }, "/api/v1/video-playlists/privacies": { "get": { "summary": "List available playlist privacy policies", "operationId": "getPlaylistPrivacyPolicies", "tags": [ "Video Playlists" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "examples": { "nightly": { "value": { "1": "Public", "2": "Unlisted", "3": "Private" } } } } } } } } }, "/api/v1/video-playlists": { "get": { "summary": "List video playlists", "operationId": "getPlaylists", "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/videoPlaylistType" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPlaylist" } } } } } } } } }, "post": { "summary": "Create a video playlist", "description": "If the video playlist is set as public, `videoChannelId` is mandatory.", "operationId": "addPlaylist", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoPlaylist": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/VideoPlaylist/properties/id" }, "uuid": { "$ref": "#/components/schemas/VideoPlaylist/properties/uuid" }, "shortUUID": { "$ref": "#/components/schemas/VideoPlaylist/properties/shortUUID" } } } } } } } } }, "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "displayName": { "description": "Video playlist display name", "type": "string", "minLength": 1, "maxLength": 120 }, "thumbnailfile": { "description": "Video playlist thumbnail file", "type": "string", "format": "binary" }, "privacy": { "$ref": "#/components/schemas/VideoPlaylistPrivacySet" }, "description": { "description": "Video playlist description", "type": "string", "minLength": 3, "maxLength": 1000 }, "videoChannelId": { "allOf": [ { "$ref": "#/components/schemas/id" } ], "description": "Video channel in which the playlist will be published" } }, "required": [ "displayName" ] }, "encoding": { "thumbnailfile": { "contentType": "image/jpeg" } } } } } } }, "/api/v1/video-playlists/{playlistId}": { "get": { "summary": "Get a video playlist", "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoPlaylist" } } } } } }, "put": { "summary": "Update a video playlist", "description": "If the video playlist is set as public, the playlist must have a assigned channel.", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "responses": { "204": { "description": "successful operation" } }, "parameters": [ { "$ref": "#/components/parameters/playlistId" } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "displayName": { "description": "Video playlist display name", "type": "string", "minLength": 1, "maxLength": 120 }, "thumbnailfile": { "description": "Video playlist thumbnail file", "type": "string", "format": "binary" }, "privacy": { "$ref": "#/components/schemas/VideoPlaylistPrivacySet" }, "description": { "description": "Video playlist description", "type": "string" }, "videoChannelId": { "allOf": [ { "$ref": "#/components/schemas/id" } ], "description": "Video channel in which the playlist will be published" } } }, "encoding": { "thumbnailfile": { "contentType": "image/jpeg" } } } } } }, "delete": { "summary": "Delete a video playlist", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-playlists/{playlistId}/videos": { "get": { "summary": "List videos of a playlist", "operationId": "getVideoPlaylistVideos", "tags": [ "Videos", "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "id": { "description": "Playlist element id", "allOf": [ { "$ref": "#/components/schemas/id" } ] }, "position": { "type": "integer", "example": 2 }, "startTimestamp": { "type": "integer", "nullable": true, "example": 10, "format": "seconds" }, "stopTimestamp": { "type": "integer", "nullable": true, "example": 41, "format": "seconds" }, "video": { "$ref": "#/components/schemas/Video" } } } } } } } } } } }, "post": { "summary": "Add a video in a playlist", "operationId": "addVideoPlaylistVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Videos", "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoPlaylistElement": { "type": "object", "properties": { "id": { "type": "integer", "example": 2 } } } } } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "videoId": { "oneOf": [ { "$ref": "#/components/schemas/Video/properties/uuid" }, { "$ref": "#/components/schemas/Video/properties/id" } ], "description": "Video to add in the playlist" }, "startTimestamp": { "type": "integer", "format": "seconds", "description": "Start the video at this specific timestamp" }, "stopTimestamp": { "type": "integer", "format": "seconds", "description": "Stop the video at this specific timestamp" } }, "required": [ "videoId" ] } } } } } }, "/api/v1/video-playlists/{playlistId}/videos/reorder": { "post": { "summary": "Reorder playlist elements", "operationId": "reorderVideoPlaylist", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" } ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "startPosition": { "type": "integer", "description": "Start position of the element to reorder", "minimum": 1 }, "insertAfterPosition": { "type": "integer", "description": "New position for the block to reorder, to add the block before the first element", "minimum": 0 }, "reorderLength": { "type": "integer", "description": "How many element from `startPosition` to reorder", "minimum": 1 } }, "required": [ "startPosition", "insertAfterPosition" ] } } } } } }, "/api/v1/video-playlists/{playlistId}/videos/{playlistElementId}": { "put": { "summary": "Update a playlist element", "operationId": "putVideoPlaylistVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" }, { "$ref": "#/components/parameters/playlistElementId" } ], "responses": { "204": { "description": "successful operation" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "startTimestamp": { "type": "integer", "format": "seconds", "description": "Start the video at this specific timestamp" }, "stopTimestamp": { "type": "integer", "format": "seconds", "description": "Stop the video at this specific timestamp" } } } } } } }, "delete": { "summary": "Delete an element from a playlist", "operationId": "delVideoPlaylistVideo", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "parameters": [ { "$ref": "#/components/parameters/playlistId" }, { "$ref": "#/components/parameters/playlistElementId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/users/me/video-playlists/videos-exist": { "get": { "summary": "Check video exists in my playlists", "security": [ { "OAuth2": [] } ], "tags": [ "Video Playlists" ], "parameters": [ { "name": "videoIds", "in": "query", "required": true, "description": "The video ids to check", "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Video/properties/id" } } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "videoId": { "type": "array", "items": { "type": "object", "properties": { "playlistElementId": { "type": "integer" }, "playlistId": { "type": "integer" }, "startTimestamp": { "type": "integer", "format": "seconds", "nullable": true }, "stopTimestamp": { "type": "integer", "format": "seconds", "nullable": true } } } } } } } } } } } }, "/api/v1/accounts/{name}/video-playlists": { "get": { "summary": "List playlists of an account", "tags": [ "Video Playlists", "Accounts" ], "parameters": [ { "$ref": "#/components/parameters/name" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/videoPlaylistType" }, { "$ref": "#/components/parameters/includeCollaborations" }, { "name": "channelNameOneOf", "in": "query", "required": false, "description": "**PeerTube >= 8.0** Filter on playlists that are published on a channel with one of these names", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "style": "form", "explode": true } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPlaylist" } } } } } } } } } }, "/api/v1/accounts/{name}/video-channels": { "get": { "summary": "List video channels of an account", "tags": [ "Video Channels", "Accounts" ], "parameters": [ { "$ref": "#/components/parameters/name" }, { "name": "withStats", "in": "query", "description": "include daily view statistics for the last 30 days and total views (only if authenticated as the account user)", "schema": { "type": "boolean" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/includeCollaborations" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelList" } } } } } } }, "/api/v1/accounts/{name}/video-channel-syncs": { "get": { "summary": "List the synchronizations of video channels of an account", "tags": [ "Video Channels", "Channels Sync", "Accounts" ], "parameters": [ { "$ref": "#/components/parameters/name" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/includeCollaborations" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelSyncList" } } } } } } }, "/api/v1/accounts/{name}/ratings": { "get": { "summary": "List ratings of an account", "security": [ { "OAuth2": [] } ], "tags": [ "Accounts" ], "parameters": [ { "$ref": "#/components/parameters/name" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "name": "rating", "in": "query", "required": false, "description": "Optionally filter which ratings to retrieve", "schema": { "type": "string", "enum": [ "like", "dislike" ] } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/VideoRating" } } } } } } } }, "/api/v1/videos/{id}/comment-threads": { "get": { "summary": "List threads of a video", "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/commentsSort" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentThreadResponse" } } } } } }, "post": { "summary": "Create a thread", "security": [ { "OAuth2": [] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentThreadPostResponse" } } } }, "404": { "description": "video does not exist" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "allOf": [ { "$ref": "#/components/schemas/VideoComment/properties/text" } ], "format": "markdown", "maxLength": 10000 } }, "required": [ "text" ] } } } } } }, "/api/v1/videos/{id}/comment-threads/{threadId}": { "get": { "summary": "Get a thread", "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/threadId" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoCommentThreadTree" } } } } } } }, "/api/v1/videos/comments": { "get": { "summary": "List instance comments", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/search" }, { "$ref": "#/components/parameters/searchAccountForComments" }, { "$ref": "#/components/parameters/searchVideoForComments" }, { "$ref": "#/components/parameters/videoId" }, { "$ref": "#/components/parameters/videoChannelId" }, { "$ref": "#/components/parameters/autoTagOneOfComment" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/onLocalVideo" }, { "$ref": "#/components/parameters/includeMuted" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoCommentForOwnerOrAdmin" } } } } } } } } } }, "/api/v1/videos/{id}/comments/{commentId}": { "post": { "summary": "Reply to a thread of a video", "security": [ { "OAuth2": [] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/commentId" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentThreadPostResponse" } } } }, "404": { "description": "thread or video does not exist" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "allOf": [ { "$ref": "#/components/schemas/VideoComment/properties/text" } ], "format": "markdown", "maxLength": 10000 } }, "required": [ "text" ] } } } } }, "delete": { "summary": "Delete a comment or a reply", "security": [ { "OAuth2": [] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/commentId" } ], "responses": { "204": { "description": "successful operation" }, "403": { "description": "cannot remove comment of another user" }, "404": { "description": "comment or video does not exist" }, "409": { "description": "comment is already deleted" } } } }, "/api/v1/videos/{id}/comments/{commentId}/approve": { "post": { "summary": "Approve a comment", "description": "**PeerTube >= 6.2** Approve a comment that requires a review", "security": [ { "OAuth2": [] } ], "tags": [ "Video Comments" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/commentId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/videos/{id}/rate": { "put": { "summary": "Like/dislike a video", "security": [ { "OAuth2": [] } ], "tags": [ "Video Rates" ], "parameters": [ { "$ref": "#/components/parameters/idOrUUID" }, { "$ref": "#/components/parameters/videoPasswordHeader" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "rating": { "type": "string", "enum": [ "like", "dislike" ] } }, "required": [ "rating" ] } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "video does not exist" } } } }, "/api/v1/videos/{id}/hls": { "delete": { "summary": "Delete video HLS files", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Video Files" ], "operationId": "delVideoHLS", "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "video does not exist" } } } }, "/api/v1/videos/{id}/web-videos": { "delete": { "summary": "Delete video Web Video files", "description": "**PeerTube >= 6.0**", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Video Files" ], "operationId": "delVideoWebVideos", "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "video does not exist" } } } }, "/api/v1/videos/{id}/transcoding": { "post": { "summary": "Create a transcoding job", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Video Transcoding" ], "operationId": "createVideoTranscoding", "parameters": [ { "$ref": "#/components/parameters/idOrUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "transcodingType": { "type": "string", "enum": [ "hls", "web-video" ] }, "forceTranscoding": { "type": "boolean", "default": false, "description": "If the video is stuck in transcoding state, do it anyway" } }, "required": [ "transcodingType" ] } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "video does not exist" } } } }, "/api/v1/search/videos": { "get": { "tags": [ "Search", "Video" ], "summary": "Search videos", "operationId": "searchVideos", "parameters": [ { "name": "search", "in": "query", "required": true, "allowEmptyValue": false, "description": "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.\n", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/uuids" }, { "$ref": "#/components/parameters/searchTarget" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/skipCount" }, { "$ref": "#/components/parameters/videosSort" }, { "$ref": "#/components/parameters/nsfw" }, { "$ref": "#/components/parameters/nsfwFlagsIncluded" }, { "$ref": "#/components/parameters/nsfwFlagsExcluded" }, { "$ref": "#/components/parameters/isLive" }, { "$ref": "#/components/parameters/includeScheduledLive" }, { "$ref": "#/components/parameters/categoryOneOf" }, { "$ref": "#/components/parameters/licenceOneOf" }, { "$ref": "#/components/parameters/languageOneOf" }, { "$ref": "#/components/parameters/tagsOneOf" }, { "$ref": "#/components/parameters/tagsAllOf" }, { "$ref": "#/components/parameters/isLocal" }, { "$ref": "#/components/parameters/include" }, { "$ref": "#/components/parameters/hasHLSFiles" }, { "$ref": "#/components/parameters/hasWebVideoFiles" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/autoTagOneOfVideo" }, { "$ref": "#/components/parameters/stateOneOfVideo" }, { "$ref": "#/components/parameters/privacyOneOf" }, { "$ref": "#/components/parameters/excludeAlreadyWatched" }, { "name": "startDate", "in": "query", "description": "Get videos that are published after this date", "schema": { "type": "string", "format": "date-time" } }, { "name": "endDate", "in": "query", "description": "Get videos that are published before this date", "schema": { "type": "string", "format": "date-time" } }, { "name": "originallyPublishedStartDate", "in": "query", "description": "Get videos that are originally published after this date", "schema": { "type": "string", "format": "date-time" } }, { "name": "originallyPublishedEndDate", "in": "query", "description": "Get videos that are originally published before this date", "schema": { "type": "string", "format": "date-time" } }, { "name": "durationMin", "in": "query", "description": "Get videos that have this minimum duration", "schema": { "type": "integer" } }, { "name": "durationMax", "in": "query", "description": "Get videos that have this maximum duration", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoListResponse" } } } }, "500": { "description": "search index unavailable" } } } }, "/api/v1/search/video-channels": { "get": { "tags": [ "Search", "Video Channels" ], "summary": "Search channels", "operationId": "searchChannels", "parameters": [ { "name": "search", "in": "query", "required": true, "description": "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.\n", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/searchTarget" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/handles" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoChannelList" } } } }, "500": { "description": "search index unavailable" } } } }, "/api/v1/search/video-playlists": { "get": { "tags": [ "Search", "Video Playlists" ], "summary": "Search playlists", "operationId": "searchPlaylists", "parameters": [ { "name": "search", "in": "query", "required": true, "description": "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.\n", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/searchTarget" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/host" }, { "$ref": "#/components/parameters/uuids" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPlaylist" } } } } } } }, "500": { "description": "search index unavailable" } } } }, "/api/v1/blocklist/status": { "get": { "tags": [ "Account Blocklist", "Server Blocklist" ], "summary": "Get block status of accounts/hosts", "parameters": [ { "name": "accounts", "in": "query", "description": "Check if these accounts are blocked", "example": [ "goofy@example.com", "donald@example.com" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "hosts", "in": "query", "description": "Check if these hosts are blocked", "example": [ "example.com" ], "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockStatus" } } } } } } }, "/api/v1/users/me/blocklist/accounts": { "get": { "summary": "List accounts blocked by my account", "description": "Get the list of accounts that the authenticated user has blocked", "operationId": "getMyBlockedAccounts", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "name": "search", "in": "query", "required": false, "description": "Search query string", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountBlock" } } } } } } }, "401": { "description": "authentication required" } } }, "post": { "summary": "Block an account by my account", "description": "Add an account to the authenticated user's blocklist", "operationId": "blockAccount", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accountName": { "type": "string", "description": "Account name to block (format: name@host)", "example": "user@example.com" } }, "required": [ "accountName" ] } } } }, "responses": { "204": { "description": "successful operation - account blocked" }, "400": { "description": "invalid account name" }, "401": { "description": "authentication required" }, "404": { "description": "account not found" } } } }, "/api/v1/users/me/blocklist/accounts/{accountName}": { "delete": { "summary": "Unblock an account by my account", "description": "Remove an account from the authenticated user's blocklist", "operationId": "unblockAccount", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "Account name to unblock (format: name@host)", "schema": { "type": "string", "example": "user@example.com" } } ], "responses": { "204": { "description": "successful operation - account unblocked" }, "400": { "description": "invalid account name" }, "401": { "description": "authentication required" }, "404": { "description": "account block not found" } } } }, "/api/v1/users/me/blocklist/servers": { "get": { "summary": "List servers blocked by my account", "description": "Get the list of servers that the authenticated user has blocked", "operationId": "getMyBlockedServers", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "name": "search", "in": "query", "required": false, "description": "Search query string", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ServerBlock" } } } } } } }, "401": { "description": "authentication required" } } }, "post": { "summary": "Block a server by my account", "description": "Add a server to the authenticated user's blocklist", "operationId": "blockServer", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "host": { "type": "string", "description": "Server host to block", "example": "example.com" } }, "required": [ "host" ] } } } }, "responses": { "204": { "description": "successful operation - server blocked" }, "400": { "description": "invalid server host" }, "401": { "description": "authentication required" }, "404": { "description": "server not found" } } } }, "/api/v1/users/me/blocklist/servers/{host}": { "delete": { "summary": "Unblock a server by my account", "description": "Remove a server from the authenticated user's blocklist", "operationId": "unblockServer", "security": [ { "OAuth2": [ "user" ] } ], "tags": [ "Account Blocklist" ], "parameters": [ { "name": "host", "in": "path", "required": true, "description": "Server host to unblock", "schema": { "type": "string", "example": "example.com" } } ], "responses": { "204": { "description": "successful operation - server unblocked" }, "400": { "description": "invalid server host" }, "401": { "description": "authentication required" }, "404": { "description": "server block not found" } } } }, "/api/v1/server/blocklist/accounts": { "get": { "tags": [ "Server Blocklist" ], "summary": "List blocked accounts by server", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "name": "subscriptionName", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountBlock" } } } } } } } } }, "post": { "tags": [ "Server Blocklist" ], "summary": "Block an account by server", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "accountName": { "type": "string", "example": "chocobozzz@example.org", "description": "account to block, in the form `username@domain`" } }, "required": [ "accountName" ] } } } }, "responses": { "200": { "description": "successful operation" }, "409": { "description": "self-blocking forbidden" } } } }, "/api/v1/server/blocklist/accounts/{accountName}": { "delete": { "tags": [ "Server Blocklist" ], "summary": "Unblock an account by server", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account to unblock, in the form `username@domain`", "schema": { "type": "string" } } ], "responses": { "201": { "description": "successful operation" }, "404": { "description": "account or account block does not exist" } } } }, "/api/v1/server/blocklist/servers": { "get": { "tags": [ "Server Blocklist" ], "summary": "List blocked servers by server", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "name": "subscriptionName", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ServerBlock" } } } } } } } } }, "post": { "tags": [ "Server Blocklist" ], "summary": "Block a server by server", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "host": { "type": "string", "format": "hostname", "description": "server domain to block" } }, "required": [ "host" ] } } } }, "responses": { "204": { "description": "successful operation" }, "409": { "description": "self-blocking forbidden" } } } }, "/api/v1/server/blocklist/servers/{host}": { "delete": { "tags": [ "Server Blocklist" ], "summary": "Unblock a server by server", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "host", "in": "path", "required": true, "description": "server domain to unblock", "schema": { "type": "string", "format": "hostname" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "server block does not exist" } } } }, "/api/v1/server/blocklist/subscriptions": { "get": { "tags": [ "Server Blocklist" ], "summary": "List server blocklist subscriptions", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/BlocklistSubscription" } } } } } } } } }, "post": { "tags": [ "Server Blocklist" ], "summary": "Add a server blocklist subscription", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "url" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlocklistSubscription" } } } }, "409": { "description": "subscription already exists" } } } }, "/api/v1/server/blocklist/subscriptions/{id}": { "delete": { "tags": [ "Server Blocklist" ], "summary": "Delete a server blocklist subscription", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "subscription does not exist" } } } }, "/api/v1/server/blocklist/public-log": { "get": { "tags": [ "Server Blocklist" ], "summary": "List publicly shared server blocklist log entries", "parameters": [ { "name": "startDate", "in": "query", "required": true, "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutoMuteList" } } } }, "403": { "description": "public log is disabled" } } } }, "/api/v1/server/redundancy/{host}": { "put": { "tags": [ "Instance Redundancy" ], "summary": "Update a server redundancy policy", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "host", "in": "path", "required": true, "description": "server domain to mirror", "schema": { "type": "string", "format": "hostname" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "redundancyAllowed": { "type": "boolean", "description": "allow mirroring of the host's local videos" } }, "required": [ "redundancyAllowed" ] } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "server is not already known" } } } }, "/api/v1/server/redundancy/videos": { "get": { "tags": [ "Video Mirroring" ], "summary": "List videos being mirrored", "operationId": "getMirroredVideos", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "target", "in": "query", "required": true, "description": "direction of the mirror", "schema": { "type": "string", "enum": [ "my-videos", "remote-videos" ] } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/videoRedundanciesSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/VideoRedundancy" } } } } } } }, "post": { "tags": [ "Video Mirroring" ], "summary": "Mirror a video", "operationId": "putMirroredVideo", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "videoId": { "$ref": "#/components/schemas/Video/properties/id" } }, "required": [ "videoId" ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "cannot mirror a local video" }, "404": { "description": "video does not exist" }, "409": { "description": "video is already mirrored" } } } }, "/api/v1/server/redundancy/videos/{redundancyId}": { "delete": { "tags": [ "Video Mirroring" ], "summary": "Delete a mirror done on a video", "operationId": "delMirroredVideo", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "redundancyId", "in": "path", "required": true, "description": "id of an existing redundancy on a video", "schema": { "type": "string" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "video redundancy not found" } } } }, "/api/v1/server/stats": { "get": { "tags": [ "Stats" ], "summary": "Get instance stats", "description": "Get instance public statistics. This endpoint is cached.", "operationId": "getInstanceStats", "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerStats" } } } } } } }, "/api/v1/server/contact": { "post": { "tags": [ "Contact" ], "summary": "Contact the instance administrators", "operationId": "contactAdministrator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "fromName": { "type": "string", "description": "Display name of the sender" }, "fromEmail": { "type": "string", "format": "email", "description": "Email address of the sender" }, "subject": { "type": "string", "description": "Subject of the message" }, "body": { "type": "string", "description": "Message body" } }, "required": [ "fromName", "fromEmail", "body" ] } } } }, "responses": { "204": { "description": "successful operation" }, "403": { "description": "a contact form was already sent recently from this IP address" }, "409": { "description": "contact form or SMTP is not configured on this instance" } } } }, "/api/v1/server/debug": { "get": { "tags": [ "Debug" ], "summary": "Get debug information", "description": "Retrieve internal debug information for administrators.", "operationId": "getDebug", "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" }, "activityPubMessagesWaiting": { "type": "integer" } } } } } } } } }, "/api/v1/server/debug/run-command": { "post": { "tags": [ "Debug" ], "summary": "Run a debug command", "description": "Run an internal debug command as an administrator.", "operationId": "runDebugCommand", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "command": { "type": "string", "enum": [ "remove-dandling-resumable-uploads", "remove-expired-user-exports", "process-video-stats-buffer", "process-video-viewers", "process-update-videos-scheduler", "process-video-channel-sync-latest", "process-remove-old-stats" ] } }, "required": [ "command" ] }, { "type": "object", "properties": { "command": { "type": "string", "enum": [ "test-emails" ] }, "email": { "type": "string", "format": "email" } }, "required": [ "command", "email" ] } ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "invalid command or invalid email" } } } }, "/api/v1/server/logs/client": { "post": { "tags": [ "Logs" ], "summary": "Send client log", "operationId": "sendClientLog", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendClientLog" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/server/logs": { "get": { "tags": [ "Logs" ], "summary": "Get instance logs", "operationId": "getInstanceLogs", "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } } } } }, "/api/v1/server/audit-logs": { "get": { "tags": [ "Logs" ], "summary": "Get instance audit logs", "operationId": "getInstanceAuditLogs", "security": [ { "OAuth2": [ "admin" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } } } } }, "/api/v1/plugins": { "get": { "tags": [ "Plugins" ], "summary": "List plugins", "operationId": "getPlugins", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "pluginType", "in": "query", "schema": { "type": "integer" } }, { "name": "uninstalled", "in": "query", "schema": { "type": "boolean" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginResponse" } } } } } } }, "/api/v1/plugins/available": { "get": { "tags": [ "Plugins" ], "summary": "List available plugins", "operationId": "getAvailablePlugins", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "name": "search", "in": "query", "schema": { "type": "string" } }, { "name": "pluginType", "in": "query", "schema": { "type": "integer" } }, { "name": "currentPeerTubeEngine", "in": "query", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginResponse" } } } }, "503": { "description": "plugin index unavailable" } } } }, "/api/v1/plugins/install": { "post": { "tags": [ "Plugins" ], "summary": "Install a plugin", "operationId": "addPlugin", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "npmName": { "type": "string", "example": "peertube-plugin-auth-ldap" } }, "required": [ "npmName" ], "additionalProperties": false }, { "type": "object", "properties": { "path": { "type": "string" } }, "required": [ "path" ], "additionalProperties": false } ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "should have either `npmName` or `path` set" } } } }, "/api/v1/plugins/update": { "post": { "tags": [ "Plugins" ], "summary": "Update a plugin", "operationId": "updatePlugin", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "npmName": { "type": "string", "example": "peertube-plugin-auth-ldap" } }, "required": [ "npmName" ], "additionalProperties": false }, { "type": "object", "properties": { "path": { "type": "string" } }, "required": [ "path" ], "additionalProperties": false } ] } } } }, "responses": { "204": { "description": "successful operation" }, "400": { "description": "should have either `npmName` or `path` set" }, "404": { "description": "existing plugin not found" } } } }, "/api/v1/plugins/uninstall": { "post": { "tags": [ "Plugins" ], "summary": "Uninstall a plugin", "operationId": "uninstallPlugin", "security": [ { "OAuth2": [ "admin" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "npmName": { "type": "string", "description": "name of the plugin/theme in its package.json", "example": "peertube-plugin-auth-ldap" } }, "required": [ "npmName" ] } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "existing plugin not found" } } } }, "/api/v1/plugins/{npmName}": { "get": { "tags": [ "Plugins" ], "summary": "Get a plugin", "operationId": "getPlugin", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/npmName" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Plugin" } } } }, "404": { "description": "plugin not found" } } } }, "/api/v1/plugins/{npmName}/settings": { "put": { "tags": [ "Plugins" ], "summary": "Set a plugin's settings", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/npmName" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "settings": { "type": "object", "additionalProperties": true } } } } } }, "responses": { "204": { "description": "successful operation" }, "404": { "description": "plugin not found" } } } }, "/api/v1/plugins/{npmName}/public-settings": { "get": { "tags": [ "Plugins" ], "summary": "Get a plugin's public settings", "parameters": [ { "$ref": "#/components/parameters/npmName" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "plugin not found" } } } }, "/api/v1/plugins/{npmName}/registered-settings": { "get": { "tags": [ "Plugins" ], "summary": "Get a plugin's registered settings", "security": [ { "OAuth2": [ "admin" ] } ], "parameters": [ { "$ref": "#/components/parameters/npmName" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "plugin not found" } } } }, "/api/v1/metrics/playback": { "post": { "summary": "Create playback metrics", "description": "These metrics are exposed by OpenTelemetry metrics exporter if enabled.", "tags": [ "Stats" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlaybackMetricCreate" } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/registration-tokens/generate": { "post": { "summary": "Generate registration token", "description": "Generate a new runner registration token", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Registration Token" ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/registration-tokens/{registrationTokenId}": { "delete": { "summary": "Remove registration token", "description": "Remove a registration token. Runners that used this token for their registration are automatically removed.", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Registration Token" ], "parameters": [ { "$ref": "#/components/parameters/registrationTokenId" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/registration-tokens": { "get": { "summary": "List registration tokens", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Registration Token" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/registrationTokenSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/RunnerRegistrationToken" } } } } } } } } } }, "/api/v1/runners/register": { "post": { "summary": "Register a new runner", "description": "API used by PeerTube runners", "tags": [ "Runners" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "registrationToken": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" } }, "required": [ "registrationToken", "name" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Runner id" }, "runnerToken": { "type": "string" } } } } } } } } }, "/api/v1/runners/unregister": { "post": { "summary": "Unregister a runner", "description": "API used by PeerTube runners", "tags": [ "Runners" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" } }, "required": [ "runnerToken" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/{runnerId}": { "delete": { "summary": "Delete a runner", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runners" ], "parameters": [ { "$ref": "#/components/parameters/runnerId" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" } }, "required": [ "runnerToken" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners": { "get": { "summary": "List runners", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runners" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/runnerSort" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Runner" } } } } } } } } } }, "/api/v1/runners/jobs/request": { "post": { "summary": "Request a new job", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobTypes": { "type": "array", "description": "Filter jobs depending on their types", "items": { "type": "string" } } }, "required": [ "runnerToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "availableJobs": { "type": "array", "items": { "type": "object", "properties": { "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "type": { "$ref": "#/components/schemas/RunnerJobType" }, "payload": { "$ref": "#/components/schemas/RunnerJobPayload" } } } } } } } } } } } }, "/api/v1/runners/jobs/{jobUUID}/accept": { "post": { "summary": "Accept job", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" } }, "required": [ "runnerToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "job": { "allOf": [ { "$ref": "#/components/schemas/RunnerJob" }, { "type": "object", "properties": { "jobToken": { "type": "string" } } } ] } } } } } } } } }, "/api/v1/runners/jobs/{jobUUID}/abort": { "post": { "summary": "Abort job", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" }, "reason": { "type": "string", "description": "Why the runner aborts this job" } }, "required": [ "runnerToken", "jobToken", "reason" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs/{jobUUID}/update": { "post": { "summary": "Update job", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" }, "progress": { "type": "integer", "description": "Update job progression percentage (optional)" }, "payload": { "anyOf": [ { "type": "object", "description": "Provide live transcoding chunks update", "properties": { "type": { "type": "string", "enum": [ "add-chunk", "remove-chunk" ] }, "masterPlaylistFile": { "type": "string", "format": "binary" }, "resolutionPlaylistFile": { "type": "string", "format": "binary" }, "resolutionPlaylistFilename": { "type": "string" }, "videoChunkFile": { "type": "string", "format": "binary" }, "videoChunkFilename": { "type": "string" } } } ] } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs/{jobUUID}/error": { "post": { "summary": "Post job error", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" }, "message": { "type": "string", "description": "Why the runner failed to process this job" } }, "required": [ "runnerToken", "jobToken", "message" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs/{jobUUID}/success": { "post": { "summary": "Post job success", "description": "API used by PeerTube runners", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" }, "payload": { "anyOf": [ { "type": "object", "title": "VOD web video transcoding", "properties": { "videoFile": { "type": "string", "format": "binary" } } }, { "type": "object", "title": "VOD HLS transcoding", "properties": { "videoFile": { "type": "string", "format": "binary" }, "resolutionPlaylistFile": { "type": "string", "format": "binary" } } }, { "type": "object", "title": "VOD audio merge transcoding", "properties": { "videoFile": { "type": "string", "format": "binary" } } }, { "type": "object", "title": "Live RTMP to HLS transcoding" } ] } }, "required": [ "runnerToken", "jobToken", "payload" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs/{jobUUID}/files/videos/{videoIdOrUUID}/max-quality/audio": { "post": { "summary": "Download the max-quality audio file for a job video", "description": "API used by PeerTube runners.", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" }, { "$ref": "#/components/parameters/videoIdOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "the job is not associated with this video" } } } }, "/api/v1/runners/jobs/{jobUUID}/files/videos/{videoIdOrUUID}/max-quality": { "post": { "summary": "Download the max-quality video file for a job video", "description": "API used by PeerTube runners.", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" }, { "$ref": "#/components/parameters/videoIdOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "the job is not associated with this video" } } } }, "/api/v1/runners/jobs/{jobUUID}/files/videos/{videoIdOrUUID}/thumbnails/max-quality": { "post": { "summary": "Download the max-quality thumbnail for a job video", "description": "API used by PeerTube runners.", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" }, { "$ref": "#/components/parameters/videoIdOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "the job is not associated with this video" } } } }, "/api/v1/runners/jobs/{jobUUID}/files/videos/{videoIdOrUUID}/previews/max-quality": { "post": { "summary": "Download the max-quality preview for a job video", "description": "API used by PeerTube runners.", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" }, { "$ref": "#/components/parameters/videoIdOrUUID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "the job is not associated with this video" } } } }, "/api/v1/runners/jobs/{jobUUID}/files/videos/{videoIdOrUUID}/studio/task-files/{filename}": { "post": { "summary": "Download a video studio task file for a job video", "description": "API used by PeerTube runners.", "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" }, { "$ref": "#/components/parameters/videoIdOrUUID" }, { "name": "filename", "in": "path", "required": true, "description": "Name of the task file to download", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "runnerToken": { "type": "string" }, "jobToken": { "type": "string" } }, "required": [ "runnerToken", "jobToken" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "the file is not associated with this edition task" }, "403": { "description": "the job is not associated with this video" } } } }, "/api/v1/runners/jobs/{jobUUID}/cancel": { "post": { "summary": "Cancel a job", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs/{jobUUID}": { "delete": { "summary": "Delete a job", "description": "The endpoint will first cancel the job if needed, and then remove it from the database. Children jobs will also be removed", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/jobUUID" } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/runners/jobs": { "get": { "summary": "List jobs", "security": [ { "OAuth2": [ "admin" ] } ], "tags": [ "Runner Jobs" ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/runnerJobSort" }, { "$ref": "#/components/parameters/search" }, { "name": "stateOneOf", "in": "query", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RunnerJobState" } } }, { "name": "typeOneOf", "in": "query", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RunnerJobType" } } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/RunnerJobAdmin" } } } } } } } } } }, "/api/v1/automatic-tags/policies/accounts/{accountName}/comments": { "get": { "tags": [ "Automatic Tags" ], "summary": "Get account auto tag policies on comments", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account name to get auto tag policies", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentAutoTagPolicies" } } } } } }, "put": { "tags": [ "Automatic Tags" ], "summary": "Update account auto tag policies on comments", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account name to update auto tag policies", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "review": { "description": "Auto tags that automatically set the comment in review state", "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/automatic-tags/accounts/{accountName}/available": { "get": { "tags": [ "Automatic Tags" ], "summary": "Get account available auto tags", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account name to get auto tag policies", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticTagAvailable" } } } } } } }, "/api/v1/automatic-tags/server/available": { "get": { "tags": [ "Automatic Tags" ], "summary": "Get server available auto tags", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticTagAvailable" } } } } } } }, "/api/v1/automatic-tags/policies/server/videos": { "get": { "tags": [ "Automatic Tags" ], "summary": "Get server auto tag policies for videos", "description": "**PeerTube >= 8.3**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoAutoTagPolicies" } } } } } }, "put": { "tags": [ "Automatic Tags" ], "summary": "Update server auto tag policies for videos", "description": "**PeerTube >= 8.3**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "autoBlock": { "description": "Auto tags that will automatically block videos matching these tags", "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/watched-words/accounts/{accountName}/lists": { "get": { "tags": [ "Watched Words" ], "summary": "List account watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account name to list watched words", "schema": { "type": "string" } } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/WatchedWordsLists" } } } } } } } } }, "post": { "tags": [ "Watched Words" ], "summary": "Add account watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "listName": { "type": "string" }, "words": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "watchedWordsList": { "type": "object", "properties": { "id": { "type": "integer" } } } } } } } } } } }, "/api/v1/watched-words/accounts/{accountName}/lists/{listId}": { "put": { "tags": [ "Watched Words" ], "summary": "Update account watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "listId", "in": "path", "required": true, "description": "list of watched words to update", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "listName": { "type": "string" }, "words": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "204": { "description": "successful operation" } } }, "delete": { "tags": [ "Watched Words" ], "summary": "Delete account watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "listId", "in": "path", "required": true, "description": "list of watched words to delete", "schema": { "type": "string" } } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/watched-words/server/lists": { "get": { "tags": [ "Watched Words" ], "summary": "List server watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/WatchedWordsLists" } } } } } } } } }, "post": { "tags": [ "Watched Words" ], "summary": "Add server watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "listName": { "type": "string" }, "words": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "watchedWordsList": { "type": "object", "properties": { "id": { "type": "integer" } } } } } } } } } } }, "/api/v1/watched-words/server/lists/{listId}": { "put": { "tags": [ "Watched Words" ], "summary": "Update server watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "name": "listId", "in": "path", "required": true, "description": "list of watched words to update", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "listName": { "type": "string" }, "words": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "204": { "description": "successful operation" } } }, "delete": { "tags": [ "Watched Words" ], "summary": "Delete server watched words", "description": "**PeerTube >= 6.2**", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "name": "listId", "in": "path", "required": true, "description": "list of watched words to delete", "schema": { "type": "string" } } ], "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/watched-words/accounts/{accountName}/subscriptions": { "get": { "tags": [ "Watched Words" ], "summary": "List account watched words subscriptions", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "description": "account name to list watched words subscriptions", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/WatchedWordsSubscription" } } } } } } } } }, "post": { "tags": [ "Watched Words" ], "summary": "Add account watched words subscription", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "url" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WatchedWordsSubscription" } } } }, "400": { "description": "cannot fetch or parse watched words URL" }, "409": { "description": "subscription already exists or watched words list with fetched name already exists" } } } }, "/api/v1/watched-words/accounts/{accountName}/subscriptions/{id}": { "delete": { "tags": [ "Watched Words" ], "summary": "Delete account watched words subscription", "security": [ { "OAuth2": [] } ], "parameters": [ { "name": "accountName", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "watched words subscription does not exist" } } } }, "/api/v1/watched-words/server/subscriptions": { "get": { "tags": [ "Watched Words" ], "summary": "List server watched words subscriptions", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/search" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/WatchedWordsSubscription" } } } } } } } } }, "post": { "tags": [ "Watched Words" ], "summary": "Add server watched words subscription", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "url" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WatchedWordsSubscription" } } } }, "400": { "description": "cannot fetch or parse watched words URL" }, "409": { "description": "subscription already exists or watched words list with fetched name already exists" } } } }, "/api/v1/watched-words/server/subscriptions/{id}": { "delete": { "tags": [ "Watched Words" ], "summary": "Delete server watched words subscription", "security": [ { "OAuth2": [ "admin", "moderator" ] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "successful operation" }, "404": { "description": "watched words subscription does not exist" } } } }, "/api/v1/client-config/update-language": { "post": { "tags": [ "Client Config" ], "summary": "Update client language", "description": "Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.", "operationId": "updateClientLanguage", "deprecated": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "language": { "type": "string", "nullable": true, "description": "Language code to set", "example": "en-US" } }, "required": [ "language" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/client-config/update-interface-language": { "post": { "tags": [ "Client Config" ], "summary": "Update client language", "description": "Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.", "operationId": "updateClientInterfaceLanguage", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "language": { "type": "string", "nullable": true, "description": "Language code to set, or `null` to clear the preference", "example": "en-US" } }, "required": [ "language" ] } } } }, "responses": { "204": { "description": "successful operation" } } } }, "/api/v1/video-channels/{channelHandle}/collaborators": { "get": { "tags": [ "Video Channels" ], "summary": "List channel collaborators", "description": "**PeerTube >= 8.0**", "operationId": "listVideoChannelCollaborators", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoChannelCollaborator" } } } } } } } } } }, "/api/v1/video-channels/{channelHandle}/collaborators/invite": { "post": { "tags": [ "Video Channels" ], "summary": "Invite a collaborator", "operationId": "inviteVideoChannelCollaborator", "description": "**PeerTube >= 8.0** Invite a local user to collaborate on the specified video channel.", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accountHandle": { "type": "string", "description": "Local user username to invite" } } } } } }, "responses": { "200": { "description": "Collaborator invited", "content": { "application/json": { "schema": { "type": "object", "properties": { "collaborator": { "$ref": "#/components/schemas/VideoChannelCollaborator" } } } } } } } } }, "/api/v1/video-channels/{channelHandle}/collaborators/{collaboratorId}/accept": { "post": { "tags": [ "Video Channels" ], "summary": "Accept a collaboration invitation", "description": "**PeerTube >= 8.0**", "operationId": "acceptVideoChannelCollaborator", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/collaboratorId" } ], "responses": { "204": { "description": "Collaboration accepted" } } } }, "/api/v1/video-channels/{channelHandle}/collaborators/{collaboratorId}/reject": { "post": { "tags": [ "Video Channels" ], "summary": "Reject a collaboration invitation", "description": "**PeerTube >= 8.0**", "operationId": "rejectVideoChannelCollaborator", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/collaboratorId" } ], "responses": { "204": { "description": "Collaboration rejected" } } } }, "/api/v1/video-channels/{channelHandle}/collaborators/{collaboratorId}": { "delete": { "tags": [ "Video Channels" ], "summary": "Remove a channel collaborator", "description": "**PeerTube >= 8.0** Only the channel owner or the collaborator themselves can remove a collaborator from a channel", "operationId": "removeVideoChannelCollaborator", "security": [ { "OAuth2": [] } ], "parameters": [ { "$ref": "#/components/parameters/channelHandle" }, { "$ref": "#/components/parameters/collaboratorId" } ], "responses": { "204": { "description": "successful operation" } } } } }, "servers": [ { "url": "https://peertube2.cpy.re", "description": "Live Test Server (live data - latest nightly version)" }, { "url": "https://peertube3.cpy.re", "description": "Live Test Server (live data - latest RC version)" }, { "url": "https://peertube.cpy.re", "description": "Live Test Server (live data - stable version)" } ], "components": { "parameters": { "start": { "name": "start", "in": "query", "required": false, "description": "Offset used to paginate results", "schema": { "type": "integer", "minimum": 0 } }, "count": { "name": "count", "in": "query", "required": false, "description": "Number of items to return", "schema": { "type": "integer", "default": 15, "maximum": 100, "minimum": 1 } }, "sort": { "name": "sort", "in": "query", "required": false, "description": "Sort column", "schema": { "type": "string", "example": "-createdAt" } }, "search": { "name": "search", "in": "query", "required": false, "description": "Plain text search, applied to various parts of the model depending on endpoint", "schema": { "type": "string" } }, "searchTarget": { "name": "searchTarget", "in": "query", "required": false, "description": "If the administrator enabled search index support, you can override the default search target.\n\n**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:\n * If the current user has the ability to make a remote URI search (this information is available in the config endpoint),\n then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database.\n After that, you can use the classic REST API endpoints to fetch the complete object or interact with it\n * If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch\n the data from the origin instance API\n", "schema": { "type": "string", "enum": [ "local", "search-index" ] } }, "mySubscriptionSort": { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "-id", "-createdAt", "-channelUpdatedAt" ] } }, "videosSort": { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "name", "-duration", "-createdAt", "-publishedAt", "-views", "-likes", "-comments", "-trending", "-hot", "-best" ], "description": "Sort videos by criteria (prefixing with `-` means `DESC` order):\n * `hot` - Adaptation of Reddit \"hot\" algorithm taking into account video views, likes, dislikes and comments and publication date\n * `best` - Same than `hot`, but also takes into account user video history\n * `trending` - Sort videos by recent views (\"recent\" is defined by the admin)\n * `views` - Sort videos using their `views` counter\n * `publishedAt` - Sort by video publication date (when it became publicly available)\n" } }, "videosSearchSort": { "name": "sort", "in": "query", "required": false, "description": "Sort videos by criteria (prefixing with `-` means `DESC` order):\n", "schema": { "type": "string", "enum": [ "name", "-duration", "-createdAt", "-publishedAt", "-views", "-likes", "-match" ] } }, "commentsSort": { "name": "sort", "in": "query", "required": false, "description": "Sort comments by criteria", "schema": { "type": "string", "enum": [ "-createdAt", "-totalReplies" ] } }, "blacklistsSort": { "name": "sort", "in": "query", "required": false, "description": "Sort blocklists by criteria", "schema": { "type": "string", "enum": [ "-id", "name", "-duration", "-views", "-likes", "-dislikes", "-uuid", "-createdAt" ] } }, "usersSearch": { "name": "search", "in": "query", "required": false, "description": "Plain text search that will match with user usernames or emails", "schema": { "type": "string" } }, "usersBlocked": { "name": "blocked", "in": "query", "required": false, "description": "Filter results down to (un)banned users", "schema": { "type": "boolean" } }, "usersRole": { "name": "role", "in": "query", "required": false, "description": "Filter results down to users with a specific role", "schema": { "$ref": "#/components/schemas/UserRole" } }, "usersSort": { "name": "sort", "in": "query", "required": false, "description": "Sort users by criteria", "schema": { "type": "string", "enum": [ "-id", "-username", "-createdAt" ] } }, "abusesSort": { "name": "sort", "in": "query", "required": false, "description": "Sort abuses by criteria", "schema": { "type": "string", "enum": [ "-id", "-createdAt", "-state" ] } }, "videoRedundanciesSort": { "name": "sort", "in": "query", "required": false, "description": "Sort abuses by criteria", "schema": { "type": "string", "enum": [ "name" ] } }, "followersSort": { "name": "sort", "in": "query", "required": false, "description": "Sort followers by criteria", "schema": { "type": "string", "enum": [ "createdAt" ] } }, "registrationTokenSort": { "name": "sort", "in": "query", "required": false, "description": "Sort registration tokens by criteria", "schema": { "type": "string", "enum": [ "createdAt" ] } }, "runnerSort": { "name": "sort", "in": "query", "required": false, "description": "Sort runners by criteria", "schema": { "type": "string", "enum": [ "createdAt" ] } }, "runnerJobSort": { "name": "sort", "in": "query", "required": false, "description": "Sort runner jobs by criteria", "schema": { "type": "string", "enum": [ "updatedAt", "createdAt", "priority", "state", "progress" ] } }, "name": { "name": "name", "in": "path", "required": true, "description": "The username or handle of the account", "schema": { "type": "string", "example": "chocobozzz | chocobozzz@example.org" } }, "id": { "name": "id", "in": "path", "required": true, "description": "Entity id", "schema": { "$ref": "#/components/schemas/id" } }, "tokenSessionId": { "name": "tokenSessionId", "in": "path", "required": true, "description": "Token session Id", "schema": { "$ref": "#/components/schemas/id" } }, "userId": { "name": "userId", "in": "path", "required": true, "description": "User id", "schema": { "$ref": "#/components/schemas/id" } }, "registrationId": { "name": "registrationId", "in": "path", "required": true, "description": "Registration ID", "schema": { "$ref": "#/components/schemas/id" } }, "idOrUUID": { "name": "id", "in": "path", "required": true, "description": "The object id, uuid or short uuid", "schema": { "oneOf": [ { "$ref": "#/components/schemas/id" }, { "$ref": "#/components/schemas/UUIDv4" }, { "$ref": "#/components/schemas/shortUUID" } ] } }, "playlistId": { "name": "playlistId", "in": "path", "required": true, "description": "Playlist id", "schema": { "$ref": "#/components/schemas/VideoPlaylist/properties/id" } }, "videoIdOrUUID": { "name": "videoIdOrUUID", "in": "path", "required": true, "description": "Video id or UUID", "schema": { "oneOf": [ { "$ref": "#/components/schemas/id" }, { "$ref": "#/components/schemas/UUIDv4" }, { "$ref": "#/components/schemas/shortUUID" } ] } }, "playlistElementId": { "name": "playlistElementId", "in": "path", "required": true, "description": "Playlist element id", "schema": { "$ref": "#/components/schemas/id" } }, "abuseId": { "name": "abuseId", "in": "path", "required": true, "description": "Abuse id", "schema": { "$ref": "#/components/schemas/Abuse/properties/id" } }, "abuseMessageId": { "name": "abuseMessageId", "in": "path", "required": true, "description": "Abuse message id", "schema": { "$ref": "#/components/schemas/AbuseMessage/properties/id" } }, "captionLanguage": { "name": "captionLanguage", "in": "path", "required": true, "description": "The caption language", "schema": { "$ref": "#/components/schemas/VideoLanguageSet" } }, "channelHandle": { "name": "channelHandle", "in": "path", "required": true, "description": "The video channel handle", "schema": { "type": "string", "example": "my_username | my_username@example.com" } }, "channelSyncId": { "name": "channelSyncId", "in": "path", "required": true, "description": "Channel Sync id", "schema": { "$ref": "#/components/schemas/Abuse/properties/id" } }, "subscriptionHandle": { "name": "subscriptionHandle", "in": "path", "required": true, "description": "The subscription handle", "schema": { "type": "string", "example": "my_username | my_username@example.com" } }, "threadId": { "name": "threadId", "in": "path", "required": true, "description": "The thread id (root comment id)", "schema": { "type": "integer" } }, "commentId": { "name": "commentId", "in": "path", "required": true, "description": "The comment id", "schema": { "$ref": "#/components/schemas/VideoComment/properties/id" } }, "isLive": { "name": "isLive", "in": "query", "required": false, "description": "whether or not the video is a live", "schema": { "type": "boolean" } }, "includeScheduledLive": { "name": "includeScheduledLive", "in": "query", "required": false, "description": "whether or not include live that are scheduled for later", "schema": { "type": "boolean" } }, "categoryOneOf": { "name": "categoryOneOf", "in": "query", "required": false, "description": "category id of the video (see [/videos/categories](#operation/getCategories))", "schema": { "oneOf": [ { "$ref": "#/components/schemas/VideoCategorySet" }, { "type": "array", "items": { "$ref": "#/components/schemas/VideoCategorySet" } } ] }, "style": "form", "explode": true }, "tagsOneOf": { "name": "tagsOneOf", "in": "query", "required": false, "description": "tag(s) of the video", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "maxItems": 5, "items": { "type": "string" } } ] }, "style": "form", "explode": true }, "tagsAllOf": { "name": "tagsAllOf", "in": "query", "required": false, "description": "tag(s) of the video, where all should be present in the video", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "style": "form", "explode": true }, "languageOneOf": { "name": "languageOneOf", "in": "query", "required": false, "description": "language id of the video (see [/videos/languages](#operation/getLanguages)). Use `_unknown` to filter on videos that don't have a video language", "schema": { "oneOf": [ { "$ref": "#/components/schemas/VideoLanguageSet" }, { "type": "array", "items": { "$ref": "#/components/schemas/VideoLanguageSet" } } ] }, "style": "form", "explode": true }, "autoTagOneOfVideo": { "name": "autoTagOneOf", "in": "query", "required": false, "description": "**PeerTube >= 6.2** **Admins and moderators only** filter on videos that contain one of these automatic tags", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "style": "form", "explode": true }, "stateOneOfVideo": { "name": "stateOneOf", "in": "query", "required": false, "description": "**PeerTube >= 8.2** **Admins and moderators only** filter on videos that have one of these states", "schema": { "oneOf": [ { "$ref": "#/components/schemas/VideoStateConstant/properties/id" }, { "type": "array", "items": { "$ref": "#/components/schemas/VideoStateConstant/properties/id" } } ] }, "style": "form", "explode": true }, "channelNameOneOf": { "name": "channelNameOneOf", "in": "query", "required": false, "description": "**PeerTube >= 7.2** Filter on videos that are published by a channel with one of these names", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "style": "form", "explode": true }, "autoTagOneOfComment": { "name": "autoTagOneOf", "in": "query", "required": false, "description": "**PeerTube >= 6.2** filter on comments that contain one of these automatic tags", "schema": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "style": "form", "explode": true }, "isHeldForReview": { "name": "isHeldForReview", "in": "query", "required": false, "description": "only display comments that are held for review", "schema": { "type": "boolean" } }, "licenceOneOf": { "name": "licenceOneOf", "in": "query", "required": false, "description": "licence id of the video (see [/videos/licences](#operation/getLicences))", "schema": { "oneOf": [ { "$ref": "#/components/schemas/VideoLicenceSet" }, { "type": "array", "items": { "$ref": "#/components/schemas/VideoLicenceSet" } } ] }, "style": "form", "explode": true }, "skipCount": { "name": "skipCount", "in": "query", "required": false, "description": "if you don't need the `total` in the response", "schema": { "type": "string", "enum": [ "true", "false" ], "default": "false" } }, "nsfw": { "name": "nsfw", "in": "query", "required": false, "description": "whether to include nsfw videos, if any", "schema": { "type": "string", "enum": [ "true", "false" ] } }, "nsfwFlagsIncluded": { "name": "nsfwFlagsIncluded", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/NSFWFlag" } }, "nsfwFlagsExcluded": { "name": "nsfwFlagsExcluded", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/NSFWFlag" } }, "isLocal": { "name": "isLocal", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "**PeerTube >= 4.0** Display only local or remote objects" }, "hasHLSFiles": { "name": "hasHLSFiles", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "**PeerTube >= 4.0** Display only videos that have HLS files" }, "hasWebVideoFiles": { "name": "hasWebVideoFiles", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "**PeerTube >= 6.0** Display only videos that have Web Video files" }, "privacyOneOf": { "name": "privacyOneOf", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/VideoPrivacySet" }, "description": "**PeerTube >= 4.0** Display only videos in this specific privacy/privacies" }, "excludeAlreadyWatched": { "name": "excludeAlreadyWatched", "in": "query", "description": "Whether or not to exclude videos that are in the user's video history", "schema": { "type": "boolean" } }, "uuids": { "name": "uuids", "in": "query", "required": false, "schema": { "items": { "type": "string" } }, "description": "Find elements with specific UUIDs" }, "host": { "name": "host", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Find elements owned by this host" }, "handles": { "name": "handles", "in": "query", "required": false, "schema": { "items": { "type": "string" } }, "description": "Find elements with these handles" }, "include": { "name": "include", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1, 2, 4, 8, 16, 32 ] }, "description": "**Only administrators and moderators can use this parameter**\n\nInclude additional videos in results (can be combined using bitwise or operator)\n- `0` NONE\n- `1` NOT_PUBLISHED_STATE\n- `2` BLACKLISTED\n- `4` BLOCKED_OWNER\n- `8` FILES\n- `16` CAPTIONS\n- `32` VIDEO SOURCE\n" }, "subscriptionsUris": { "name": "uris", "in": "query", "required": true, "description": "list of uris to check if each is part of the user subscriptions", "schema": { "type": "array", "items": { "type": "string", "format": "uri" } } }, "npmName": { "name": "npmName", "in": "path", "required": true, "description": "name of the plugin/theme on npmjs.com or in its package.json", "schema": { "type": "string", "example": "peertube-plugin-auth-ldap" } }, "jobType": { "name": "jobType", "in": "query", "required": false, "description": "job type", "schema": { "type": "string", "enum": [ "activitypub-follow", "activitypub-http-broadcast", "activitypub-http-fetcher", "activitypub-http-unicast", "email", "video-transcoding", "video-file-import", "video-import", "videos-stats", "activitypub-refresher", "video-redundancy", "video-live-ending", "video-channel-import" ] } }, "followState": { "name": "state", "in": "query", "schema": { "type": "string", "enum": [ "pending", "accepted" ] } }, "actorType": { "name": "actorType", "in": "query", "schema": { "type": "string", "enum": [ "Person", "Application", "Group", "Service", "Organization" ] } }, "staticFilename": { "name": "filename", "in": "path", "required": true, "description": "Filename", "schema": { "type": "string" } }, "videoFileToken": { "name": "videoFileToken", "in": "query", "required": false, "description": "Video file token [generated](#operation/requestVideoToken) by PeerTube so you don't need to provide an OAuth token in the request header.", "schema": { "type": "string" } }, "reinjectVideoFileToken": { "name": "reinjectVideoFileToken", "in": "query", "required": false, "description": "Ask the server to reinject videoFileToken in URLs in m3u8 playlist", "schema": { "type": "boolean" } }, "videoPlaylistType": { "name": "playlistType", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/VideoPlaylistTypeSet" } }, "registrationTokenId": { "name": "registrationTokenId", "in": "path", "required": true, "schema": { "type": "integer" } }, "runnerId": { "name": "runnerId", "in": "path", "required": true, "schema": { "type": "integer" } }, "jobUUID": { "name": "jobUUID", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/UUIDv4" } }, "passwordId": { "name": "passwordId", "in": "path", "required": true, "description": "The video password id", "schema": { "$ref": "#/components/schemas/id" } }, "onLocalVideo": { "name": "onLocalVideo", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "Display only objects of local or remote videos" }, "includeMuted": { "name": "includeMuted", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "**PeerTube >= 8.2** Include comments from muted accounts" }, "videoChannelId": { "name": "videoChannelId", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Limit results on this specific video channel" }, "videoId": { "name": "videoId", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Limit results on this specific video" }, "searchVideoForComments": { "name": "searchVideo", "in": "query", "required": false, "description": "Filter comments by searching on the video", "schema": { "type": "string" } }, "searchAccountForComments": { "name": "searchAccount", "in": "query", "required": false, "description": "Filter comments by searching on the account", "schema": { "type": "string" } }, "videoPasswordHeader": { "name": "x-peertube-video-password", "description": "Required on password protected video", "in": "header", "required": false, "schema": { "type": "string" } }, "resumableUploadInitContentLengthHeader": { "name": "X-Upload-Content-Length", "in": "header", "schema": { "type": "number", "example": 2469036 }, "required": true, "description": "Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading." }, "resumableUploadInitContentTypeHeader": { "name": "X-Upload-Content-Type", "in": "header", "schema": { "type": "string", "format": "mimetype", "example": "video/mp4" }, "required": true, "description": "MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary." }, "resumableUploadChunkContentRangeHeader": { "name": "Content-Range", "in": "header", "schema": { "type": "string", "example": "bytes 0-262143/2469036" }, "required": true, "description": "Specifies the bytes in the file that the request is uploading.\n\nFor example, a value of `bytes 0-262143/1000000` shows that the request is sending the first\n262144 bytes (256 x 1024) in a 2,469,036 byte file.\n" }, "resumableUploadChunkContentLengthHeader": { "name": "Content-Length", "in": "header", "schema": { "type": "number", "example": 262144 }, "required": true, "description": "Size of the chunk that the request is sending.\n\nRemember that larger chunks are more efficient. PeerTube's web client uses chunks varying from\n1048576 bytes (~1MB) and increases or reduces size depending on connection health.\n" }, "resumableUploadId": { "name": "upload_id", "in": "query", "required": true, "description": "Created session id to proceed with. If you didn't send chunks in the last hour, it is\nnot valid anymore and you need to initialize a new upload.\n", "schema": { "type": "string" } }, "logoTypeParam": { "name": "logoType", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "favicon", "header-wide", "header-square", "opengraph" ] } }, "includeCollaborations": { "name": "includeCollaborations", "in": "query", "required": false, "description": "**PeerTube >= 8.0** Include objects from collaborated channels", "schema": { "type": "boolean" } }, "collaboratorId": { "name": "collaboratorId", "in": "path", "required": true, "description": "The collaborator id", "schema": { "$ref": "#/components/schemas/id" } } }, "securitySchemes": { "OAuth2": { "description": "Authenticating via OAuth requires the following steps:\n- Have an activated account\n- [Generate] an access token for that account at `/api/v1/users/token`.\n- Make requests with the *Authorization: Bearer * header\n- Profit, depending on the role assigned to the account\n\nNote that the __access token is valid for 1 day__ and is given\nalong with a __refresh token valid for 2 weeks__.\n\n[Generate]: https://docs.joinpeertube.org/api/rest-getting-started\n", "type": "oauth2", "flows": { "password": { "tokenUrl": "/api/v1/users/token", "scopes": { "admin": "Admin scope", "moderator": "Moderator scope", "user": "User scope" } } } } }, "schemas": { "id": { "type": "integer", "minimum": 1, "example": 42 }, "UUIDv4": { "type": "string", "format": "uuid", "example": "9c9de5e8-0a1e-484a-b099-e80766180a6d", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "minLength": 36, "maxLength": 36 }, "shortUUID": { "type": "string", "description": "translation of a uuid v4 with a bigger alphabet to have a shorter uuid", "example": "2y84q2MQUMWPbiEcxNXMgC" }, "username": { "type": "string", "description": "immutable name of the user, used to find or mention its actor", "example": "chocobozzz", "pattern": "/^[a-z0-9._]+$/", "minLength": 1, "maxLength": 50 }, "usernameChannel": { "type": "string", "description": "immutable name of the channel, used to interact with its actor", "example": "framasoft_videos", "pattern": "/^[a-zA-Z0-9\\\\-_.:]+$/", "minLength": 1, "maxLength": 50 }, "password": { "type": "string", "format": "password", "minLength": 6, "maxLength": 50 }, "VideoCategorySet": { "type": "integer", "description": "category id of the video (see [/videos/categories](#operation/getCategories))", "example": 15 }, "VideoConstantNumber-Category": { "properties": { "id": { "$ref": "#/components/schemas/VideoCategorySet" }, "label": { "type": "string", "example": "Science & Technology" } } }, "VideoLicenceSet": { "type": "integer", "description": "licence id of the video (see [/videos/licences](#operation/getLicences))", "example": 2 }, "VideoConstantNumber-Licence": { "properties": { "id": { "$ref": "#/components/schemas/VideoLicenceSet" }, "label": { "type": "string", "example": "Attribution - Share Alike" } } }, "VideoLanguageSet": { "type": "string", "description": "language id of the video (see [/videos/languages](#operation/getLanguages))", "example": "en" }, "VideoConstantString-Language": { "properties": { "id": { "$ref": "#/components/schemas/VideoLanguageSet" }, "label": { "type": "string", "example": "English" } } }, "VideoPlaylistPrivacySet": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "Video playlist privacy policy (see [/video-playlists/privacies](#operation/getPlaylistPrivacyPolicies))" }, "VideoPlaylistPrivacyConstant": { "properties": { "id": { "$ref": "#/components/schemas/VideoPlaylistPrivacySet" }, "label": { "type": "string" } } }, "VideoPlaylistTypeSet": { "type": "integer", "enum": [ 1, 2 ], "description": "The video playlist type (Regular = `1`, Watch Later = `2`)" }, "VideoPlaylistTypeConstant": { "properties": { "id": { "$ref": "#/components/schemas/VideoPlaylistTypeSet" }, "label": { "type": "string" } } }, "VideoPrivacySet": { "type": "integer", "enum": [ 1, 2, 3, 4, 5 ], "description": "privacy id of the video (see [/videos/privacies](#operation/getVideoPrivacyPolicies))" }, "VideoPrivacyConstant": { "properties": { "id": { "$ref": "#/components/schemas/VideoPrivacySet" }, "label": { "type": "string" } } }, "VideoCommentsPolicySet": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "Comments policy of the video (Enabled = `1`, Disabled = `2`, Requires Approval = `3`)" }, "VideoCommentsPolicyConstant": { "properties": { "id": { "$ref": "#/components/schemas/VideoCommentsPolicySet" }, "label": { "type": "string" } } }, "BlockStatus": { "properties": { "accounts": { "type": "object", "additionalProperties": { "x-additionalPropertiesName": "account", "type": "object", "properties": { "blockedByServer": { "type": "boolean" }, "blockedByServerSubscription": { "type": "string" }, "blockedByUser": { "type": "boolean" } } } }, "hosts": { "type": "object", "additionalProperties": { "x-additionalPropertiesName": "host", "type": "object", "properties": { "blockedByServer": { "type": "boolean" }, "blockedByServerSubscription": { "type": "string" }, "blockedByUser": { "type": "boolean" } } } } } }, "NSFWPolicy": { "type": "string", "enum": [ "display", "warn", "do_not_list" ] }, "NSFWFlag": { "type": "integer", "enum": [ 0, 1, 2, 4 ], "description": "\nNSFW flags (can be combined using bitwise or operator)\n- `0` NONE\n- `1` VIOLENT\n- `2` EXPLICIT_SEX\n" }, "UserRole": { "type": "integer", "enum": [ 0, 1, 2 ], "description": "The user role (Admin = `0`, Moderator = `1`, User = `2`)", "example": 2 }, "UserAdminFlags": { "type": "integer", "enum": [ 0, 1 ], "description": "Admin flags for the user (None = `0`, Bypass video blocklist = `1`)", "example": 1 }, "LiveVideoLatencyMode": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The live latency mode (Default = `1`, High latency = `2`, Small Latency = `3`)" }, "LiveVideoReplaySettings": { "type": "object", "properties": { "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" } } }, "VideoChannelActivityAction": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ], "description": "The activity action:\n - CREATE: 1\n - UPDATE: 2\n - DELETE: 3\n - UPDATE_CAPTIONS: 4\n - UPDATE_CHAPTERS: 5\n - UPDATE_PASSWORDS: 6\n - CREATE_STUDIO_TASKS: 7\n - UPDATE_SOURCE_FILE: 8\n - UPDATE_ELEMENTS: 9\n - REMOVE_CHANNEL_OWNERSHIP: 10\n - CREATE_CHANNEL_OWNERSHIP: 11\n" }, "VideoChannelActivityTarget": { "type": "integer", "enum": [ 1, 2, 3, 4, 5 ], "description": "The activity target:\n - VIDEO: 1,\n - PLAYLIST: 2,\n - CHANNEL: 3,\n - CHANNEL_SYNC: 4,\n - VIDEO_IMPORT: 5\n" }, "VideoStateConstant": { "properties": { "id": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9 ], "description": "The video state:\n- `1`: Published\n- `2`: To transcode\n- `3`: To import\n- `4`: Waiting for live stream\n- `5`: Live ended\n- `6`: To move to an external storage (object storage...)\n- `7`: Transcoding failed\n- `8`: Moving to an external storage failed\n- `9`: To edit using studio edition feature\n" }, "label": { "type": "string" } } }, "UserExportState": { "type": "integer", "enum": [ 1, 2, 3, 4 ], "description": "The user export state:\n - `1`: Pending\n - `2`: Processing\n - `3`: Completed\n - `4`: Errored\n" }, "UserImportState": { "type": "integer", "enum": [ 1, 2, 3, 4 ], "description": "The user import state:\n - `1`: Pending\n - `2`: Processing\n - `3`: Completed\n - `4`: Errored\n" }, "AbuseStateSet": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The abuse state (Pending = `1`, Rejected = `2`, Accepted = `3`)" }, "AbuseStateConstant": { "properties": { "id": { "$ref": "#/components/schemas/AbuseStateSet" }, "label": { "type": "string" } } }, "AbusePredefinedReasons": { "type": "array", "items": { "type": "string", "enum": [ "violentOrAbusive", "hatefulOrAbusive", "spamOrMisleading", "privacy", "rights", "serverRules", "thumbnails", "captions" ] }, "example": [ "spamOrMisleading" ] }, "VideoResolutionSet": { "type": "integer", "description": "Video resolution (`0`, `240`, `360`, `720`, `1080`, `1440` or `2160`)\n\n`0` is used as a special value for stillimage videos dedicated to audio, a.k.a. audio-only videos.\n", "example": 240 }, "VideoResolutionConstant": { "description": "resolutions and their labels for the video", "properties": { "id": { "$ref": "#/components/schemas/VideoResolutionSet" }, "label": { "type": "string", "example": "240p" } } }, "VideoScheduledUpdate": { "properties": { "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" }, "updateAt": { "type": "string", "format": "date-time", "description": "When to update the video" } }, "required": [ "updateAt" ] }, "AccountSummary": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "displayName": { "type": "string" }, "url": { "type": "string", "format": "url" }, "host": { "type": "string", "format": "hostname" }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } }, "VideoSummary": { "properties": { "id": { "description": "object id for the video", "allOf": [ { "$ref": "#/components/schemas/id" } ] }, "uuid": { "description": "universal identifier for the video, that can be used across instances", "allOf": [ { "$ref": "#/components/schemas/UUIDv4" } ] }, "shortUUID": { "allOf": [ { "$ref": "#/components/schemas/shortUUID" } ] }, "name": { "type": "string" }, "isLive": { "type": "boolean" }, "nsfw": { "type": "boolean" }, "publishedAt": { "type": "string", "format": "date-time" }, "thumbnails": { "description": "**PeerTube >= 8.1** Array of thumbnails for the video", "type": "array" }, "channel": { "$ref": "#/components/schemas/VideoChannelSummary" } } }, "VideoChannelSummary": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "displayName": { "type": "string" }, "url": { "type": "string", "format": "url" }, "host": { "type": "string", "format": "hostname" }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } }, "PlaylistElement": { "properties": { "position": { "type": "integer" }, "startTimestamp": { "type": "integer", "format": "seconds" }, "stopTimestamp": { "type": "integer", "format": "seconds" }, "video": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/Video" } ] } } }, "Thumbnail": { "properties": { "fileUrl": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "aspectRatio": { "type": "string", "example": "16:9" } } }, "VideoFile": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "magnetUri": { "type": "string", "format": "uri", "description": "magnet URI allowing to resolve the video via BitTorrent without a metainfo file", "pattern": "/magnet:\\?xt=urn:[a-z0-9]+:[a-z0-9]{32}/i" }, "resolution": { "$ref": "#/components/schemas/VideoResolutionConstant" }, "size": { "type": "integer", "description": "Video file size in bytes" }, "torrentUrl": { "type": "string", "description": "Direct URL of the torrent file", "format": "url" }, "torrentDownloadUrl": { "type": "string", "description": "URL endpoint that transfers the torrent file as an attachment (so that the browser opens a download dialog)", "format": "url" }, "fileUrl": { "type": "string", "description": "Direct URL of the video", "format": "url" }, "playlistUrl": { "type": "string", "description": "Playlist URL of the file if it is owned by a playlist", "format": "url" }, "fileDownloadUrl": { "type": "string", "description": "URL endpoint that transfers the video file as an attachment (so that the browser opens a download dialog)", "format": "url" }, "fps": { "type": "number", "description": "Frames per second of the video file" }, "width": { "type": "number", "description": "**PeerTube >= 6.1** Video stream width" }, "height": { "type": "number", "description": "**PeerTube >= 6.1** Video stream height" }, "metadataUrl": { "type": "string", "format": "url", "description": "URL dereferencing the output of ffprobe on the file" }, "hasAudio": { "type": "boolean", "description": "**PeerTube >= 6.2** The file container has an audio stream" }, "hasVideo": { "type": "boolean", "description": "**PeerTube >= 6.2** The file container has a video stream" }, "storage": { "$ref": "#/components/schemas/FileStorage" } } }, "VideoStreamingPlaylists": { "allOf": [ { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "type": { "type": "integer", "enum": [ 1 ], "description": "Playlist type:\n- `1`: HLS\n" } } }, { "$ref": "#/components/schemas/VideoStreamingPlaylists-HLS" } ] }, "VideoStreamingPlaylists-HLS": { "properties": { "playlistUrl": { "type": "string", "format": "url" }, "segmentsSha256Url": { "type": "string", "format": "url" }, "files": { "type": "array", "description": "Video files associated to this playlist.\n\nThe difference with the root `files` property is that these files are fragmented, so they can be used in this streaming playlist (HLS, etc.)\n", "items": { "$ref": "#/components/schemas/VideoFile" } }, "redundancies": { "type": "array", "items": { "type": "object", "properties": { "baseUrl": { "type": "string", "format": "url" } } } } } }, "VideoInfo": { "properties": { "id": { "$ref": "#/components/schemas/Video/properties/id" }, "uuid": { "$ref": "#/components/schemas/Video/properties/uuid" }, "name": { "$ref": "#/components/schemas/Video/properties/name" }, "state": { "$ref": "#/components/schemas/Video/properties/state" } } }, "Video": { "properties": { "id": { "description": "object id for the video", "allOf": [ { "$ref": "#/components/schemas/id" } ] }, "uuid": { "description": "universal identifier for the video, that can be used across instances", "allOf": [ { "$ref": "#/components/schemas/UUIDv4" } ] }, "shortUUID": { "allOf": [ { "$ref": "#/components/schemas/shortUUID" } ] }, "isLive": { "type": "boolean" }, "liveSchedules": { "type": "array", "items": { "$ref": "#/components/schemas/LiveSchedule" } }, "createdAt": { "type": "string", "format": "date-time", "example": "2017-10-01T10:52:46.396Z", "description": "time at which the video object was first drafted" }, "publishedAt": { "type": "string", "format": "date-time", "example": "2018-10-01T10:52:46.396Z", "description": "time at which the video was marked as ready for playback (with restrictions depending on `privacy`). Usually set after a `state` evolution." }, "updatedAt": { "type": "string", "format": "date-time", "example": "2021-05-04T08:01:01.502Z", "description": "last time the video's metadata was modified" }, "originallyPublishedAt": { "type": "string", "nullable": true, "format": "date-time", "example": "2010-10-01T10:52:46.396Z", "description": "used to represent a date of first publication, prior to the practical publication date of `publishedAt`" }, "category": { "allOf": [ { "$ref": "#/components/schemas/VideoConstantNumber-Category" } ], "description": "category in which the video is classified" }, "licence": { "allOf": [ { "$ref": "#/components/schemas/VideoConstantNumber-Licence" } ], "description": "licence under which the video is distributed" }, "language": { "allOf": [ { "$ref": "#/components/schemas/VideoConstantString-Language" } ], "description": "main language used in the video" }, "privacy": { "allOf": [ { "$ref": "#/components/schemas/VideoPrivacyConstant" } ], "description": "privacy policy used to distribute the video" }, "truncatedDescription": { "type": "string", "nullable": true, "example": "**[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", "minLength": 3, "maxLength": 250, "description": "truncated description of the video, written in Markdown.\n" }, "duration": { "type": "integer", "example": 1419, "format": "seconds", "description": "duration of the video in seconds" }, "aspectRatio": { "type": "number", "nullable": true, "format": "float", "example": 1.778, "description": "**PeerTube >= 6.1** Aspect ratio of the video stream" }, "isLocal": { "type": "boolean" }, "name": { "type": "string", "description": "title of the video", "example": "What is PeerTube?", "minLength": 3, "maxLength": 120 }, "thumbnailPath": { "description": "Deprecated in PeerTube v8.1, use thumbnails instead", "deprecated": true, "type": "string" }, "previewPath": { "description": "Deprecated in PeerTube v8.1, use thumbnails instead", "deprecated": true, "type": "string" }, "thumbnails": { "description": "**PeerTube >= 8.1** Array of thumbnails for the video", "type": "array", "items": { "$ref": "#/components/schemas/Thumbnail" } }, "embedPath": { "type": "string", "example": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee" }, "views": { "type": "integer", "example": 1337 }, "likes": { "type": "integer", "example": 42 }, "dislikes": { "type": "integer", "example": 7 }, "comments": { "description": "**PeerTube >= 7.2** Number of comments on the video", "type": "integer" }, "nsfw": { "type": "boolean" }, "nsfwFlags": { "allOf": [ { "$ref": "#/components/schemas/NSFWFlag" } ] }, "nsfwSummary": { "type": "string", "description": "**PeerTube >= 7.2** More information about the sensitive content of the video" }, "waitTranscoding": { "type": "boolean", "nullable": true }, "state": { "allOf": [ { "$ref": "#/components/schemas/VideoStateConstant" } ], "description": "represents the internal state of the video processing within the PeerTube instance" }, "scheduledUpdate": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/VideoScheduledUpdate" } ] }, "blacklisted": { "nullable": true, "type": "boolean" }, "blacklistedReason": { "nullable": true, "type": "string" }, "account": { "$ref": "#/components/schemas/AccountSummary" }, "channel": { "$ref": "#/components/schemas/VideoChannelSummary" }, "userHistory": { "nullable": true, "type": "object", "properties": { "currentTime": { "type": "integer" } } } } }, "ServerError": { "properties": { "type": { "type": "string", "example": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/video_requires_password" }, "detail": { "type": "string", "example": "Please provide a password to access this password protected video" }, "status": { "type": "integer", "example": 403 }, "code": { "type": "string", "example": "video_requires_password" } } }, "VideoDetails": { "allOf": [ { "$ref": "#/components/schemas/Video" }, { "type": "object", "properties": { "viewers": { "type": "integer", "description": "If the video is a live, you have the amount of current viewers" }, "description": { "type": "string", "nullable": true, "example": "\"**[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", "minLength": 3, "maxLength": 1000, "description": "full description of the video, written in Markdown.\n" }, "support": { "type": "string", "nullable": true, "description": "A text tell the audience how to support the video creator", "example": "Please support our work on https://soutenir.framasoft.org/en/ <3", "minLength": 3, "maxLength": 1000 }, "channel": { "$ref": "#/components/schemas/VideoChannel" }, "account": { "$ref": "#/components/schemas/Account" }, "tags": { "example": [ "flowers", "gardening" ], "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "string", "minLength": 2, "maxLength": 30 } }, "commentsPolicy": { "$ref": "#/components/schemas/VideoCommentsPolicyConstant" }, "downloadEnabled": { "type": "boolean" }, "inputFileUpdatedAt": { "type": "string", "format": "date-time", "nullable": true, "description": "Latest input file update. Null if the file has never been replaced since the original upload" }, "trackerUrls": { "type": "array", "items": { "type": "string", "format": "url" }, "example": [ "https://peertube2.cpy.re/tracker/announce", "wss://peertube2.cpy.re/tracker/socket" ] }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/VideoFile" }, "description": "Web compatible video files. If Web Video is disabled on the server:\n\n- field will be empty\n- video files will be found in `streamingPlaylists[].files` field\n" }, "streamingPlaylists": { "type": "array", "items": { "$ref": "#/components/schemas/VideoStreamingPlaylists" }, "description": "HLS playlists/manifest files. If HLS is disabled on the server:\n\n- field will be empty\n- video files will be found in `files` field\n" } } } ] }, "FileRedundancyInformation": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "fileUrl": { "type": "string", "format": "url" }, "strategy": { "type": "string", "enum": [ "manual", "most-views", "trending", "recently-added" ] }, "size": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "expiresOn": { "type": "string", "format": "date-time" } } }, "VideoRedundancy": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "url": { "type": "string", "format": "url" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "redundancies": { "type": "object", "properties": { "streamingPlaylists": { "type": "array", "items": { "$ref": "#/components/schemas/FileRedundancyInformation" } } } } } }, "AccountBlock": { "properties": { "byAccount": { "$ref": "#/components/schemas/Account" }, "blockedAccount": { "$ref": "#/components/schemas/Account", "type": "boolean" }, "blocklistSubscription": { "$ref": "#/components/schemas/BlocklistSubscriptionSummary", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } } }, "ServerBlock": { "properties": { "byAccount": { "$ref": "#/components/schemas/Account" }, "blockedServer": { "type": "object", "properties": { "host": { "type": "string", "format": "hostname" } } }, "blocklistSubscription": { "$ref": "#/components/schemas/BlocklistSubscriptionSummary", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } } }, "BlocklistSubscription": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "url": { "type": "string", "format": "url" }, "mutedAccountsCount": { "type": "integer", "minimum": 0 }, "mutedServersCount": { "type": "integer", "minimum": 0 }, "lastSyncAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "BlocklistSubscriptionSummary": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "url": { "type": "string", "format": "url" } } }, "BlocklistLog": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "action": { "type": "string", "enum": [ "add", "delete" ] }, "target": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } } }, "AutoMuteList": { "properties": { "name": { "type": "string" }, "actions": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "block", "unblock" ] }, "target": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } } } } } }, "CommentAutoTagPolicies": { "properties": { "review": { "type": "array", "description": "Auto tags that automatically set the comment in review state", "items": { "type": "string" } } } }, "VideoAutoTagPolicies": { "properties": { "autoBlock": { "type": "array", "description": "Auto tags that will automatically block videos matching these tags", "items": { "type": "string" } } } }, "AutomaticTagAvailable": { "properties": { "available": { "type": "array", "description": "Available auto tags that can be used to filter objects or set a comment in review state", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "tag name" }, "type": { "type": "string", "enum": [ "core", "watched-words-list" ] } } } } } }, "VideoImportStateConstant": { "properties": { "id": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The video import state (Pending = `1`, Success = `2`, Failed = `3`)" }, "label": { "type": "string", "example": "Pending" } } }, "VideoCreateImport": { "allOf": [ { "type": "object", "additionalProperties": false, "oneOf": [ { "properties": { "targetUrl": { "$ref": "#/components/schemas/VideoImport/properties/targetUrl" } }, "required": [ "targetUrl" ] }, { "properties": { "magnetUri": { "$ref": "#/components/schemas/VideoImport/properties/magnetUri" } }, "required": [ "magnetUri" ] }, { "properties": { "torrentfile": { "$ref": "#/components/schemas/VideoImport/properties/torrentfile" } }, "required": [ "torrentfile" ] } ] }, { "$ref": "#/components/schemas/VideoUploadRequestCommon" } ], "required": [ "channelId", "name" ] }, "VideoImport": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "targetUrl": { "type": "string", "format": "url", "description": "remote URL where to find the import's source video", "example": "https://framatube.org/videos/watch/9c9de5e8-0a1e-484a-b099-e80766180a6d" }, "magnetUri": { "type": "string", "format": "uri", "description": "magnet URI allowing to resolve the import's source video", "pattern": "/magnet:\\?xt=urn:[a-z0-9]+:[a-z0-9]{32}/i" }, "torrentfile": { "type": "string", "format": "binary", "description": "Torrent file containing only the video file" }, "torrentName": { "type": "string" }, "state": { "allOf": [ { "$ref": "#/components/schemas/VideoImportStateConstant" } ] }, "error": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "video": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/Video" } ] } } }, "VideoImportsList": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/VideoImport" } } } }, "Abuse": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "reason": { "type": "string", "example": "The video is a spam", "minLength": 2, "maxLength": 3000 }, "predefinedReasons": { "$ref": "#/components/schemas/AbusePredefinedReasons" }, "reporterAccount": { "$ref": "#/components/schemas/Account" }, "state": { "$ref": "#/components/schemas/AbuseStateConstant" }, "moderationComment": { "type": "string", "example": "Decided to ban the server since it spams us regularly", "minLength": 2, "maxLength": 3000 }, "video": { "type": "object", "properties": { "id": { "type": "integer" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "$ref": "#/components/schemas/shortUUID" }, "name": { "type": "string" }, "nsfw": { "type": "boolean" }, "startAt": { "type": "string", "format": "date-time" }, "endAt": { "type": "string", "format": "date-time" }, "deleted": { "type": "boolean" }, "blacklisted": { "type": "boolean" }, "thumbnailPath": { "description": "Deprecated in PeerTube v8.1, use thumbnails instead", "deprecated": true, "type": "string" }, "thumbnails": { "description": "**PeerTube >= 8.1** Array of thumbnails for the video", "type": "array", "items": { "$ref": "#/components/schemas/Thumbnail" } }, "channel": { "$ref": "#/components/schemas/VideoChannel" } } }, "createdAt": { "type": "string", "format": "date-time" } } }, "AbuseMessage": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "message": { "type": "string", "minLength": 2, "maxLength": 3000 }, "byModerator": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "account": { "$ref": "#/components/schemas/AccountSummary" } } }, "VideoBlacklist": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "reason": { "type": "string", "description": "Reason for the block (public)" }, "internalNote": { "type": "string", "description": "Internal note for moderators/admins" }, "unfederated": { "type": "boolean" }, "type": { "type": "integer", "description": "- `1`: manual block - `2`: automatic block by instance policy - `3`: automatic block by auto-tag policy\n" }, "video": { "$ref": "#/components/schemas/Video" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "VideoBlacklistCreate": { "type": "object", "properties": { "reason": { "type": "string", "description": "Reason for the block (public)" }, "unfederate": { "type": "boolean", "description": "Whether to unfederate the video" }, "internalNote": { "type": "string", "description": "Internal note for moderators/admins" } } }, "VideoBlacklistUpdate": { "type": "object", "properties": { "reason": { "type": "string", "description": "Reason for the block (displayed publicly)" }, "internalNote": { "type": "string", "description": "Internal note for moderators/admins" } } }, "ChangeOwnership": { "type": "object", "description": "Representation of a ownership change", "properties": { "id": { "$ref": "#/components/schemas/id" }, "state": { "properties": { "id": { "$ref": "#/components/schemas/ChangeOwnershipState" }, "label": { "type": "string" } } }, "initiatorAccount": { "$ref": "#/components/schemas/Account" }, "nextOwnerAccount": { "$ref": "#/components/schemas/Account" }, "video": { "$ref": "#/components/schemas/VideoSummary" }, "videoChannel": { "$ref": "#/components/schemas/VideoChannelSummary" }, "createdAt": { "type": "string", "format": "date-time" } } }, "VideoPlaylist": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "allOf": [ { "$ref": "#/components/schemas/shortUUID" } ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "description": { "type": "string", "minLength": 3, "maxLength": 1000 }, "displayName": { "type": "string", "minLength": 1, "maxLength": 120 }, "isLocal": { "type": "boolean" }, "videoLength": { "type": "integer", "minimum": 0 }, "thumbnailPath": { "description": "Deprecated in PeerTube v8.1, use thumbnails instead", "deprecated": true, "type": "string" }, "thumbnails": { "description": "**PeerTube >= 8.1** Array of thumbnails for the playlist", "type": "array", "items": { "$ref": "#/components/schemas/Thumbnail" } }, "privacy": { "$ref": "#/components/schemas/VideoPlaylistPrivacyConstant" }, "type": { "$ref": "#/components/schemas/VideoPlaylistTypeConstant" }, "ownerAccount": { "$ref": "#/components/schemas/AccountSummary" }, "videoChannel": { "$ref": "#/components/schemas/VideoChannelSummary" }, "videoChannelPosition": { "type": "integer", "minimum": 1, "description": "Position of the playlist in the channel" } } }, "VideoComment": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "url": { "type": "string", "format": "url" }, "text": { "type": "string", "format": "html", "description": "Text of the comment", "minLength": 1, "example": "This video is wonderful!" }, "threadId": { "$ref": "#/components/schemas/id" }, "inReplyToCommentId": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/id" } ] }, "videoId": { "$ref": "#/components/schemas/Video/properties/id" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "deletedAt": { "nullable": true, "type": "string", "format": "date-time", "default": null }, "isDeleted": { "type": "boolean", "default": false }, "heldForReview": { "type": "boolean" }, "totalRepliesFromVideoAuthor": { "type": "integer", "minimum": 0 }, "totalReplies": { "type": "integer", "minimum": 0 }, "account": { "$ref": "#/components/schemas/Account" } } }, "VideoCommentThreadTree": { "properties": { "comment": { "$ref": "#/components/schemas/VideoComment" }, "children": { "type": "array", "items": { "$ref": "#/components/schemas/VideoCommentThreadTree" } } } }, "VideoCommentForOwnerOrAdmin": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "url": { "$ref": "#/components/schemas/VideoComment/properties/url" }, "text": { "$ref": "#/components/schemas/VideoComment/properties/text" }, "heldForReview": { "$ref": "#/components/schemas/VideoComment/properties/heldForReview" }, "threadId": { "$ref": "#/components/schemas/VideoComment/properties/threadId" }, "inReplyToCommentId": { "$ref": "#/components/schemas/VideoComment/properties/inReplyToCommentId" }, "createdAt": { "$ref": "#/components/schemas/VideoComment/properties/createdAt" }, "updatedAt": { "$ref": "#/components/schemas/VideoComment/properties/updatedAt" }, "account": { "$ref": "#/components/schemas/VideoComment/properties/account" }, "video": { "$ref": "#/components/schemas/VideoInfo" }, "automaticTags": { "type": "array", "items": { "type": "string" } } } }, "Storyboard": { "properties": { "storyboardPath": { "description": "Deprecated in PeerTube v8.0, use fileUrl instead", "deprecated": true, "type": "string" }, "fileUrl": { "description": "**PeerTube >= 7.1**", "type": "string" }, "totalHeight": { "type": "integer" }, "totalWidth": { "type": "integer" }, "spriteHeight": { "type": "integer" }, "spriteWidth": { "type": "integer" }, "spriteDuration": { "type": "integer" } } }, "VideoCaption": { "properties": { "language": { "$ref": "#/components/schemas/VideoConstantString-Language" }, "automaticallyGenerated": { "type": "boolean" }, "captionPath": { "type": "string", "deprecated": true, "description": "Deprecated in PeerTube v8.0, use fileUrl instead" }, "fileUrl": { "description": "**PeerTube >= 7.1**", "type": "string" }, "m3u8Url": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "VideoChapters": { "properties": { "chapters": { "type": "object", "properties": { "title": { "type": "string" }, "timecode": { "type": "integer" } } } } }, "VideoSource": { "properties": { "inputFilename": { "type": "string", "description": "Uploaded/imported filename" }, "fileDownloadUrl": { "type": "string", "description": "**PeerTube >= 6.1** If enabled by the admin, the video source file is kept on the server and can be downloaded by the owner" }, "resolution": { "description": "**PeerTube >= 6.1**", "allOf": [ { "$ref": "#/components/schemas/VideoResolutionConstant" } ] }, "size": { "type": "integer", "description": "**PeerTube >= 6.1** Video file size in bytes" }, "fps": { "type": "number", "description": "**PeerTube >= 6.1** Frames per second of the video file" }, "width": { "type": "integer", "description": "**PeerTube >= 6.1** Video stream width" }, "height": { "type": "integer", "description": "**PeerTube >= 6.1** Video stream height" }, "createdAt": { "type": "string", "format": "date-time" } } }, "ActorImage": { "properties": { "path": { "description": "Deprecated in PeerTube v8.0, use fileUrl instead", "deprecated": true, "type": "string" }, "fileUrl": { "description": "**PeerTube >= 7.1**", "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer", "description": "**PeerTube >= 7.3**" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "ActorInfo": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "displayName": { "type": "string" }, "host": { "type": "string", "format": "hostname" }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } }, "Actor": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "url": { "type": "string", "format": "url" }, "name": { "description": "immutable name of the actor, used to find or mention it", "allOf": [ { "$ref": "#/components/schemas/username" } ] }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } }, "host": { "type": "string", "format": "hostname", "description": "server on which the actor is resident" }, "hostRedundancyAllowed": { "type": "boolean", "nullable": true, "description": "whether this actor's host allows redundancy of its videos" }, "followingCount": { "type": "integer", "minimum": 0, "description": "number of actors subscribed to by this actor, as seen by this instance" }, "followersCount": { "type": "integer", "minimum": 0, "description": "number of followers of this actor, as seen by this instance" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "Account": { "allOf": [ { "$ref": "#/components/schemas/Actor" }, { "properties": { "userId": { "description": "object id for the user tied to this account", "nullable": true, "allOf": [ { "$ref": "#/components/schemas/User/properties/id" } ] }, "displayName": { "type": "string", "description": "editable name of the account, displayed in its representations", "minLength": 3, "maxLength": 120 }, "description": { "type": "string", "nullable": true, "description": "text or bio displayed on the account's profile" } } } ] }, "UserViewingVideo": { "required": [ "currentTime" ], "properties": { "currentTime": { "type": "integer", "format": "seconds", "description": "timestamp within the video, in seconds", "example": 5 }, "viewEvent": { "type": "string", "enum": [ "seek" ], "description": "Event since last viewing call:\n * `seek` - If the user seeked the video\n" }, "sessionId": { "type": "string", "description": "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 `sessionId` parameter but use the request IP address instead to identify a viewer.\n" }, "client": { "type": "string", "description": "Client software used to watch the video. For example \"Firefox\", \"PeerTube Approval Android\", etc.\n" }, "device": { "description": "Device used to watch the video. For example \"desktop\", \"mobile\", \"smarttv\", etc.\n", "allOf": [ { "$ref": "#/components/schemas/VideoStatsUserAgentDevice" } ] }, "operatingSystem": { "type": "string", "description": "Operating system used to watch the video. For example \"Windows\", \"Ubuntu\", etc.\n" } } }, "VideoStatsOverall": { "properties": { "averageWatchTime": { "type": "number" }, "totalWatchTime": { "type": "number" }, "viewersPeak": { "type": "number" }, "totalViewers": { "type": "number" }, "viewersPeakDate": { "type": "string", "format": "date-time" }, "countries": { "type": "array", "items": { "type": "object", "properties": { "isoCode": { "type": "string" }, "viewers": { "type": "number" } } } }, "subdivisions": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "viewers": { "type": "number" } } } } } }, "VideoStatsUserAgentDevice": { "enum": [ "console", "embedded", "mobile", "smarttv", "tablet", "wearable", "xr", "desktop" ] }, "VideoStatsUserAgent": { "properties": { "clients": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "viewers": { "type": "number" } } } }, "devices": { "type": "array", "items": { "type": "object", "properties": { "name": { "$ref": "#/components/schemas/VideoStatsUserAgentDevice" }, "viewers": { "type": "number" } } } }, "operatingSystem": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "viewers": { "type": "number" } } } } } }, "VideoStatsRetention": { "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "second": { "type": "number" }, "retentionPercent": { "type": "number" } } } } } }, "VideoStatsTimeserie": { "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "value": { "type": "number" } } } } } }, "ServerConfig": { "properties": { "instance": { "type": "object", "properties": { "name": { "type": "string" }, "shortDescription": { "type": "string" }, "defaultClientRoute": { "type": "string" }, "isNSFW": { "type": "boolean" }, "defaultNSFWPolicy": { "type": "string" }, "serverCountry": { "type": "string" }, "defaultLanguage": { "type": "string" }, "support": { "type": "object", "properties": { "text": { "type": "string" } } }, "social": { "type": "object", "properties": { "externalLink": { "type": "string" }, "mastodonLink": { "type": "string" }, "blueskyLink": { "type": "string" }, "xLink": { "type": "string" } } }, "customizations": { "type": "object", "properties": { "javascript": { "type": "string" }, "css": { "type": "string" } } }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } }, "banners": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } }, "search": { "type": "object", "properties": { "remoteUri": { "type": "object", "properties": { "users": { "type": "boolean" }, "anonymous": { "type": "boolean" } } } } }, "plugin": { "type": "object", "properties": { "registered": { "type": "array", "items": { "type": "string" } } } }, "theme": { "type": "object", "properties": { "registered": { "type": "array", "items": { "type": "string" } } } }, "email": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "contactForm": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "serverVersion": { "type": "string" }, "serverCommit": { "type": "string" }, "signup": { "type": "object", "properties": { "allowed": { "type": "boolean" }, "allowedForCurrentIP": { "type": "boolean" }, "requiresEmailVerification": { "type": "boolean" } } }, "transcoding": { "type": "object", "properties": { "hls": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "web_videos": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "enabledResolutions": { "type": "array", "items": { "$ref": "#/components/schemas/VideoResolutionSet" } } } }, "import": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "http": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "torrent": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "videoChannelSynchronization": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "export": { "type": "object", "properties": { "users": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "exportExpiration": { "type": "number", "description": "In milliseconds" }, "maxUserVideoQuota": { "type": "number", "description": "In bytes" } } } } }, "autoBlacklist": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "ofUsers": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } } } }, "blocklist": { "type": "object", "properties": { "publicLog": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "avatar": { "type": "object", "properties": { "file": { "type": "object", "properties": { "size": { "type": "object", "properties": { "max": { "type": "integer" } } } } }, "extensions": { "type": "array", "items": { "type": "string" } } } }, "video": { "type": "object", "properties": { "image": { "type": "object", "properties": { "extensions": { "type": "array", "items": { "type": "string" } }, "size": { "type": "object", "properties": { "max": { "type": "integer" } } } } }, "file": { "type": "object", "properties": { "extensions": { "type": "array", "items": { "type": "string" } } } } } }, "videoCaption": { "type": "object", "properties": { "file": { "type": "object", "properties": { "size": { "type": "object", "properties": { "max": { "type": "integer" } } }, "extensions": { "type": "array", "items": { "type": "string" } } } } } }, "user": { "type": "object", "properties": { "videoQuota": { "type": "integer", "description": "In bytes", "example": 16810141515 }, "videoQuotaDaily": { "type": "integer", "description": "In bytes", "example": 1681014151 } } }, "trending": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "intervalDays": { "type": "integer" } } } } }, "tracker": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "followings": { "type": "object", "properties": { "instance": { "type": "object", "properties": { "autoFollowIndex": { "type": "object", "properties": { "indexUrl": { "type": "string", "format": "url" } } } } } } }, "federation": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "homepage": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "openTelemetry": { "type": "object", "description": "PeerTube >= 6.1", "properties": { "metrics": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "playbackStatsInterval": { "type": "number", "description": "Milliseconds" } } } } }, "views": { "type": "object", "description": "PeerTube >= 6.1", "properties": { "views": { "type": "object", "properties": { "watchingInterval": { "type": "object", "properties": { "anonymous": { "type": "number", "description": "Milliseconds" }, "users": { "type": "number", "description": "Milliseconds" } } } } } } } } }, "SendClientLog": { "properties": { "message": { "type": "string" }, "url": { "type": "string", "description": "URL of the current user page" }, "level": { "enum": [ "error", "warn" ] }, "stackTrace": { "type": "string", "description": "Stack trace of the error if there is one" }, "userAgent": { "type": "string", "description": "User agent of the web browser that sends the message" }, "meta": { "type": "string", "description": "Additional information regarding this log" } }, "required": [ "message", "url", "level" ] }, "ServerStats": { "properties": { "totalUsers": { "type": "number" }, "totalDailyActiveUsers": { "type": "number" }, "totalWeeklyActiveUsers": { "type": "number" }, "totalMonthlyActiveUsers": { "type": "number" }, "totalModerators": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled total moderators stats" }, "totalAdmins": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled total admins stats" }, "totalLocalVideos": { "type": "number" }, "totalLocalVideoViews": { "type": "number", "description": "Total video views made on the instance" }, "totalLocalVideoDownloads": { "type": "number", "description": "Total video downloads made on the instance" }, "totalLocalVideoComments": { "type": "number", "description": "Total comments made by local users" }, "totalLocalVideoFilesSize": { "type": "number" }, "totalVideos": { "type": "number" }, "totalVideoComments": { "type": "number" }, "totalLocalVideoChannels": { "type": "number" }, "totalLocalDailyActiveVideoChannels": { "type": "number" }, "totalLocalWeeklyActiveVideoChannels": { "type": "number" }, "totalLocalMonthlyActiveVideoChannels": { "type": "number" }, "totalLocalPlaylists": { "type": "number" }, "totalInstanceFollowers": { "type": "number" }, "totalInstanceFollowing": { "type": "number" }, "videosRedundancy": { "type": "array", "items": { "type": "object", "properties": { "strategy": { "type": "string" }, "totalSize": { "type": "number" }, "totalUsed": { "type": "number" }, "totalVideoFiles": { "type": "number" }, "totalVideos": { "type": "number" } } } }, "totalActivityPubMessagesProcessed": { "type": "number" }, "totalActivityPubMessagesSuccesses": { "type": "number" }, "totalActivityPubMessagesErrors": { "type": "number" }, "activityPubMessagesProcessedPerSecond": { "type": "number" }, "totalActivityPubMessagesWaiting": { "type": "number" }, "averageRegistrationRequestResponseTimeMs": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled registration requests stats" }, "totalRegistrationRequestsProcessed": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled registration requests stats" }, "totalRegistrationRequests": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled registration requests stats" }, "averageAbuseResponseTimeMs": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled abuses stats" }, "totalAbusesProcessed": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled abuses stats" }, "totalAbuses": { "type": "number", "description": "**PeerTube >= 6.1** Value is null if the admin disabled abuses stats" } } }, "ServerConfigAbout": { "properties": { "instance": { "type": "object", "properties": { "name": { "type": "string" }, "shortDescription": { "type": "string" }, "description": { "type": "string" }, "terms": { "type": "string" }, "codeOfConduct": { "type": "string" }, "hardwareInformation": { "type": "string" }, "creationReason": { "type": "string" }, "moderationInformation": { "type": "string" }, "administrator": { "type": "string" }, "maintenanceLifetime": { "type": "string" }, "businessModel": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "categories": { "type": "array", "items": { "type": "integer" } }, "avatars": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } }, "banners": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } } } } } }, "ServerConfigCustom": { "properties": { "instance": { "type": "object", "properties": { "name": { "type": "string" }, "shortDescription": { "type": "string" }, "description": { "type": "string" }, "terms": { "type": "string" }, "codeOfConduct": { "type": "string" }, "creationReason": { "type": "string" }, "moderationInformation": { "type": "string" }, "administrator": { "type": "string" }, "maintenanceLifetime": { "type": "string" }, "businessModel": { "type": "string" }, "hardwareInformation": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "categories": { "type": "array", "items": { "type": "number" } }, "isNSFW": { "type": "boolean" }, "defaultNSFWPolicy": { "type": "string" }, "serverCountry": { "type": "string" }, "support": { "type": "object", "properties": { "text": { "type": "string" } } }, "social": { "type": "object", "properties": { "externalLink": { "type": "string" }, "mastodonLink": { "type": "string" }, "blueskyLink": { "type": "string" }, "xLink": { "type": "string" } } }, "defaultClientRoute": { "type": "string" }, "customizations": { "type": "object", "properties": { "javascript": { "type": "string" }, "css": { "type": "string" } } } } }, "theme": { "type": "object", "properties": { "default": { "type": "string" } } }, "services": { "type": "object", "properties": { "twitter": { "type": "object", "properties": { "username": { "type": "string" } } } } }, "cache": { "type": "object", "properties": { "previews": { "type": "object", "properties": { "size": { "type": "integer" } } }, "captions": { "type": "object", "properties": { "size": { "type": "integer" } } } } }, "signup": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "limit": { "type": "integer" }, "requiresEmailVerification": { "type": "boolean" } } }, "admin": { "type": "object", "properties": { "email": { "type": "string", "format": "email" } } }, "contactForm": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "user": { "type": "object", "description": "Settings that apply to new users, if registration is enabled", "properties": { "videoQuota": { "type": "integer", "example": 16810141515 }, "videoQuotaDaily": { "type": "integer", "example": 1681014151 } } }, "transcoding": { "type": "object", "description": "Settings pertaining to transcoding jobs", "properties": { "enabled": { "type": "boolean" }, "originalFile": { "type": "object", "properties": { "keep": { "type": "boolean" } } }, "allowAdditionalExtensions": { "type": "boolean", "description": "Allow your users to upload .mkv, .mov, .avi, .wmv, .flv, .f4v, .3g2, .3gp, .mts, m2ts, .mxf, .nut videos" }, "allowAudioFiles": { "type": "boolean", "description": "If a user uploads an audio file, PeerTube will create a video by merging the preview file and the audio file" }, "threads": { "type": "integer", "description": "Amount of threads used by ffmpeg for 1 transcoding job" }, "concurrency": { "type": "number", "description": "Amount of transcoding jobs to execute in parallel" }, "profile": { "type": "string", "enum": [ "default" ], "description": "New profiles can be added by plugins ; available in core PeerTube: 'default'.\n" }, "resolutions": { "type": "object", "description": "Resolutions to transcode _new videos_ to", "properties": { "0p": { "type": "boolean" }, "144p": { "type": "boolean" }, "240p": { "type": "boolean" }, "360p": { "type": "boolean" }, "480p": { "type": "boolean" }, "720p": { "type": "boolean" }, "1080p": { "type": "boolean" }, "1440p": { "type": "boolean" }, "2160p": { "type": "boolean" } } }, "web_videos": { "type": "object", "description": "Web Video specific settings", "properties": { "enabled": { "type": "boolean" } } }, "hls": { "type": "object", "description": "HLS specific settings", "properties": { "enabled": { "type": "boolean" }, "splitAudioAndVideo": { "type": "boolean" } } } } }, "import": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "http": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "torrent": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "video_channel_synchronization": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "autoBlacklist": { "type": "object", "properties": { "videos": { "type": "object", "properties": { "ofUsers": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } } } }, "blocklist": { "type": "object", "properties": { "publicLog": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "followers": { "type": "object", "properties": { "instance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "manualApproval": { "type": "boolean" } } } } }, "storyboard": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "defaults": { "type": "object", "properties": { "publish": { "type": "object", "properties": { "downloadEnabled": { "type": "boolean" }, "commentsPolicy": { "$ref": "#/components/schemas/VideoCommentsPolicySet" }, "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" }, "licence": { "$ref": "#/components/schemas/VideoLicenceSet" } } }, "p2p": { "type": "object", "properties": { "webapp": { "type": "object", "properties": { "enabled": { "type": "boolean" } } }, "embed": { "type": "object", "properties": { "enabled": { "type": "boolean" } } } } }, "player": { "type": "object", "properties": { "autoPlay": { "type": "boolean" } } } } } } }, "CustomHomepage": { "properties": { "content": { "type": "string" } } }, "Follow": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "follower": { "$ref": "#/components/schemas/Actor" }, "following": { "$ref": "#/components/schemas/Actor" }, "score": { "type": "number", "description": "score reflecting the reachability of the actor, with steps of `10` and a base score of `1000`." }, "state": { "type": "string", "enum": [ "pending", "accepted" ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "PredefinedAbuseReasons": { "description": "Reason categories that help triage reports", "type": "array", "maxItems": 8, "items": { "type": "string", "enum": [ "violentOrAbusive", "hatefulOrAbusive", "spamOrMisleading", "privacy", "rights", "serverRules", "thumbnails", "captions" ] } }, "Job": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "state": { "type": "string", "enum": [ "active", "completed", "failed", "waiting", "delayed" ] }, "type": { "type": "string", "enum": [ "activitypub-http-unicast", "activitypub-http-broadcast", "activitypub-http-fetcher", "activitypub-follow", "video-file-import", "video-transcoding", "email", "video-import", "videos-stats", "activitypub-refresher", "video-redundancy", "video-channel-import" ] }, "data": { "type": "object", "additionalProperties": true }, "error": { "type": "object", "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time" }, "finishedOn": { "type": "string", "format": "date-time" }, "processedOn": { "type": "string", "format": "date-time" } } }, "AddUserResponse": { "properties": { "user": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "account": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" } } } } } } }, "VideoUploadRequestCommon": { "properties": { "name": { "description": "Video name", "type": "string", "example": "What is PeerTube?", "minLength": 3, "maxLength": 120 }, "channelId": { "description": "Channel id that will contain this video", "type": "integer", "example": 3, "minimum": 1 }, "privacy": { "$ref": "#/components/schemas/VideoPrivacySet" }, "category": { "$ref": "#/components/schemas/VideoCategorySet" }, "licence": { "$ref": "#/components/schemas/VideoLicenceSet" }, "language": { "$ref": "#/components/schemas/VideoLanguageSet" }, "description": { "description": "Video description", "type": "string", "example": "**[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": { "description": "Whether or not we wait transcoding before publish the video", "type": "boolean" }, "generateTranscription": { "description": "**PeerTube >= 6.2** If enabled by the admin, automatically generate a subtitle of the video", "type": "boolean" }, "support": { "description": "A text tell the audience how to support the video creator", "example": "Please support our work on https://soutenir.framasoft.org/en/ <3", "type": "string" }, "nsfw": { "description": "Whether or not this video contains sensitive content", "type": "boolean" }, "nsfwSummary": { "description": "More information about the sensitive content of the video" }, "nsfwFlags": { "$ref": "#/components/schemas/NSFWFlag" }, "tags": { "description": "Video tags (maximum 5 tags each between 2 and 30 characters)", "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "example": [ "framasoft", "peertube" ], "items": { "type": "string", "minLength": 2, "maxLength": 30 } }, "commentsPolicy": { "$ref": "#/components/schemas/VideoCommentsPolicySet" }, "downloadEnabled": { "description": "Enable or disable downloading for this video", "type": "boolean" }, "originallyPublishedAt": { "description": "Date when the content was originally published", "type": "string", "format": "date-time" }, "scheduleUpdate": { "$ref": "#/components/schemas/VideoScheduledUpdate" }, "thumbnailfile": { "description": "Video thumbnail file", "type": "string", "format": "binary" }, "previewfile": { "description": "Deprecated in PeerTube v8.1, use thumbnailfile instead", "deprecated": true, "type": "string", "format": "binary" }, "videoPasswords": { "$ref": "#/components/schemas/AddVideoPasswords" } }, "required": [ "channelId", "name" ] }, "VideoUploadRequestLegacy": { "allOf": [ { "$ref": "#/components/schemas/VideoUploadRequestCommon" }, { "type": "object", "required": [ "videofile" ], "properties": { "videofile": { "description": "Video file", "type": "string", "format": "binary" } } } ] }, "VideoUploadRequestResumable": { "allOf": [ { "$ref": "#/components/schemas/VideoUploadRequestCommon" }, { "type": "object", "required": [ "filename" ], "properties": { "filename": { "description": "Video filename including extension", "type": "string", "format": "filename", "example": "what_is_peertube.mp4" }, "thumbnailfile": { "description": "Video thumbnail file", "type": "string", "format": "binary" }, "previewfile": { "description": "Deprecated in PeerTube v8.1, use thumbnailfile instead", "deprecated": true, "type": "string", "format": "binary" } } } ] }, "VideoUploadResponse": { "properties": { "video": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/Video/properties/id" }, "uuid": { "$ref": "#/components/schemas/Video/properties/uuid" }, "shortUUID": { "$ref": "#/components/schemas/Video/properties/shortUUID" } } } } }, "VideoReplaceSourceRequestResumable": { "properties": { "filename": { "description": "Video filename including extension", "type": "string", "format": "filename", "example": "what_is_peertube.mp4" } } }, "UserImportResumable": { "properties": { "filename": { "description": "Archive filename including extension", "type": "string", "format": "filename", "example": "user-export-6-2024-02-09T10_12_11.682Z" } } }, "CommentThreadResponse": { "properties": { "total": { "type": "integer", "description": "Total threads (included deleted ones) on this video" }, "totalNotDeletedComments": { "type": "integer", "description": "Total not-deleted threads (included deleted ones) on this video" }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/VideoComment" } } } }, "CommentThreadPostResponse": { "properties": { "comment": { "$ref": "#/components/schemas/VideoComment" } } }, "VideoTokenResponse": { "properties": { "files": { "type": "object", "properties": { "token": { "type": "string" }, "expires": { "type": "string", "format": "date-time" } } } } }, "VideoListResponse": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Video" } } } }, "ChannelActivityListResponse": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "account": { "nullable": true, "description": "The account may have been deleted", "$ref": "#/components/schemas/AccountSummary" }, "action": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/VideoChannelActivityAction" }, "label": { "type": "string" } } }, "targetType": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/VideoChannelActivityTarget" }, "label": { "type": "string" } } }, "details": { "type": "object", "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time" }, "channel": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "displayName": { "type": "string" }, "url": { "type": "string", "format": "url" } } }, "video": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "$ref": "#/components/schemas/shortUUID" }, "url": { "type": "string", "format": "url" }, "isLive": { "type": "boolean" } } }, "videoImport": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "$ref": "#/components/schemas/shortUUID" }, "url": { "type": "string", "format": "url" }, "targetUrl": { "type": "string", "format": "uri" } } }, "playlist": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "$ref": "#/components/schemas/shortUUID" }, "url": { "type": "string", "format": "url" } } }, "channelSync": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "externalChannelUrl": { "type": "string", "format": "uri" } } } } } } } }, "UserNotificationSettings": { "properties": { "abuseAsModerator": { "$ref": "#/components/schemas/NotificationSettingValue" }, "videoAutoBlacklistAsModerator": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newUserRegistration": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newVideoFromSubscription": { "$ref": "#/components/schemas/NotificationSettingValue" }, "blacklistOnMyVideo": { "$ref": "#/components/schemas/NotificationSettingValue" }, "myVideoPublished": { "$ref": "#/components/schemas/NotificationSettingValue" }, "myVideoImportFinished": { "$ref": "#/components/schemas/NotificationSettingValue" }, "commentMention": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newCommentOnMyVideo": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newFollow": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newInstanceFollower": { "$ref": "#/components/schemas/NotificationSettingValue" }, "autoInstanceFollowing": { "$ref": "#/components/schemas/NotificationSettingValue" }, "abuseStateChange": { "$ref": "#/components/schemas/NotificationSettingValue" }, "abuseNewMessage": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newPeerTubeVersion": { "$ref": "#/components/schemas/NotificationSettingValue" }, "newPluginVersion": { "$ref": "#/components/schemas/NotificationSettingValue" }, "myVideoStudioEditionFinished": { "$ref": "#/components/schemas/NotificationSettingValue" }, "myVideoTranscriptionGenerated": { "$ref": "#/components/schemas/NotificationSettingValue" } } }, "User": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "username": { "$ref": "#/components/schemas/username" }, "email": { "type": "string", "format": "email", "description": "The user email" }, "emailVerified": { "type": "boolean", "description": "Has the user confirmed their email address?" }, "emailPublic": { "type": "boolean", "description": "Has the user accepted to display the email publicly?" }, "nsfwPolicy": { "$ref": "#/components/schemas/NSFWPolicy" }, "nsfwFlagsDisplayed": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsHidden": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsWarned": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsBlurred": { "$ref": "#/components/schemas/NSFWFlag" }, "adminFlags": { "$ref": "#/components/schemas/UserAdminFlags" }, "autoPlayNextVideo": { "type": "boolean", "description": "Automatically start playing the upcoming video after the currently playing video" }, "autoPlayNextVideoPlaylist": { "type": "boolean", "description": "Automatically start playing the video on the playlist after the currently playing video" }, "autoPlayVideo": { "type": "boolean", "description": "Automatically start playing the video on the watch page" }, "p2pEnabled": { "type": "boolean", "description": "whether to enable P2P in the player or not" }, "videosHistoryEnabled": { "type": "boolean", "description": "whether to keep track of watched history or not" }, "videoLanguages": { "type": "array", "items": { "type": "string" }, "description": "list of languages to filter videos down to" }, "language": { "type": "string", "description": "default language for this user" }, "videoQuota": { "type": "integer", "description": "The user video quota in bytes", "example": -1 }, "videoQuotaDaily": { "type": "integer", "description": "The user daily video quota in bytes", "example": -1 }, "role": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserRole" }, "label": { "type": "string", "enum": [ "User", "Moderator", "Administrator" ] } } }, "theme": { "type": "string", "description": "Theme enabled by this user" }, "account": { "$ref": "#/components/schemas/Account" }, "notificationSettings": { "$ref": "#/components/schemas/UserNotificationSettings" }, "videoChannels": { "type": "array", "items": { "$ref": "#/components/schemas/VideoChannel" } }, "blocked": { "type": "boolean" }, "blockedReason": { "type": "string" }, "noInstanceConfigWarningModal": { "type": "boolean" }, "noAccountSetupWarningModal": { "type": "boolean" }, "noWelcomeModal": { "type": "boolean" }, "createdAt": { "type": "string" }, "pluginAuth": { "type": "string", "description": "Auth plugin to use to authenticate the user" }, "lastLoginDate": { "type": "string", "format": "date-time" }, "twoFactorEnabled": { "type": "boolean", "description": "Whether the user has enabled two-factor authentication or not" }, "newFeaturesInfoRead": { "type": "number", "description": "New features information the user has read" } } }, "UserWithStats": { "allOf": [ { "$ref": "#/components/schemas/User" }, { "properties": { "videosCount": { "type": "integer", "description": "Count of videos published" }, "abusesCount": { "type": "integer", "description": "Count of reports/abuses of which the user is a target" }, "abusesAcceptedCount": { "type": "integer", "description": "Count of reports/abuses created by the user and accepted/acted upon by the moderation team" }, "abusesCreatedCount": { "type": "integer", "description": "Count of reports/abuses created by the user" }, "videoCommentsCount": { "type": "integer", "description": "Count of comments published" } } } ] }, "AddUser": { "properties": { "username": { "$ref": "#/components/schemas/username" }, "password": { "$ref": "#/components/schemas/password" }, "email": { "type": "string", "format": "email", "description": "The user email" }, "videoQuota": { "type": "integer", "description": "The user video quota in bytes", "example": -1 }, "videoQuotaDaily": { "type": "integer", "description": "The user daily video quota in bytes", "example": -1 }, "channelName": { "$ref": "#/components/schemas/usernameChannel" }, "role": { "$ref": "#/components/schemas/UserRole" }, "adminFlags": { "$ref": "#/components/schemas/UserAdminFlags" } }, "required": [ "username", "password", "email", "role" ] }, "UpdateUser": { "properties": { "email": { "description": "The updated email of the user", "allOf": [ { "$ref": "#/components/schemas/User/properties/email" } ] }, "emailVerified": { "type": "boolean", "description": "Set the email as verified" }, "videoQuota": { "type": "integer", "description": "The updated video quota of the user in bytes" }, "videoQuotaDaily": { "type": "integer", "description": "The updated daily video quota of the user in bytes" }, "pluginAuth": { "type": "string", "nullable": true, "description": "The auth plugin to use to authenticate the user", "example": "peertube-plugin-auth-saml2" }, "role": { "$ref": "#/components/schemas/UserRole" }, "adminFlags": { "$ref": "#/components/schemas/UserAdminFlags" }, "password": { "$ref": "#/components/schemas/password" } } }, "UpdateMe": { "properties": { "password": { "$ref": "#/components/schemas/password" }, "currentPassword": { "$ref": "#/components/schemas/password" }, "email": { "description": "new email used for login and service communications", "allOf": [ { "$ref": "#/components/schemas/User/properties/email" } ] }, "displayName": { "type": "string", "description": "new name of the user in its representations", "minLength": 3, "maxLength": 120 }, "nsfwPolicy": { "type": "string", "description": "new NSFW display policy", "enum": [ "true", "false", "both" ] }, "nsfwFlagsDisplayed": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsHidden": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsWarned": { "$ref": "#/components/schemas/NSFWFlag" }, "nsfwFlagsBlurred": { "$ref": "#/components/schemas/NSFWFlag" }, "p2pEnabled": { "type": "boolean", "description": "whether to enable P2P in the player or not" }, "autoPlayVideo": { "type": "boolean", "description": "new preference regarding playing videos automatically" }, "autoPlayNextVideo": { "type": "boolean", "description": "new preference regarding playing following videos automatically" }, "autoPlayNextVideoPlaylist": { "type": "boolean", "description": "new preference regarding playing following playlist videos automatically" }, "videosHistoryEnabled": { "type": "boolean", "description": "whether to keep track of watched history or not" }, "videoLanguages": { "type": "array", "items": { "type": "string" }, "description": "list of languages to filter videos down to" }, "language": { "type": "string", "description": "default language for this user" }, "theme": { "type": "string" }, "noInstanceConfigWarningModal": { "type": "boolean" }, "noAccountSetupWarningModal": { "type": "boolean" }, "noWelcomeModal": { "type": "boolean" } } }, "GetMeVideoRating": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "rating": { "type": "string", "enum": [ "like", "dislike", "none" ], "description": "Rating of the video" } }, "required": [ "id", "rating" ] }, "VideoRating": { "properties": { "video": { "$ref": "#/components/schemas/Video" }, "rating": { "type": "string", "enum": [ "like", "dislike", "none" ], "description": "Rating of the video" } }, "required": [ "video", "rating" ] }, "RegisterUser": { "properties": { "username": { "description": "immutable name of the user, used to find or mention its actor", "allOf": [ { "$ref": "#/components/schemas/username" } ] }, "password": { "$ref": "#/components/schemas/password" }, "email": { "type": "string", "format": "email", "description": "email of the user, used for login or service communications" }, "displayName": { "type": "string", "description": "editable name of the user, displayed in its representations", "minLength": 1, "maxLength": 120 }, "channel": { "type": "object", "description": "channel base information used to create the first channel of the user", "properties": { "name": { "$ref": "#/components/schemas/usernameChannel" }, "displayName": { "type": "string" } } } }, "required": [ "username", "password", "email" ] }, "UserRegistrationRequest": { "allOf": [ { "$ref": "#/components/schemas/RegisterUser" }, { "type": "object", "properties": { "registrationReason": { "type": "string", "description": "reason for the user to register on the instance" } }, "required": [ "registrationReason" ] } ] }, "UserRegistrationAcceptOrReject": { "type": "object", "properties": { "moderationResponse": { "type": "string", "description": "Moderation response to send to the user" }, "preventEmailDelivery": { "type": "boolean", "description": "Set it to true if you don't want PeerTube to send an email to the user" } }, "required": [ "moderationResponse" ] }, "UserRegistrationState": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The registration state (Pending = `1`, Rejected = `2`, Accepted = `3`)" }, "ChangeOwnershipState": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The ownership change state (Pending = `1`, Rejected = `2`, Accepted = `3`)" }, "UserRegistration": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/UserRegistrationState" }, "label": { "type": "string" } } }, "registrationReason": { "type": "string" }, "moderationResponse": { "type": "string", "nullable": true }, "username": { "type": "string" }, "email": { "type": "string", "format": "email" }, "emailVerified": { "type": "boolean" }, "accountDisplayName": { "type": "string" }, "channelHandle": { "type": "string" }, "channelDisplayName": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "user": { "type": "object", "nullable": true, "description": "If the registration has been accepted, this is a partial user object created by the registration", "properties": { "id": { "$ref": "#/components/schemas/id" } } } } }, "OAuthClient": { "properties": { "client_id": { "type": "string", "pattern": "/^[a-z0-9]$/", "maxLength": 32, "minLength": 32, "example": "v1ikx5hnfop4mdpnci8nsqh93c45rldf" }, "client_secret": { "type": "string", "pattern": "/^[a-zA-Z0-9]$/", "maxLength": 32, "minLength": 32, "example": "AjWiOapPltI6EnsWQwlFarRtLh4u8tDt" } } }, "OAuthToken-password": { "allOf": [ { "$ref": "#/components/schemas/OAuthClient" }, { "type": "object", "properties": { "grant_type": { "type": "string", "enum": [ "password" ] }, "username": { "$ref": "#/components/schemas/User/properties/username" }, "password": { "$ref": "#/components/schemas/password" }, "externalAuthToken": { "type": "string", "description": "If you want to authenticate using an external authentication token you got from an auth plugin (like `peertube-plugin-auth-openid-connect` for example) instead of a password or a refresh token, provide it here." } } } ], "required": [ "client_id", "client_secret", "grant_type", "username" ] }, "OAuthToken-refresh_token": { "allOf": [ { "$ref": "#/components/schemas/OAuthClient" }, { "type": "object", "properties": { "grant_type": { "type": "string", "enum": [ "refresh_token" ] }, "refresh_token": { "type": "string", "example": "2e0d675df9fc96d2e4ec8a3ebbbf45eca9137bb7" } } } ], "required": [ "client_id", "client_secret", "grant_type", "refresh_token" ] }, "VideoChannel": { "allOf": [ { "$ref": "#/components/schemas/Actor" }, { "type": "object", "properties": { "displayName": { "type": "string", "description": "editable name of the channel, displayed in its representations", "example": "Videos of Framasoft", "minLength": 1, "maxLength": 120 }, "description": { "type": "string", "nullable": true, "example": "Videos made with <3 by Framasoft", "minLength": 3, "maxLength": 1000 }, "support": { "type": "string", "nullable": true, "description": "text shown by default on all videos of this channel, to tell the audience how to support it", "example": "Please support our work on https://soutenir.framasoft.org/en/ <3", "minLength": 3, "maxLength": 1000 }, "isLocal": { "type": "boolean" }, "updatedAt": { "type": "string", "format": "date-time" }, "banners": { "type": "array", "items": { "$ref": "#/components/schemas/ActorImage" } }, "ownerAccount": { "$ref": "#/components/schemas/Account" } } } ] }, "VideoChannelEdit": { "properties": { "displayName": { "description": "Channel display name" }, "description": { "description": "Channel description" }, "support": { "description": "How to support/fund the channel" } } }, "VideoChannelCreate": { "allOf": [ { "$ref": "#/components/schemas/VideoChannelEdit" }, { "properties": { "name": { "description": "username of the channel to create", "allOf": [ { "$ref": "#/components/schemas/usernameChannel" } ] } } } ], "required": [ "name", "displayName" ] }, "VideoChannelUpdate": { "allOf": [ { "$ref": "#/components/schemas/VideoChannelEdit" }, { "properties": { "bulkVideosSupportUpdate": { "type": "boolean", "description": "Update the support field for all videos of this channel" } } } ] }, "VideoChannelList": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/VideoChannel" }, { "$ref": "#/components/schemas/Actor" } ] } } } }, "ImportVideosInChannelCreate": { "type": "object", "properties": { "externalChannelUrl": { "type": "string", "example": "https://youtube.com/c/UC_myfancychannel" }, "videoChannelSyncId": { "type": "integer", "description": "If part of a channel sync process, specify its id to assign video imports to this channel synchronization" } }, "required": [ "externalChannelUrl" ] }, "VideoChannelSync": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "state": { "type": "object", "properties": { "id": { "type": "integer", "example": 2 }, "label": { "type": "string", "example": "PROCESSING" } } }, "externalChannelUrl": { "type": "string", "example": "https://youtube.com/c/UC_myfancychannel" }, "createdAt": { "type": "string", "format": "date-time" }, "lastSyncAt": { "type": "string", "format": "date-time", "nullable": true }, "channel": { "$ref": "#/components/schemas/VideoChannel" } } }, "VideoChannelSyncList": { "type": "object", "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/VideoChannelSync" } ] } } } }, "VideoChannelSyncCreate": { "type": "object", "properties": { "externalChannelUrl": { "type": "string", "example": "https://youtube.com/c/UC_myfancychannel" }, "videoChannelId": { "$ref": "#/components/schemas/id" } } }, "MRSSPeerLink": { "type": "object", "xml": { "name": "media:peerLink" }, "properties": { "href": { "type": "string", "xml": { "attribute": true } }, "type": { "type": "string", "enum": [ "application/x-bittorrent" ], "xml": { "attribute": true } } } }, "MRSSGroupContent": { "type": "object", "xml": { "name": "media:content" }, "properties": { "url": { "type": "string", "format": "url", "xml": { "attribute": true } }, "fileSize": { "type": "integer", "xml": { "attribute": true } }, "type": { "type": "string", "xml": { "attribute": true } }, "framerate": { "type": "integer", "xml": { "attribute": true } }, "duration": { "type": "integer", "xml": { "attribute": true } }, "height": { "type": "integer", "xml": { "attribute": true } }, "lang": { "type": "string", "xml": { "attribute": true } } } }, "VideoCommentsForXML": { "type": "array", "xml": { "wrapped": true, "name": "channel" }, "items": { "type": "object", "xml": { "name": "item" }, "properties": { "link": { "type": "string", "format": "url" }, "guid": { "type": "string" }, "pubDate": { "type": "string", "format": "date-time" }, "content:encoded": { "type": "string" }, "dc:creator": { "type": "string" } } } }, "VideosForXML": { "type": "array", "xml": { "wrapped": true, "name": "channel" }, "items": { "type": "object", "xml": { "name": "item" }, "properties": { "link": { "type": "string", "format": "url", "description": "video watch page URL" }, "guid": { "type": "string", "description": "video canonical URL" }, "pubDate": { "type": "string", "format": "date-time", "description": "video publication date" }, "description": { "type": "string", "description": "video description" }, "content:encoded": { "type": "string", "description": "video description" }, "dc:creator": { "type": "string", "description": "publisher user name" }, "media:category": { "type": "integer", "description": "video category (MRSS)" }, "media:community": { "type": "object", "description": "see [media:community](https://www.rssboard.org/media-rss#media-community) (MRSS)", "properties": { "media:statistics": { "type": "object", "properties": { "views": { "type": "integer", "xml": { "attribute": true } } } } } }, "media:embed": { "type": "object", "properties": { "url": { "type": "string", "format": "url", "description": "video embed path, relative to the canonical URL domain (MRSS)", "xml": { "attribute": true } } } }, "media:player": { "type": "object", "properties": { "url": { "type": "string", "format": "url", "description": "video watch path, relative to the canonical URL domain (MRSS)", "xml": { "attribute": true } } } }, "media:thumbnail": { "type": "object", "properties": { "url": { "type": "string", "format": "url", "xml": { "attribute": true } }, "height": { "type": "integer", "xml": { "attribute": true } }, "width": { "type": "integer", "xml": { "attribute": true } } } }, "media:title": { "type": "string", "description": "see [media:title](https://www.rssboard.org/media-rss#media-title) (MRSS). We only use `plain` titles." }, "media:description": { "type": "string" }, "media:rating": { "type": "string", "enum": [ "nonadult", "adult" ], "description": "see [media:rating](https://www.rssboard.org/media-rss#media-rating) (MRSS)" }, "enclosure": { "type": "object", "description": "main streamable file for the video", "properties": { "url": { "type": "string", "format": "url", "xml": { "attribute": true } }, "type": { "type": "string", "enum": [ "application/x-bittorrent" ], "xml": { "attribute": true } }, "length": { "type": "integer", "xml": { "attribute": true } } } }, "media:group": { "type": "array", "description": "list of streamable files for the video. see [media:peerLink](https://www.rssboard.org/media-rss#media-peerlink) and [media:content](https://www.rssboard.org/media-rss#media-content) or (MRSS)", "items": { "anyOf": [ { "$ref": "#/components/schemas/MRSSPeerLink" }, { "$ref": "#/components/schemas/MRSSGroupContent" } ] } } } } }, "NotificationSettingValue": { "type": "integer", "description": "Notification type. One of the following values, or a sum of multiple values:\n- `0` NONE\n- `1` WEB\n- `2` EMAIL\n" }, "NotificationType": { "type": "integer", "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 ], "description": "Notification type. One of the following values:\n\n - `1` NEW_VIDEO_FROM_SUBSCRIPTION\n\n - `2` NEW_COMMENT_ON_MY_VIDEO\n\n - `3` NEW_ABUSE_FOR_MODERATORS\n\n - `4` BLACKLIST_ON_MY_VIDEO\n\n - `5` UNBLACKLIST_ON_MY_VIDEO\n\n - `6` MY_VIDEO_PUBLISHED\n\n - `7` MY_VIDEO_IMPORT_SUCCESS\n\n - `8` MY_VIDEO_IMPORT_ERROR\n\n - `9` NEW_USER_REGISTRATION\n\n - `10` NEW_FOLLOW\n\n - `11` COMMENT_MENTION\n\n - `12` VIDEO_AUTO_BLACKLIST_FOR_MODERATORS\n\n - `13` NEW_INSTANCE_FOLLOWER\n\n - `14` AUTO_INSTANCE_FOLLOWING\n\n - `15` ABUSE_STATE_CHANGE\n\n - `16` ABUSE_NEW_MESSAGE\n\n - `17` NEW_PLUGIN_VERSION\n\n - `18` NEW_PEERTUBE_VERSION\n\n - `19` MY_VIDEO_STUDIO_EDITION_FINISHED\n\n - `20` NEW_USER_REGISTRATION_REQUEST\n\n - `21` NEW_LIVE_FROM_SUBSCRIPTION\n\n - `22` MY_VIDEO_TRANSCRIPTION_GENERATED\n\n - `23` INVITED_TO_COLLABORATE_TO_CHANNEL\n\n - `24` ACCEPTED_TO_COLLABORATE_TO_CHANNEL\n\n - `25` REFUSED_TO_COLLABORATE_TO_CHANNEL\n\n - `26` VIDEO_OWNERSHIP_CHANGED_REQUEST\n\n - `27` VIDEO_OWNERSHIP_CHANGED_ACCEPTED\n\n - `28` VIDEO_OWNERSHIP_CHANGED_REJECTED\n\n - `29` CHANNEL_OWNERSHIP_CHANGED_REQUEST\n\n - `30` CHANNEL_OWNERSHIP_CHANGED_ACCEPTED\n\n - `31` CHANNEL_OWNERSHIP_CHANGED_REJECTED\n\n - `32` AUTOMATIC_BLOCKLIST_UPDATE\n" }, "NewFeatureInfoType": { "type": "integer", "enum": [ 1 ], "description": "Represent a new feature that can be displayed to inform users. One of the following values:\n\n - `1` CHANNEL_COLLABORATION\n" }, "Notification": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "type": { "$ref": "#/components/schemas/NotificationType" }, "read": { "type": "boolean" }, "video": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/VideoInfo" }, { "type": "object", "properties": { "channel": { "$ref": "#/components/schemas/ActorInfo" } } } ] }, "videoImport": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "video": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/VideoInfo" } ] }, "torrentName": { "type": "string", "nullable": true }, "magnetUri": { "$ref": "#/components/schemas/VideoImport/properties/magnetUri" }, "targetUri": { "type": "string", "format": "uri", "nullable": true } } }, "comment": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "threadId": { "type": "integer" }, "video": { "$ref": "#/components/schemas/VideoInfo" }, "account": { "$ref": "#/components/schemas/ActorInfo" }, "heldForReview": { "type": "boolean" } } }, "videoAbuse": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "video": { "allOf": [ { "$ref": "#/components/schemas/VideoInfo" } ] } } }, "videoBlacklist": { "nullable": true, "type": "object", "properties": { "id": { "$ref": "#/components/schemas/id" }, "video": { "allOf": [ { "$ref": "#/components/schemas/VideoInfo" } ] } } }, "account": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/ActorInfo" } ] }, "actorFollow": { "type": "object", "nullable": true, "properties": { "id": { "$ref": "#/components/schemas/id" }, "follower": { "$ref": "#/components/schemas/ActorInfo" }, "state": { "type": "string", "enum": [ "pending", "accepted" ] }, "following": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "account", "channel", "instance" ] }, "name": { "type": "string" }, "displayName": { "type": "string" }, "host": { "type": "string", "format": "hostname" } } } } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "NotificationListResponse": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Notification" } } } }, "Plugin": { "properties": { "name": { "type": "string", "example": "peertube-plugin-auth-ldap" }, "type": { "type": "integer", "description": "- `1`: PLUGIN\n- `2`: THEME\n", "enum": [ 1, 2 ] }, "latestVersion": { "type": "string", "example": "0.0.3" }, "version": { "type": "string", "example": "0.0.1" }, "enabled": { "type": "boolean" }, "uninstalled": { "type": "boolean" }, "peertubeEngine": { "type": "string", "example": "2.2.0" }, "description": { "type": "string" }, "homepage": { "type": "string", "format": "url", "example": "https://framagit.org/framasoft/peertube/official-plugins/tree/master/peertube-plugin-auth-ldap" }, "settings": { "type": "object", "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "PluginResponse": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Plugin" } } } }, "LiveVideoUpdate": { "properties": { "saveReplay": { "type": "boolean" }, "replaySettings": { "$ref": "#/components/schemas/LiveVideoReplaySettings" }, "permanentLive": { "description": "User can stream multiple times in a permanent live", "type": "boolean" }, "latencyMode": { "description": "User can select live latency mode if enabled by the instance", "allOf": [ { "$ref": "#/components/schemas/LiveVideoLatencyMode" } ] }, "schedules": { "type": "array", "items": { "$ref": "#/components/schemas/LiveSchedule" } } } }, "LiveVideoResponse": { "properties": { "rtmpUrl": { "type": "string", "description": "Included in the response if an appropriate token is provided" }, "rtmpsUrl": { "type": "string", "description": "Included in the response if an appropriate token is provided" }, "streamKey": { "type": "string", "description": "RTMP stream key to use to stream into this live video. Included in the response if an appropriate token is provided" }, "saveReplay": { "type": "boolean" }, "replaySettings": { "$ref": "#/components/schemas/LiveVideoReplaySettings" }, "permanentLive": { "description": "User can stream multiple times in a permanent live", "type": "boolean" }, "latencyMode": { "description": "User can select live latency mode if enabled by the instance", "allOf": [ { "$ref": "#/components/schemas/LiveVideoLatencyMode" } ] }, "schedules": { "type": "array", "items": { "$ref": "#/components/schemas/LiveSchedule" } } } }, "LiveSchedule": { "properties": { "startAt": { "type": "string", "format": "date-time", "description": "Date when the stream is scheduled to air at" } } }, "TokenSession": { "properties": { "id": { "type": "integer" }, "currentSession": { "type": "boolean", "description": "Is this session the current one?" }, "loginDevice": { "type": "string", "description": "Device used to login" }, "loginIP": { "type": "string", "format": "ipv4", "description": "IP address used to login" }, "loginDate": { "type": "string", "format": "date-time", "description": "Date of the login" }, "lastActivityDevice": { "type": "string" }, "lastActivityIP": { "type": "string", "format": "ipv4" }, "lastActivityDate": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" } } }, "RequestTwoFactorResponse": { "properties": { "otpRequest": { "type": "object", "properties": { "requestToken": { "type": "string", "description": "The token to send to confirm this request" }, "secret": { "type": "string", "description": "The OTP secret" }, "uri": { "type": "string", "description": "The OTP URI" } } } } }, "VideoStudioCreateTask": { "type": "array", "items": { "anyOf": [ { "title": "cut", "type": "object", "properties": { "name": { "type": "string", "enum": [ "cut" ] }, "options": { "type": "object", "properties": { "start": { "type": "integer" }, "end": { "type": "integer" } } } } }, { "title": "add-intro", "type": "object", "properties": { "name": { "type": "string", "enum": [ "add-intro" ] }, "options": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" } } } } }, { "title": "add-outro", "type": "object", "properties": { "name": { "type": "string", "enum": [ "add-outro" ] }, "options": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" } } } } }, { "title": "add-watermark", "type": "object", "properties": { "name": { "type": "string", "enum": [ "add-watermark" ] }, "options": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" } } } } }, { "title": "remove-segments", "type": "object", "properties": { "name": { "type": "string", "enum": [ "remove-segments" ] }, "options": { "type": "object", "required": [ "segments" ], "properties": { "segments": { "type": "array", "minItems": 1, "items": { "type": "object", "required": [ "start", "end" ], "properties": { "start": { "type": "integer", "minimum": 0 }, "end": { "type": "integer", "minimum": 1 } } } } } } } } ] } }, "LiveVideoSessionResponse": { "properties": { "id": { "type": "integer" }, "startDate": { "type": "string", "format": "date-time", "description": "Start date of the live session" }, "endDate": { "type": "string", "format": "date-time", "nullable": true, "description": "End date of the live session" }, "error": { "type": "integer", "enum": [ 1, 2, 3, 4, 5 ], "nullable": true, "description": "Error type if an error occurred during the live session:\n - `1`: Bad socket health (transcoding is too slow)\n - `2`: Max duration exceeded\n - `3`: Quota exceeded\n - `4`: Quota FFmpeg error\n - `5`: Video has been blacklisted during the live\n" }, "replayVideo": { "type": "object", "description": "Video replay information", "properties": { "id": { "type": "number" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "shortUUID": { "$ref": "#/components/schemas/shortUUID" } } } } }, "PlaybackMetricCreate": { "properties": { "playerMode": { "type": "string", "enum": [ "p2p-media-loader", "web-video" ] }, "resolution": { "type": "number", "description": "Current player video resolution" }, "fps": { "type": "number", "description": "Current player video fps" }, "p2pEnabled": { "type": "boolean" }, "p2pPeers": { "type": "number", "description": "P2P peers connected (doesn't include WebSeed peers)" }, "resolutionChanges": { "type": "number", "description": "How many resolution changes occurred since the last metric creation" }, "bufferStalled": { "type": "number", "description": "How many times buffer has been stalled since the last metric creation" }, "errors": { "type": "number", "description": "How many errors occurred since the last metric creation" }, "downloadedBytesP2P": { "type": "number", "description": "How many bytes were downloaded with P2P since the last metric creation" }, "downloadedBytesHTTP": { "type": "number", "description": "How many bytes were downloaded with HTTP since the last metric creation" }, "uploadedBytesP2P": { "type": "number", "description": "How many bytes were uploaded with P2P since the last metric creation" }, "videoId": { "oneOf": [ { "$ref": "#/components/schemas/id" }, { "$ref": "#/components/schemas/UUIDv4" }, { "$ref": "#/components/schemas/shortUUID" } ] } }, "required": [ "playerMode", "resolutionChanges", "errors", "downloadedBytesP2P", "downloadedBytesHTTP", "uploadedBytesP2P", "p2pEnabled", "videoId" ] }, "RunnerRegistrationToken": { "properties": { "id": { "type": "integer" }, "registrationToken": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "registeredRunnersCount": { "type": "integer" } } }, "Runner": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "description": { "type": "string" }, "ip": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "lastContact": { "type": "string", "format": "date-time" } } }, "RunnerJobType": { "type": "string", "enum": [ "vod-web-video-transcoding", "vod-hls-transcoding", "vod-audio-merge-transcoding", "live-rtmp-hls-transcoding" ] }, "RunnerJobState": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 8 ], "description": "The runner job state:\n - `1` Pending\n - `2` Processing\n - `3` Completed\n - `4` Errored\n - `5` Waiting for a parent job\n - `6` Cancelled\n - `7` Parent had an error\n - `8` Parent has been cancelled\n" }, "RunnerJobStateConstant": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/RunnerJobState" }, "label": { "type": "string", "example": "Processing" } } }, "RunnerJobPayload": { "anyOf": [ { "type": "object", "title": "VOD web video transcoding", "properties": { "input": { "type": "object", "properties": { "videoFileUrl": { "type": "string" } } }, "output": { "type": "object", "properties": { "resolution": { "type": "number" }, "fps": { "type": "number" } } } } }, { "type": "object", "title": "VOD HLS transcoding", "properties": { "input": { "type": "object", "properties": { "videoFileUrl": { "type": "string" } } }, "output": { "type": "object", "properties": { "resolution": { "type": "number" }, "fps": { "type": "number" } } } } }, { "type": "object", "title": "VOD audio merge transcoding", "properties": { "input": { "type": "object", "properties": { "audioFileUrl": { "type": "string" }, "previewFileUrl": { "type": "string" } } }, "output": { "type": "object", "properties": { "resolution": { "type": "number" }, "fps": { "type": "number" } } } } } ] }, "RunnerJob": { "properties": { "uuid": { "$ref": "#/components/schemas/UUIDv4" }, "type": { "$ref": "#/components/schemas/RunnerJobType" }, "state": { "$ref": "#/components/schemas/RunnerJobStateConstant" }, "payload": { "$ref": "#/components/schemas/RunnerJobPayload" }, "failures": { "type": "integer", "description": "Number of times a remote runner failed to process this job. After too many failures, the job in \"error\" state" }, "error": { "nullable": true, "type": "string", "description": "Error message if the job is errored" }, "progress": { "type": "integer", "description": "Percentage progress" }, "priority": { "type": "integer", "description": "Job priority (less has more priority)" }, "updatedAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "startedAt": { "type": "string", "format": "date-time" }, "finishedAt": { "type": "string", "format": "date-time" }, "parent": { "nullable": true, "description": "If job has a parent job", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/RunnerJobType" }, "state": { "$ref": "#/components/schemas/RunnerJobStateConstant" }, "uuid": { "$ref": "#/components/schemas/UUIDv4" } } }, "runner": { "nullable": true, "description": "If job is associated to a runner", "properties": { "id": { "type": "number" }, "name": { "type": "string" }, "description": { "type": "string" } } } } }, "RunnerJobAdmin": { "allOf": [ { "$ref": "#/components/schemas/RunnerJob" }, { "type": "object", "properties": { "privatePayload": { "type": "object" } } } ] }, "WatchedWordsLists": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "listName": { "type": "string" }, "words": { "type": "array", "items": { "type": "string" } }, "subscriptionUrl": { "type": "string", "format": "url", "nullable": true }, "updatedAt": { "type": "string", "format": "date-time", "example": "2021-05-04T08:01:01.502Z" }, "createdAt": { "type": "string", "format": "date-time", "example": "2021-05-04T08:01:01.502Z" } } }, "WatchedWordsSubscription": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "name": { "type": "string" }, "url": { "type": "string", "format": "url" }, "importedWordsCount": { "type": "integer", "minimum": 0 }, "lastSyncAt": { "type": "string", "format": "date-time", "nullable": true, "example": "2021-05-04T08:01:01.502Z" }, "state": { "type": "object", "properties": { "id": { "type": "integer", "enum": [ 1, 2, 3, 4 ] }, "label": { "type": "string" } } }, "updatedAt": { "type": "string", "format": "date-time", "example": "2021-05-04T08:01:01.502Z" }, "createdAt": { "type": "string", "format": "date-time", "example": "2021-05-04T08:01:01.502Z" } } }, "VideoPassword": { "properties": { "id": { "$ref": "#/components/schemas/id" }, "password": { "type": "string", "minLength": 2 }, "videoId": { "$ref": "#/components/schemas/id" } } }, "VideoPasswordList": { "properties": { "total": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPassword" } } } }, "AddVideoPasswords": { "type": "array", "items": { "$ref": "#/components/schemas/VideoPassword/properties/password" }, "uniqueItems": true }, "VideoEmbedPrivacy": { "type": "integer", "enum": [ 1, 2, 3 ], "description": "The video embed privacy level:\n - `1` All allowed: anyone can embed the video\n - `2` Allowlist: only the domains in the allowlist can embed the video\n - `3` Remote restrictions: the remote instance has restrictions on where the video can be embedded\n" }, "PlayerTheme": { "type": "string", "enum": [ "galaxy", "lucide" ], "description": "The player theme to use" }, "PlayerThemeChannelSetting": { "type": "string", "enum": [ "instance-default", "galaxy", "lucide" ], "description": "Player theme setting for a channel:\n - `instance-default` Use the instance default theme\n - `galaxy` Use the galaxy theme\n - `lucide` Use the lucide theme\n" }, "PlayerThemeVideoSetting": { "type": "string", "enum": [ "channel-default", "instance-default", "galaxy", "lucide" ], "description": "Player theme setting for a video:\n - `channel-default` Use the channel default theme\n - `instance-default` Use the instance default theme\n - `galaxy` Use the galaxy theme\n - `lucide` Use the lucide theme\n" }, "PlayerVideoSettings": { "type": "object", "properties": { "theme": { "$ref": "#/components/schemas/PlayerThemeVideoSetting" } }, "description": "Player settings for a video" }, "PlayerChannelSettings": { "type": "object", "properties": { "theme": { "$ref": "#/components/schemas/PlayerThemeChannelSetting" } }, "description": "Player settings for a channel" }, "PlayerVideoSettingsUpdate": { "type": "object", "properties": { "theme": { "$ref": "#/components/schemas/PlayerThemeVideoSetting" } }, "required": [ "theme" ], "description": "Player settings update for a video" }, "PlayerChannelSettingsUpdate": { "type": "object", "properties": { "theme": { "$ref": "#/components/schemas/PlayerThemeChannelSetting" } }, "required": [ "theme" ], "description": "Player settings update for a channel" }, "FileStorage": { "type": "integer", "enum": [ 0, 1 ], "description": "The file storage type:\n - `0` File system\n - `1` Object storage\n" }, "VideoChannelCollaborator": { "type": "object", "description": "Representation of a channel collaboration", "properties": { "id": { "$ref": "#/components/schemas/id" }, "account": { "$ref": "#/components/schemas/AccountSummary" }, "state": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/VideoChannelCollaboratorState" }, "label": { "type": "string" } } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "VideoChannelCollaboratorState": { "type": "integer", "enum": [ 1, 2 ], "description": "The user import state:\n - `1`: Pending\n - `2`: Accepted\n" } } } }