description: Video transcoding related operations
- name: Video stats
description: Video statistics
- - name: Feeds
- description: Server syndication feeds
+ - name: Video Feeds
+ description: Server syndication feeds of videos
- name: Search
description: |
The search helps to find _videos_ or _channels_ from within the instance and beyond.
Statistics
x-tagGroups:
+ - name: Static endpoints
+ tags:
+ - Static Video Files
+ - name: Feeds
+ tags:
+ - Video Feeds
- name: Auth
tags:
- Register
- Video Files
- Video Transcoding
- Live Videos
- - Feeds
- Channels Sync
- name: Search
tags:
- Logs
- Job
paths:
- '/accounts/{name}':
+ '/static/webseed/{filename}':
get:
tags:
- - Accounts
- summary: Get an account
- operationId: getAccount
+ - Static Video Files
+ summary: Get public WebTorrent video file
parameters:
- - $ref: '#/components/parameters/name'
+ - $ref: '#/components/parameters/staticFilename'
responses:
'200':
description: successful operation
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/Account'
'404':
- description: account not found
-
- '/accounts/{name}/videos':
+ description: not found
+ '/static/webseed/private/{filename}':
get:
tags:
- - Accounts
- - Video
- summary: 'List videos of an account'
- operationId: getAccountVideos
+ - Static Video Files
+ summary: Get private WebTorrent video file
parameters:
- - $ref: '#/components/parameters/name'
- - $ref: '#/components/parameters/categoryOneOf'
- - $ref: '#/components/parameters/isLive'
- - $ref: '#/components/parameters/tagsOneOf'
- - $ref: '#/components/parameters/tagsAllOf'
- - $ref: '#/components/parameters/licenceOneOf'
- - $ref: '#/components/parameters/languageOneOf'
- - $ref: '#/components/parameters/nsfw'
- - $ref: '#/components/parameters/isLocal'
- - $ref: '#/components/parameters/include'
- - $ref: '#/components/parameters/privacyOneOf'
- - $ref: '#/components/parameters/hasHLSFiles'
- - $ref: '#/components/parameters/hasWebtorrentFiles'
- - $ref: '#/components/parameters/skipCount'
- - $ref: '#/components/parameters/start'
- - $ref: '#/components/parameters/count'
- - $ref: '#/components/parameters/videosSort'
+ - $ref: '#/components/parameters/staticFilename'
+ - $ref: '#/components/parameters/videoFileToken'
+ security:
+ - OAuth2: []
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')
- .then(function(response) {
- return response.json()
- }).then(function(data) {
- console.log(data)
- })
- - lang: Shell
- source: |
- ## DEPENDENCIES: jq
- curl -s https://peertube2.cpy.re/api/v1/accounts/{name}/videos | jq
- - lang: Ruby
- source: |
- require 'net/http'
- require 'json'
-
- uri = URI.parse("https://peertube2.cpy.re/api/v1/accounts/{name}/videos")
-
- http = Net::HTTP.new(uri.host, uri.port)
- http.use_ssl = true
-
- response = http.get(uri.request_uri)
-
- puts JSON.parse(response.read_body)
- - lang: Python
- source: |
- import requests
-
- r = requests.get("https://peertube2.cpy.re/api/v1//accounts/{name}/videos")
- json = r.json()
-
- print(json)
+ '403':
+ description: invalid auth
+ '404':
+ description: not found
- '/accounts/{name}/followers':
+ '/static/streaming-playlists/hls/{filename}':
get:
tags:
- - Accounts
- summary: 'List followers of an account'
+ - Static Video Files
+ summary: Get public HLS video file
+ parameters:
+ - $ref: '#/components/parameters/staticFilename'
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'
-
- /accounts:
+ '403':
+ description: invalid auth
+ '404':
+ description: not found
+ '/static/streaming-playlists/hls/private/{filename}':
get:
tags:
- - Accounts
- summary: List accounts
- operationId: getAccounts
+ - Static Video Files
+ summary: Get private HLS video file
parameters:
- - $ref: '#/components/parameters/start'
- - $ref: '#/components/parameters/count'
- - $ref: '#/components/parameters/sort'
+ - $ref: '#/components/parameters/staticFilename'
+ - $ref: '#/components/parameters/videoFileToken'
+ security:
+ - OAuth2: []
responses:
'200':
description: successful operation
- content:
- 'application/json':
- schema:
- type: array
- items:
- $ref: '#/components/schemas/Account'
+ '403':
+ description: invalid auth
+ '404':
+ description: not found
- /config:
+
+ '/feeds/video-comments.{format}':
get:
tags:
- - Config
- summary: Get instance public configuration
- operationId: getConfig
+ - Video Feeds
+ summary: List comments on videos
+ operationId: getSyndicatedComments
+ parameters:
+ - name: format
+ in: path
+ required: true
+ description: 'format expected (we focus on making `rss` the most featureful ; 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 to a specific video'
+ schema:
+ type: string
+ - 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
responses:
- '200':
+ '204':
description: successful operation
+ headers:
+ Cache-Control:
+ schema:
+ type: string
+ default: 'max-age=900' # 15 min cache
content:
- application/json:
+ application/xml:
schema:
- $ref: '#/components/schemas/ServerConfig'
+ $ref: '#/components/schemas/VideoCommentsForXML'
examples:
nightly:
- externalValue: https://peertube2.cpy.re/api/v1/config
-
- /config/about:
- get:
- summary: Get instance "About" information
- operationId: getAbout
- tags:
- - Config
- responses:
- '200':
- description: successful operation
- content:
- application/json:
+ externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?filter=local
+ application/rss+xml:
schema:
- $ref: '#/components/schemas/ServerConfigAbout'
+ $ref: '#/components/schemas/VideoCommentsForXML'
examples:
nightly:
- externalValue: https://peertube2.cpy.re/api/v1/config/about
-
- /config/custom:
- get:
- summary: Get instance runtime configuration
- operationId: getCustomConfig
- tags:
- - Config
- security:
- - OAuth2:
- - admin
- responses:
- '200':
- description: successful operation
- content:
+ externalValue: https://peertube2.cpy.re/feeds/video-comments.rss?filter=local
+ text/xml:
+ schema:
+ $ref: '#/components/schemas/VideoCommentsForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?filter=local
+ application/atom+xml:
+ schema:
+ $ref: '#/components/schemas/VideoCommentsForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/video-comments.atom?filter=local
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
+ type: object
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/video-comments.json?filter=local
'400':
x-summary: field inconsistencies
description: >
Arises when:
- - the emailer is disabled and the instance is open to registrations
- - webtorrent and hls are disabled with transcoding enabled - you need at least one enabled
- delete:
- summary: Delete instance runtime configuration
- operationId: delCustomConfig
- tags:
- - Config
- security:
- - OAuth2:
- - admin
- responses:
- '200':
- description: successful operation
+ - videoId filter is mixed with a channel filter
+ '404':
+ description: video, video channel or account not found
+ '406':
+ description: accept header unsupported
- /custom-pages/homepage/instance:
+ '/feeds/videos.{format}':
get:
- summary: Get instance custom homepage
tags:
- - Homepage
+ - Video Feeds
+ summary: List videos
+ operationId: getSyndicatedVideos
+ parameters:
+ - name: format
+ in: path
+ required: true
+ description: 'format expected (we focus on making `rss` the most featureful ; 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/hasWebtorrentFiles'
+ responses:
+ '204':
+ description: successful operation
+ headers:
+ Cache-Control:
+ schema:
+ type: string
+ default: 'max-age=900' # 15 min cache
+ content:
+ application/xml:
+ schema:
+ $ref: '#/components/schemas/VideosForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/videos.xml?filter=local
+ application/rss+xml:
+ schema:
+ $ref: '#/components/schemas/VideosForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/videos.rss?filter=local
+ text/xml:
+ schema:
+ $ref: '#/components/schemas/VideosForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/videos.xml?filter=local
+ application/atom+xml:
+ schema:
+ $ref: '#/components/schemas/VideosForXML'
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/videos.atom?filter=local
+ application/json:
+ schema:
+ type: object
+ examples:
+ nightly:
+ externalValue: https://peertube2.cpy.re/feeds/videos.json?filter=local
+ '404':
+ description: video channel or account not found
+ '406':
+ description: accept header unsupported
+
+ '/feeds/subscriptions.{format}':
+ get:
+ tags:
+ - Video Feeds
+ summary: List videos of subscriptions tied to a token
+ operationId: getSyndicatedSubscriptionVideos
+ parameters:
+ - name: format
+ in: path
+ required: true
+ description: 'format expected (we focus on making `rss` the most featureful ; 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/hasWebtorrentFiles'
+ responses:
+ '204':
+ description: successful operation
+ headers:
+ Cache-Control:
+ schema:
+ type: string
+ default: 'max-age=900' # 15 min cache
+ 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
+
+ '/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/categoryOneOf'
+ - $ref: '#/components/parameters/isLive'
+ - $ref: '#/components/parameters/tagsOneOf'
+ - $ref: '#/components/parameters/tagsAllOf'
+ - $ref: '#/components/parameters/licenceOneOf'
+ - $ref: '#/components/parameters/languageOneOf'
+ - $ref: '#/components/parameters/nsfw'
+ - $ref: '#/components/parameters/isLocal'
+ - $ref: '#/components/parameters/include'
+ - $ref: '#/components/parameters/privacyOneOf'
+ - $ref: '#/components/parameters/hasHLSFiles'
+ - $ref: '#/components/parameters/hasWebtorrentFiles'
+ - $ref: '#/components/parameters/skipCount'
+ - $ref: '#/components/parameters/start'
+ - $ref: '#/components/parameters/count'
+ - $ref: '#/components/parameters/videosSort'
+ 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')
+ .then(function(response) {
+ return response.json()
+ }).then(function(data) {
+ console.log(data)
+ })
+ - lang: Shell
+ source: |
+ ## DEPENDENCIES: jq
+ curl -s https://peertube2.cpy.re/api/v1/accounts/{name}/videos | jq
+ - lang: Ruby
+ source: |
+ require 'net/http'
+ require 'json'
+
+ uri = URI.parse("https://peertube2.cpy.re/api/v1/accounts/{name}/videos")
+
+ http = Net::HTTP.new(uri.host, uri.port)
+ http.use_ssl = true
+
+ response = http.get(uri.request_uri)
+
+ puts JSON.parse(response.read_body)
+ - lang: Python
+ source: |
+ import requests
+
+ r = requests.get("https://peertube2.cpy.re/api/v1//accounts/{name}/videos")
+ json = r.json()
+
+ print(json)
+
+ '/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: 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:
+ externalValue: https://peertube2.cpy.re/api/v1/config
+
+ /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:
+ externalValue: https://peertube2.cpy.re/api/v1/config/about
+
+ /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:
+ - the emailer is disabled and the instance is open to registrations
+ - webtorrent and hls are disabled with transcoding enabled - you need at least one enabled
+ delete:
+ summary: Delete instance runtime configuration
+ operationId: delCustomConfig
+ tags:
+ - Config
+ security:
+ - OAuth2:
+ - admin
+ responses:
+ '200':
+ description: successful operation
+
+ /api/v1/custom-pages/homepage/instance:
+ get:
+ summary: Get instance custom homepage
+ tags:
+ - Homepage
responses:
'404':
description: No homepage set
'204':
description: successful operation
- /jobs/pause:
+ /api/v1/jobs/pause:
post:
summary: Pause job queue
security:
'204':
description: successful operation
- /jobs/resume:
+ /api/v1/jobs/resume:
post:
summary: Resume job queue
security:
'204':
description: successful operation
- /jobs/{state}:
+ /api/v1/jobs/{state}:
get:
summary: List instance jobs
operationId: getJobs
items:
$ref: '#/components/schemas/Job'
- /server/followers:
+ /api/v1/server/followers:
get:
tags:
- Instance Follows
items:
$ref: '#/components/schemas/Follow'
- '/server/followers/{nameWithHost}':
+ '/api/v1/server/followers/{nameWithHost}':
delete:
summary: Remove or reject a follower to your server
security:
'404':
description: follower not found
- '/server/followers/{nameWithHost}/reject':
+ '/api/v1/server/followers/{nameWithHost}/reject':
post:
summary: Reject a pending follower to your server
security:
'404':
description: follower not found
- '/server/followers/{nameWithHost}/accept':
+ '/api/v1/server/followers/{nameWithHost}/accept':
post:
summary: Accept a pending follower to your server
security:
'404':
description: follower not found
- /server/following:
+ /api/v1/server/following:
get:
tags:
- Instance Follows
type: string
uniqueItems: true
- '/server/following/{hostOrHandle}':
+ '/api/v1/server/following/{hostOrHandle}':
delete:
summary: Unfollow an actor (PeerTube instance, channel or account)
security:
'404':
description: host or handle not found
- /users:
+ /api/v1/users:
post:
summary: Create a user
operationId: addUser
items:
$ref: '#/components/schemas/User'
- '/users/{id}':
+ '/api/v1/users/{id}':
parameters:
- $ref: '#/components/parameters/id'
delete:
$ref: '#/components/schemas/UpdateUser'
required: true
- /oauth-clients/local:
+ /api/v1/oauth-clients/local:
get:
summary: Login prerequisite
description: You need to retrieve a client id and secret before [logging in](#operation/getOAuthToken).
## AUTH
curl -s "$API/oauth-clients/local"
- /users/token:
+ /api/v1/users/token:
post:
summary: Login
operationId: getOAuthToken
--data password="$PASSWORD" \
| jq -r ".access_token"
- /users/revoke-token:
+ /api/v1/users/revoke-token:
post:
summary: Logout
description: Revokes your access token and its associated refresh token, destroying your current session.
'200':
description: successful operation
- /users/register:
+ /api/v1/users/register:
post:
summary: Register a user
operationId: registerUser
$ref: '#/components/schemas/RegisterUser'
required: true
- /users/{id}/verify-email:
+ /api/v1/users/{id}/verify-email:
post:
summary: Verify a user
operationId: verifyUser
'404':
description: user not found
- /users/{id}/two-factor/request:
+ /api/v1/users/{id}/two-factor/request:
post:
summary: Request two factor auth
operationId: requestTwoFactor
'404':
description: user not found
- /users/{id}/two-factor/confirm-request:
+ /api/v1/users/{id}/two-factor/confirm-request:
post:
summary: Confirm two factor auth
operationId: confirmTwoFactorRequest
'404':
description: user not found
- /users/{id}/two-factor/disable:
+ /api/v1/users/{id}/two-factor/disable:
post:
summary: Disable two factor auth
operationId: disableTwoFactor
description: user not found
- /users/ask-send-verify-email:
+ /api/v1/users/ask-send-verify-email:
post:
summary: Resend user verification link
operationId: resendEmailToVerifyUser
'204':
description: successful operation
- /users/me:
+ /api/v1/users/me:
get:
summary: Get my user information
operationId: getUserInfo
$ref: '#/components/schemas/UpdateMe'
required: true
- /users/me/videos/imports:
+ /api/v1/users/me/videos/imports:
get:
summary: Get video imports of my user
security:
schema:
$ref: '#/components/schemas/VideoImportsList'
- /users/me/video-quota-used:
+ /api/v1/users/me/video-quota-used:
get:
summary: Get my user used quota
security:
description: The user video quota used today in bytes
example: 1681014151
- '/users/me/videos/{videoId}/rating':
+ '/api/v1/users/me/videos/{videoId}/rating':
get:
summary: Get rate of my user for a video
security:
schema:
$ref: '#/components/schemas/GetMeVideoRating'
- /users/me/videos:
+ /api/v1/users/me/videos:
get:
summary: Get videos of my user
security:
schema:
$ref: '#/components/schemas/VideoListResponse'
- /users/me/subscriptions:
+ /api/v1/users/me/subscriptions:
get:
summary: Get my user subscriptions
security:
'200':
description: successful operation
- /users/me/subscriptions/exist:
+ /api/v1/users/me/subscriptions/exist:
get:
summary: Get if subscriptions exist for my user
security:
schema:
type: object
- /users/me/subscriptions/videos:
+ /api/v1/users/me/subscriptions/videos:
get:
summary: List videos of subscriptions of my user
security:
schema:
$ref: '#/components/schemas/VideoListResponse'
- '/users/me/subscriptions/{subscriptionHandle}':
+ '/api/v1/users/me/subscriptions/{subscriptionHandle}':
get:
summary: Get subscription of my user
security:
'200':
description: successful operation
- /users/me/notifications:
+ /api/v1/users/me/notifications:
get:
summary: List my notifications
security:
schema:
$ref: '#/components/schemas/NotificationListResponse'
- /users/me/notifications/read:
+ /api/v1/users/me/notifications/read:
post:
summary: Mark notifications as read by their id
security:
'204':
description: successful operation
- /users/me/notifications/read-all:
+ /api/v1/users/me/notifications/read-all:
post:
summary: Mark all my notification as read
security:
'204':
description: successful operation
- /users/me/notification-settings:
+ /api/v1/users/me/notification-settings:
put:
summary: Update my notification settings
security:
'204':
description: successful operation
- /users/me/history/videos:
+ /api/v1/users/me/history/videos:
get:
summary: List watched videos history
security:
schema:
$ref: '#/components/schemas/VideoListResponse'
- /users/me/history/videos/{videoId}:
+ /api/v1/users/me/history/videos/{videoId}:
delete:
summary: Delete history element
security:
'204':
description: successful operation
- /users/me/history/videos/remove:
+ /api/v1/users/me/history/videos/remove:
post:
summary: Clear video history
security:
'204':
description: successful operation
- /users/me/avatar/pick:
+ /api/v1/users/me/avatar/pick:
post:
summary: Update my user avatar
security:
avatarfile:
contentType: image/png, image/jpeg
- /users/me/avatar:
+ /api/v1/users/me/avatar:
delete:
summary: Delete my avatar
security:
'204':
description: successful operation
- /videos/ownership:
+ /api/v1/videos/ownership:
get:
summary: List video ownership changes
tags:
'200':
description: successful operation
- '/videos/ownership/{id}/accept':
+ '/api/v1/videos/ownership/{id}/accept':
post:
summary: Accept ownership change request
tags:
'404':
description: video ownership change not found
- '/videos/ownership/{id}/refuse':
+ '/api/v1/videos/ownership/{id}/refuse':
post:
summary: Refuse ownership change request
tags:
'404':
description: video ownership change not found
- '/videos/{id}/give-ownership':
+ '/api/v1/videos/{id}/give-ownership':
post:
summary: Request ownership change
tags:
'404':
description: video not found
- /videos/{id}/studio/edit:
+ '/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'
+ 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:
'404':
description: video not found
- /videos:
+ /api/v1/videos:
get:
summary: List videos
operationId: getVideos
schema:
$ref: '#/components/schemas/VideoListResponse'
- /videos/categories:
+ /api/v1/videos/categories:
get:
summary: List available video categories
operationId: getCategories
nightly:
externalValue: https://peertube2.cpy.re/api/v1/videos/categories
- /videos/licences:
+ /api/v1/videos/licences:
get:
summary: List available video licences
operationId: getLicences
nightly:
externalValue: https://peertube2.cpy.re/api/v1/videos/licences
- /videos/languages:
+ /api/v1/videos/languages:
get:
summary: List available video languages
operationId: getLanguages
nightly:
externalValue: https://peertube2.cpy.re/api/v1/videos/languages
- /videos/privacies:
+ /api/v1/videos/privacies:
get:
summary: List available video privacy policies
operationId: getPrivacyPolicies
nightly:
externalValue: https://peertube2.cpy.re/api/v1/videos/privacies
- '/videos/{id}':
+ '/api/v1/videos/{id}':
put:
summary: Update a video
operationId: putVideo
'204':
description: successful operation
- '/videos/{id}/description':
+ '/api/v1/videos/{id}/description':
get:
summary: Get complete video description
operationId: getVideoDesc
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)**
- '/videos/{id}/source':
+ '/api/v1/videos/{id}/source':
post:
summary: Get video source file metadata
operationId: getVideoSource
schema:
$ref: '#/components/schemas/VideoSource'
- '/videos/{id}/views':
+ '/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.
'204':
description: successful operation
- '/videos/{id}/watching':
+ '/api/v1/videos/{id}/watching':
put:
summary: Set watching progress of a video
deprecated: true
'204':
description: successful operation
- '/videos/{id}/stats/overall':
+ '/api/v1/videos/{id}/stats/overall':
get:
summary: Get overall stats of a video
tags:
schema:
$ref: '#/components/schemas/VideoStatsOverall'
- '/videos/{id}/stats/retention':
+ '/api/v1/videos/{id}/stats/retention':
get:
summary: Get retention stats of a video
tags:
schema:
$ref: '#/components/schemas/VideoStatsRetention'
- '/videos/{id}/stats/timeseries/{metric}':
+ '/api/v1/videos/{id}/stats/timeseries/{metric}':
get:
summary: Get timeserie stats of a video
tags:
schema:
$ref: '#/components/schemas/VideoStatsTimeserie'
- /videos/upload:
+ /api/v1/videos/upload:
post:
summary: Upload a video
description: Uses a single request to upload a video.
--form channelId=$CHANNEL_ID \
--form name="$NAME"
- /videos/upload-resumable:
+ /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
'404':
description: upload not found
- /videos/imports:
+ /api/v1/videos/imports:
post:
summary: Import a video
description: Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)
'409':
description: HTTP or Torrent/magnetURI import not enabled
- /videos/imports/{id}/cancel:
+ /api/v1/videos/imports/{id}/cancel:
post:
summary: Cancel video import
description: Cancel a pending video import
'204':
description: successful operation
- /videos/imports/{id}:
+ /api/v1/videos/imports/{id}:
delete:
summary: Delete video import
description: Delete ended video import
'204':
description: successful operation
- /videos/live:
+ /api/v1/videos/live:
post:
summary: Create a live
operationId: addLive
previewfile:
contentType: image/jpeg
- /videos/live/{id}:
+ /api/v1/videos/live/{id}:
get:
summary: Get information about a live
operationId: getLiveId
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
- /videos/live/{id}/sessions:
+ /api/v1/videos/live/{id}/sessions:
get:
summary: List live sessions
description: List all sessions created in a particular live
type: array
items:
$ref: '#/components/schemas/LiveVideoSessionResponse'
- /videos/{id}/live-session:
+ /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
schema:
$ref: '#/components/schemas/LiveVideoSessionResponse'
- /users/me/abuses:
+ /api/v1/users/me/abuses:
get:
summary: List my abuses
operationId: getMyAbuses
items:
$ref: '#/components/schemas/Abuse'
- /abuses:
+ /api/v1/abuses:
get:
summary: List abuses
operationId: getAbuses
'400':
description: incorrect request parameters
- '/abuses/{abuseId}':
+ '/api/v1/abuses/{abuseId}':
put:
summary: Update an abuse
security:
'404':
description: block not found
- '/abuses/{abuseId}/messages':
+ '/api/v1/abuses/{abuseId}/messages':
get:
summary: List messages of an abuse
security:
'400':
description: incorrect request parameters
- '/abuses/{abuseId}/messages/{abuseMessageId}':
+ '/api/v1/abuses/{abuseId}/messages/{abuseMessageId}':
delete:
summary: Delete an abuse message
security:
'204':
description: successful operation
- '/videos/{id}/blacklist':
+ '/api/v1/videos/{id}/blacklist':
post:
summary: Block a video
operationId: addVideoBlock
'404':
description: block not found
- /videos/blacklist:
+ /api/v1/videos/blacklist:
get:
tags:
- Video Blocks
items:
$ref: '#/components/schemas/VideoBlacklist'
- /videos/{id}/captions:
+ /api/v1/videos/{id}/captions:
get:
summary: List captions of a video
operationId: getVideoCaptions
items:
$ref: '#/components/schemas/VideoCaption'
- /videos/{id}/captions/{captionLanguage}:
+ /api/v1/videos/{id}/captions/{captionLanguage}:
put:
summary: Add or replace a video caption
operationId: addVideoCaption
'404':
description: video or language or caption for that language not found
- /video-channels:
+ /api/v1/video-channels:
get:
summary: List video channels
operationId: getVideoChannels
schema:
$ref: '#/components/schemas/VideoChannelCreate'
- '/video-channels/{channelHandle}':
+ '/api/v1/video-channels/{channelHandle}':
get:
summary: Get a video channel
operationId: getVideoChannel
'204':
description: successful operation
- '/video-channels/{channelHandle}/videos':
+ '/api/v1/video-channels/{channelHandle}/videos':
get:
summary: List videos of a video channel
operationId: getVideoChannelVideos
schema:
$ref: '#/components/schemas/VideoListResponse'
- '/video-channels/{channelHandle}/followers':
+ '/api/v1/video-channels/{channelHandle}/followers':
get:
tags:
- Video Channels
items:
$ref: '#/components/schemas/Follow'
- '/video-channels/{channelHandle}/avatar/pick':
+ '/api/v1/video-channels/{channelHandle}/avatar/pick':
post:
summary: Update channel avatar
security:
avatarfile:
contentType: image/png, image/jpeg
- '/video-channels/{channelHandle}/avatar':
+ '/api/v1/video-channels/{channelHandle}/avatar':
delete:
summary: Delete channel avatar
security:
'204':
description: successful operation
- '/video-channels/{channelHandle}/banner/pick':
+ '/api/v1/video-channels/{channelHandle}/banner/pick':
post:
summary: Update channel banner
security:
bannerfile:
contentType: image/png, image/jpeg
- '/video-channels/{channelHandle}/banner':
+ '/api/v1/video-channels/{channelHandle}/banner':
delete:
summary: Delete channel banner
security:
'204':
description: successful operation
- '/video-channels/{channelHandle}/import-videos':
+ '/api/v1/video-channels/{channelHandle}/import-videos':
post:
summary: Import videos in channel
description: Import a remote channel/playlist videos into a channel
'204':
description: successful operation
- '/video-channel-syncs':
+ '/api/v1/video-channel-syncs':
post:
summary: Create a synchronization for a video channel
operationId: addVideoChannelSync
videoChannelSync:
$ref: "#/components/schemas/VideoChannelSync"
- '/video-channel-syncs/{channelSyncId}':
+ '/api/v1/video-channel-syncs/{channelSyncId}':
delete:
summary: Delete a video channel synchronization
operationId: delVideoChannelSync
'204':
description: successful operation
- '/video-channel-syncs/{channelSyncId}/sync':
+ '/api/v1/video-channel-syncs/{channelSyncId}/sync':
post:
summary: Triggers the channel synchronization job, fetching all the videos from the remote channel
operationId: triggerVideoChannelSync
description: successful operation
- /video-playlists/privacies:
+ /api/v1/video-playlists/privacies:
get:
summary: List available playlist privacy policies
operationId: getPlaylistPrivacyPolicies
nightly:
externalValue: https://peertube2.cpy.re/api/v1/video-playlists/privacies
- /video-playlists:
+ /api/v1/video-playlists:
get:
summary: List video playlists
operationId: getPlaylists
thumbnailfile:
contentType: image/jpeg
- /video-playlists/{playlistId}:
+ /api/v1/video-playlists/{playlistId}:
get:
summary: Get a video playlist
tags:
'204':
description: successful operation
- /video-playlists/{playlistId}/videos:
+ /api/v1/video-playlists/{playlistId}/videos:
get:
summary: 'List videos of a playlist'
operationId: getVideoPlaylistVideos
required:
- videoId
- /video-playlists/{playlistId}/videos/reorder:
+ /api/v1/video-playlists/{playlistId}/videos/reorder:
post:
summary: 'Reorder a playlist'
operationId: reorderVideoPlaylist
- startPosition
- insertAfterPosition
- /video-playlists/{playlistId}/videos/{playlistElementId}:
+ /api/v1/video-playlists/{playlistId}/videos/{playlistElementId}:
put:
summary: Update a playlist element
operationId: putVideoPlaylistVideo
'204':
description: successful operation
- '/users/me/video-playlists/videos-exist':
+ '/api/v1/users/me/video-playlists/videos-exist':
get:
summary: Check video exists in my playlists
security:
type: integer
format: seconds
- '/accounts/{name}/video-channels':
+ '/api/v1/accounts/{name}/video-channels':
get:
summary: List video channels of an account
tags:
schema:
$ref: '#/components/schemas/VideoChannelList'
- '/accounts/{name}/video-channel-syncs':
+ '/api/v1/accounts/{name}/video-channel-syncs':
get:
summary: List the synchronizations of video channels of an account
tags:
schema:
$ref: '#/components/schemas/VideoChannelSyncList'
- '/accounts/{name}/ratings':
+ '/api/v1/accounts/{name}/ratings':
get:
summary: List ratings of an account
security:
items:
$ref: '#/components/schemas/VideoRating'
- '/videos/{id}/comment-threads':
+ '/api/v1/videos/{id}/comment-threads':
get:
summary: List threads of a video
tags:
required:
- text
- '/videos/{id}/comment-threads/{threadId}':
+ '/api/v1/videos/{id}/comment-threads/{threadId}':
get:
summary: Get a thread
tags:
schema:
$ref: '#/components/schemas/VideoCommentThreadTree'
- '/videos/{id}/comments/{commentId}':
+ '/api/v1/videos/{id}/comments/{commentId}':
post:
summary: Reply to a thread of a video
security:
'409':
description: comment is already deleted
- '/videos/{id}/rate':
+ '/api/v1/videos/{id}/rate':
put:
summary: Like/dislike a video
security:
'404':
description: video does not exist
- '/videos/{id}/hls':
+ '/api/v1/videos/{id}/hls':
delete:
summary: Delete video HLS files
security:
description: successful operation
'404':
description: video does not exist
- '/videos/{id}/webtorrent':
+ '/api/v1/videos/{id}/webtorrent':
delete:
summary: Delete video WebTorrent files
security:
'404':
description: video does not exist
- '/videos/{id}/transcoding':
+ '/api/v1/videos/{id}/transcoding':
post:
summary: Create a transcoding job
security:
'404':
description: video does not exist
- /search/videos:
+ /api/v1/search/videos:
get:
tags:
- Search
- $ref: '#/components/parameters/isLocal'
- $ref: '#/components/parameters/include'
- $ref: '#/components/parameters/privacyOneOf'
+ - $ref: '#/components/parameters/uuids'
- $ref: '#/components/parameters/hasHLSFiles'
- $ref: '#/components/parameters/hasWebtorrentFiles'
- $ref: '#/components/parameters/skipCount'
'500':
description: search index unavailable
- /search/video-channels:
+ /api/v1/search/video-channels:
get:
tags:
- Search
'500':
description: search index unavailable
- /search/video-playlists:
+ /api/v1/search/video-playlists:
get:
tags:
- Search
'500':
description: search index unavailable
- /blocklist/status:
+ /api/v1/blocklist/status:
get:
tags:
- Account Blocks
schema:
$ref: '#/components/schemas/BlockStatus'
- /server/blocklist/accounts:
+ /api/v1/server/blocklist/accounts:
get:
tags:
- Account Blocks
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/count'
- - $ref: '#/components/parameters/sort'
- responses:
- '200':
- description: successful operation
- post:
- tags:
- - Account Blocks
- summary: Block an account
- 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
-
- '/server/blocklist/accounts/{accountName}':
- delete:
- tags:
- - Account Blocks
- summary: Unblock an account by its handle
- 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
-
- /server/blocklist/servers:
- get:
- tags:
- - Server Blocks
- summary: List server blocks
- security:
- - OAuth2:
- - admin
- parameters:
- - $ref: '#/components/parameters/start'
- - $ref: '#/components/parameters/count'
- - $ref: '#/components/parameters/sort'
- responses:
- '200':
- description: successful operation
- post:
- tags:
- - Server Blocks
- summary: Block a 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
-
- '/server/blocklist/servers/{host}':
- delete:
- tags:
- - Server Blocks
- summary: Unblock a server by its domain
- 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: account block does not exist
-
- /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
-
- /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'
+ - $ref: '#/components/parameters/sort'
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
+ - Account Blocks
+ summary: Block an account
security:
- OAuth2:
- admin
schema:
type: object
properties:
- videoId:
- $ref: '#/components/schemas/Video/properties/id'
+ accountName:
+ type: string
+ example: chocobozzz@example.org
+ description: account to block, in the form `username@domain`
required:
- - videoId
+ - accountName
responses:
- '204':
+ '200':
description: successful operation
- '400':
- description: cannot mirror a local video
- '404':
- description: video does not exist
'409':
- description: video is already mirrored
+ description: self-blocking forbidden
- /server/redundancy/videos/{redundancyId}:
+ '/api/v1/server/blocklist/accounts/{accountName}':
delete:
tags:
- - Video Mirroring
- summary: Delete a mirror done on a video
- operationId: delMirroredVideo
+ - Account Blocks
+ summary: Unblock an account by its handle
security:
- OAuth2:
- admin
parameters:
- - name: redundancyId
+ - name: accountName
in: path
required: true
- description: id of an existing redundancy on a video
+ description: account to unblock, in the form `username@domain`
schema:
type: string
responses:
- '204':
+ '201':
description: successful operation
'404':
- description: video redundancy not found
+ description: account or account block does not exist
- /server/stats:
+ /api/v1/server/blocklist/servers:
get:
tags:
- - Stats
- summary: Get instance stats
- description: Get instance public statistics. This endpoint is cached.
- operationId: getInstanceStats
+ - Server Blocks
+ summary: List server blocks
+ security:
+ - OAuth2:
+ - admin
+ 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/ServerStats'
-
- /server/logs/client:
post:
tags:
- - Logs
- summary: Send client log
- operationId: sendClientLog
+ - Server Blocks
+ summary: Block a server
+ security:
+ - OAuth2:
+ - admin
requestBody:
content:
application/json:
schema:
- $ref: '#/components/schemas/SendClientLog'
+ 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
- /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
-
- /server/audit-logs:
- get:
+ '/api/v1/server/blocklist/servers/{host}':
+ delete:
tags:
- - Logs
- summary: Get instance audit logs
- operationId: getInstanceAuditLogs
+ - Server Blocks
+ summary: Unblock a server by its domain
security:
- OAuth2:
- admin
- responses:
- '200':
- description: successful operation
- content:
- application/json:
- schema:
- type: array
- items:
- type: string
-
- '/feeds/video-comments.{format}':
- get:
- tags:
- - Feeds
- summary: List comments on videos
- operationId: getSyndicatedComments
parameters:
- - name: format
+ - name: host
in: path
required: true
- description: 'format expected (we focus on making `rss` the most featureful ; 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 to a specific video'
- schema:
- type: string
- - 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'
+ description: server domain to unblock
schema:
type: string
+ format: hostname
responses:
'204':
description: successful operation
- headers:
- Cache-Control:
- schema:
- type: string
- default: 'max-age=900' # 15 min cache
- content:
- application/xml:
- schema:
- $ref: '#/components/schemas/VideoCommentsForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?filter=local
- application/rss+xml:
- schema:
- $ref: '#/components/schemas/VideoCommentsForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/video-comments.rss?filter=local
- text/xml:
- schema:
- $ref: '#/components/schemas/VideoCommentsForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?filter=local
- application/atom+xml:
- schema:
- $ref: '#/components/schemas/VideoCommentsForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/video-comments.atom?filter=local
- application/json:
- schema:
- type: object
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/video-comments.json?filter=local
- '400':
- x-summary: field inconsistencies
- description: >
- Arises when:
- - videoId filter is mixed with a channel filter
'404':
- description: video, video channel or account not found
- '406':
- description: accept header unsupported
+ description: account block does not exist
- '/feeds/videos.{format}':
- get:
+ /api/v1/server/redundancy/{host}:
+ put:
tags:
- - Feeds
- summary: List videos
- operationId: getSyndicatedVideos
+ - Instance Redundancy
+ summary: Update a server redundancy policy
+ security:
+ - OAuth2:
+ - admin
parameters:
- - name: format
+ - name: host
in: path
required: true
- description: 'format expected (we focus on making `rss` the most featureful ; 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'
+ description: server domain to mirror
schema:
type: string
- - name: videoChannelName
+ 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
- description: 'limit listing to a specific video channel'
+ required: true
+ description: direction of the mirror
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/hasWebtorrentFiles'
+ enum:
+ - my-videos
+ - remote-videos
+ - $ref: '#/components/parameters/start'
+ - $ref: '#/components/parameters/count'
+ - $ref: '#/components/parameters/videoRedundanciesSort'
responses:
- '204':
+ '200':
description: successful operation
- headers:
- Cache-Control:
- schema:
- type: string
- default: 'max-age=900' # 15 min cache
content:
- application/xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/videos.xml?filter=local
- application/rss+xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/videos.rss?filter=local
- text/xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/videos.xml?filter=local
- application/atom+xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/videos.atom?filter=local
application/json:
schema:
- type: object
- examples:
- nightly:
- externalValue: https://peertube2.cpy.re/feeds/videos.json?filter=local
+ 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 channel or account not found
- '406':
- description: accept header unsupported
+ description: video does not exist
+ '409':
+ description: video is already mirrored
- '/feeds/subscriptions.{format}':
- get:
+ /api/v1/server/redundancy/videos/{redundancyId}:
+ delete:
tags:
- - Feeds
- - Account
- summary: List videos of subscriptions tied to a token
- operationId: getSyndicatedSubscriptionVideos
+ - Video Mirroring
+ summary: Delete a mirror done on a video
+ operationId: delMirroredVideo
+ security:
+ - OAuth2:
+ - admin
parameters:
- - name: format
+ - name: redundancyId
in: path
required: true
- description: 'format expected (we focus on making `rss` the most featureful ; 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
+ description: id of an existing redundancy on a video
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/hasWebtorrentFiles'
responses:
'204':
description: successful operation
- headers:
- Cache-Control:
- schema:
- type: string
- default: 'max-age=900' # 15 min cache
+ '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/xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- application/rss+xml:
- schema:
- $ref: '#/components/schemas/VideosForXML'
- text/xml:
+ application/json:
schema:
- $ref: '#/components/schemas/VideosForXML'
- application/atom+xml:
+ $ref: '#/components/schemas/ServerStats'
+
+ /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:
- $ref: '#/components/schemas/VideosForXML'
+ 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: object
- '406':
- description: accept header unsupported
+ type: array
+ items:
+ type: string
- /plugins:
+ /api/v1/plugins:
get:
tags:
- Plugins
schema:
$ref: '#/components/schemas/PluginResponse'
- /plugins/available:
+ /api/v1/plugins/available:
get:
tags:
- Plugins
'503':
description: plugin index unavailable
- /plugins/install:
+ /api/v1/plugins/install:
post:
tags:
- Plugins
'400':
description: should have either `npmName` or `path` set
- /plugins/update:
+ /api/v1/plugins/update:
post:
tags:
- Plugins
'404':
description: existing plugin not found
- /plugins/uninstall:
+ /api/v1/plugins/uninstall:
post:
tags:
- Plugins
'404':
description: existing plugin not found
- /plugins/{npmName}:
+ /api/v1/plugins/{npmName}:
get:
tags:
- Plugins
'404':
description: plugin not found
- /plugins/{npmName}/settings:
+ /api/v1/plugins/{npmName}/settings:
put:
tags:
- Plugins
'404':
description: plugin not found
- /plugins/{npmName}/public-settings:
+ /api/v1/plugins/{npmName}/public-settings:
get:
tags:
- Plugins
'404':
description: plugin not found
- /plugins/{npmName}/registered-settings:
+ /api/v1/plugins/{npmName}/registered-settings:
get:
tags:
- Plugins
'404':
description: plugin not found
- /metrics/playback:
+ /api/v1/metrics/playback:
post:
summary: Create playback metrics
description: These metrics are exposed by OpenTelemetry metrics exporter if enabled.
description: successful operation
servers:
- - url: 'https://peertube2.cpy.re/api/v1'
+ - url: 'https://peertube2.cpy.re'
description: Live Test Server (live data - latest nightly version)
- - url: 'https://peertube3.cpy.re/api/v1'
+ - url: 'https://peertube3.cpy.re'
description: Live Test Server (live data - latest RC version)
- - url: 'https://peertube.cpy.re/api/v1'
+ - url: 'https://peertube.cpy.re'
description: Live Test Server (live data - stable version)
components:
parameters:
schema:
$ref: '#/components/schemas/VideoPrivacySet'
description: '**PeerTube >= 4.0** Display only videos in this specific privacy/privacies'
+ uuids:
+ name: uuids
+ in: query
+ required: false
+ schema:
+ items:
+ type: string
+ description: 'Find videos with specific UUIDs'
include:
name: include
in: query
- 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
+
+
securitySchemes:
OAuth2:
description: |
properties:
comment:
$ref: '#/components/schemas/VideoComment'
+ VideoTokenResponse:
+ properties:
+ files:
+ type: object
+ properties:
+ token:
+ type: string
+ expires:
+ type: string
+ format: date-time
VideoListResponse:
properties:
total:
nsfwPolicy:
$ref: '#/components/schemas/NSFWPolicy'
role:
- $ref: '#/components/schemas/UserRole'
- roleLabel:
- type: string
- enum:
- - User
- - Moderator
- - Administrator
+ type: object
+ properties:
+ id:
+ $ref: '#/components/schemas/UserRole'
+ label:
+ type: string
+ enum:
+ - User
+ - Moderator
+ - Administrator
theme:
type: string
description: Theme enabled by this user
projects / github / Chocobozzz / PeerTube.git / blobdiff