2018-11-15 08:10:15 -05:00
openapi : 3.0 .0
2018-01-24 04:44:52 -05:00
info :
2018-01-24 05:54:32 -05:00
title : PeerTube
2021-03-24 12:47:59 -04:00
version : 3.1 .0
2018-11-13 17:27:58 -05:00
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'
2018-11-16 08:33:48 -05:00
altText : PeerTube Project Homepage
2018-11-13 17:27:58 -05:00
description : |
# Introduction
2020-02-14 08:14:14 -05:00
2020-04-21 06:09:54 -04:00
The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite
2020-06-24 08:16:25 -04:00
HTTP/REST library for your programming language to use PeerTube. The spec API is fully compatible with
2018-11-16 08:33:48 -05:00
[ openapi-generator](https://github.com/OpenAPITools/openapi-generator/wiki/API-client-generator-HOWTO)
2020-06-24 08:16:25 -04:00
which generates a client SDK in the language of your choice - we generate some client SDKs automatically :
- [ Python](https://framagit.org/framasoft/peertube/clients/python)
- [ Go](https://framagit.org/framasoft/peertube/clients/go)
- [ Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin)
2018-11-15 08:10:15 -05:00
2021-02-12 04:12:19 -05:00
See the [Quick Start guide](https://docs.joinpeertube.org/api-rest-getting-started) so you can play with the PeerTube API.
2020-04-21 06:09:54 -04:00
2018-11-13 17:27:58 -05:00
# Authentication
2020-02-14 08:14:14 -05:00
2018-11-13 17:27:58 -05:00
When you sign up for an account, you are given the possibility to generate
2019-01-09 08:10:25 -05:00
sessions, and authenticate using this session token. One session token can
2018-11-13 17:27:58 -05:00
currently be used at a time.
2018-11-16 08:33:48 -05:00
2020-06-26 07:43:27 -04:00
## Roles
Accounts are given permissions based on their role. There are three roles on
2021-02-12 04:12:19 -05:00
PeerTube : Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin-managing-users?id=roles) for a detail of their permissions.
2020-06-26 07:43:27 -04:00
2018-11-16 08:33:48 -05:00
# Errors
2020-02-14 08:14:14 -05:00
2018-11-16 08:33:48 -05:00
The API uses standard HTTP status codes to indicate the success or failure
of the API call. The body of the response will be JSON in the following
format.
```
{
"code": "unauthorized_request" , // example inner error code
"error": "Token is invalid." // example exposed error message
}
```
2018-11-16 06:11:00 -05:00
externalDocs :
2019-07-06 09:11:26 -04:00
url : https://docs.joinpeertube.org/api-rest-reference.html
2018-11-13 17:27:58 -05:00
tags :
- name : Accounts
2018-11-15 08:10:15 -05:00
description : >
2020-07-02 08:23:50 -04:00
Accounts encompass remote accounts discovered across the federation,
2020-06-26 07:43:27 -04:00
and correspond to the main Actor, along with video channels a user can create, which
are also Actors.
When a comment is posted, it is done with your Account's Actor.
- name : Users
description : >
Using some features of PeerTube require authentication, for which User
2018-11-15 08:10:15 -05:00
provide different levels of permission as well as associated user
2020-06-26 07:43:27 -04:00
information. Each user has a corresponding local Account for federation.
- name : My User
description : >
Operations related to your own User, when logged-in.
- 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!
2020-11-25 18:27:59 -05:00
- name : My History
description : >
2020-12-03 08:10:54 -05:00
Operations related to your watch history.
2020-06-26 07:43:27 -04:00
- 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.
2018-11-13 17:27:58 -05:00
- name : Config
2018-11-15 08:10:15 -05:00
description : >
Each server exposes public information regarding supported videos and
options.
2018-11-13 17:27:58 -05:00
- name : Job
2018-11-15 08:10:15 -05:00
description : >
Jobs are long-running tasks enqueued and processed by the instance
2018-11-16 08:33:48 -05:00
itself. No additional worker registration is currently available.
2020-04-21 06:09:54 -04:00
- name : Instance Follows
2018-11-15 08:10:15 -05:00
description : >
Managing servers which the instance interacts with is crucial to the
2018-11-16 08:33:48 -05:00
concept of federation in PeerTube and external video indexation. The PeerTube
2019-01-09 08:10:25 -05:00
server then deals with inter-server ActivityPub operations and propagates
2018-11-13 17:27:58 -05:00
information across its social graph by posting activities to actors' inbox
endpoints.
2020-06-26 07:43:27 -04:00
externalDocs :
2021-02-12 04:12:19 -05:00
url : https://docs.joinpeertube.org/admin-following-instances?id=instances-follows
2020-06-25 05:14:43 -04:00
- 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`.
2020-06-26 07:43:27 -04:00
externalDocs :
2021-02-12 04:12:19 -05:00
url : https://docs.joinpeertube.org/admin-following-instances?id=instances-redundancy
2020-06-25 06:16:08 -04:00
- name : Plugins
description : >
2020-06-26 07:43:27 -04:00
Managing plugins installed from a local path or from NPM, or search for new ones.
externalDocs :
2021-02-12 04:12:19 -05:00
url : https://docs.joinpeertube.org/api-plugins
2020-07-08 09:51:46 -04:00
- name : Abuses
2018-11-13 17:27:58 -05:00
description : |
2020-07-08 09:51:46 -04:00
Abuses deal with reports of local or remote videos/comments/accounts alike.
2018-11-13 17:27:58 -05:00
- name : Video
description : |
Operations dealing with listing, uploading, fetching or modifying videos.
- name : Search
description : |
2020-06-10 09:18:15 -04:00
The search helps to find _videos_ or _channels_ from within the instance and beyond.
2018-11-13 17:27:58 -05:00
Videos from other instances federated by the instance (that is, instances
followed by the instance) can be found via keywords and other criteria of
the advanced search.
2020-06-10 09:18:15 -04:00
Administrators can also enable the use of a remote search system, indexing
videos and channels not could be not federated by the instance.
2020-04-21 06:09:54 -04:00
- name : Video Comments
2018-11-15 08:10:15 -05:00
description : >
Operations dealing with comments to a video. Comments are organized in
threads.
2020-04-21 06:09:54 -04:00
- name : Video Playlists
2019-12-27 11:52:53 -05:00
description : >
Operations dealing with playlists of videos. Playlists are bound to users
and/or channels.
2020-04-21 06:09:54 -04:00
- name : Video Channels
2018-11-15 08:10:15 -05:00
description : >
2020-06-24 09:13:24 -04:00
Operations dealing with the creation, modification and listing of videos within a channel.
2020-06-24 08:16:25 -04:00
- name : Video Blocks
2018-11-16 08:33:48 -05:00
description : >
2020-06-24 09:13:24 -04:00
Operations dealing with blocking videos (removing them from view and
2018-11-16 08:33:48 -05:00
preventing interactions).
2020-04-21 06:09:54 -04:00
- name : Video Rates
2018-11-16 08:33:48 -05:00
description : >
2020-04-21 06:09:54 -04:00
Like/dislike a video.
2020-06-24 08:16:25 -04:00
- name : Feeds
description : >
Server syndication feeds
2018-11-16 08:33:48 -05:00
x-tagGroups :
- name : Accounts
tags :
- Accounts
2020-04-21 06:09:54 -04:00
- Users
2019-07-29 08:33:16 -04:00
- My User
2020-04-21 06:09:54 -04:00
- My Subscriptions
2020-06-24 16:25:05 -04:00
- My Notifications
2020-11-25 18:27:59 -05:00
- My History
2018-11-16 08:33:48 -05:00
- name : Videos
tags :
- Video
2020-06-25 05:14:43 -04:00
- Video Captions
2020-04-21 06:09:54 -04:00
- Video Channels
- Video Comments
- Video Rates
- Video Playlists
- Video Ownership Change
2020-06-25 05:14:43 -04:00
- Video Mirroring
2020-11-09 05:21:08 -05:00
- Live Videos
2020-06-24 08:16:25 -04:00
- Feeds
2020-04-21 06:09:54 -04:00
- name : Search
tags :
- Search
2018-11-16 08:33:48 -05:00
- name : Moderation
tags :
2020-07-08 09:51:46 -04:00
- Abuses
2020-06-22 07:00:39 -04:00
- Video Blocks
2020-06-24 08:16:25 -04:00
- Account Blocks
- Server Blocks
2018-11-19 16:07:29 -05:00
- name : Instance Configuration
2018-11-16 08:33:48 -05:00
tags :
- Config
2020-04-21 06:09:54 -04:00
- Instance Follows
2020-06-25 05:14:43 -04:00
- Instance Redundancy
2020-06-25 06:16:08 -04:00
- Plugins
2018-11-16 08:33:48 -05:00
- name : Jobs
tags :
- Job
2018-01-24 04:44:52 -05:00
paths :
2018-05-25 03:57:16 -04:00
'/accounts/{name}' :
2018-01-24 04:44:52 -05:00
get :
tags :
- Accounts
2020-04-21 06:09:54 -04:00
summary : Get an account
2018-01-24 04:44:52 -05:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/name'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/Account'
2020-06-24 08:16:25 -04:00
'404' :
description : account not found
2018-05-25 03:57:16 -04:00
'/accounts/{name}/videos' :
2018-04-25 04:21:38 -04:00
get :
tags :
- Accounts
2018-11-13 17:27:58 -05:00
- Video
2020-04-21 06:09:54 -04:00
summary : 'List videos of an account'
2018-04-25 04:21:38 -04:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/name'
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/categoryOneOf'
- $ref : '#/components/parameters/tagsOneOf'
- $ref : '#/components/parameters/tagsAllOf'
- $ref : '#/components/parameters/licenceOneOf'
- $ref : '#/components/parameters/languageOneOf'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
- $ref : '#/components/parameters/skipCount'
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/videosSort'
2018-04-25 04:21:38 -04:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2018-11-13 17:27:58 -05:00
x-code-samples :
- lang : JavaScript
source : |
2018-11-15 11:08:42 -05:00
fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')
2018-11-13 17:27:58 -05:00
.then(function(response) {
return response.json()
}).then(function(data) {
console.log(data)
})
2018-11-15 11:08:42 -05:00
- lang : Shell
source : |
2020-07-28 07:48:55 -04:00
## DEPENDENCIES: jq
curl -s https://peertube2.cpy.re/api/v1/accounts/{name}/videos | jq
2018-11-16 08:33:48 -05:00
- lang : Ruby
source : |
require 'net/http'
2019-11-12 08:46:43 -05:00
require 'json'
2018-11-16 08:33:48 -05:00
2019-11-12 08:46:43 -05:00
uri = URI.parse("https://peertube2.cpy.re/api/v1/accounts/{name}/videos")
2018-11-16 08:33:48 -05:00
2019-11-12 08:46:43 -05:00
http = Net::HTTP.new(uri.host, uri.port)
2018-11-16 08:33:48 -05:00
http.use_ssl = true
2019-11-12 08:46:43 -05:00
response = http.get(uri.request_uri)
puts JSON.parse(response.read_body)
2018-11-16 08:33:48 -05:00
- lang : Python
source : |
2019-11-12 08:46:43 -05:00
import requests
2018-11-16 08:33:48 -05:00
2019-11-12 08:46:43 -05:00
r = requests.get("https://peertube2.cpy.re/api/v1//accounts/{name}/videos")
json = r.json()
2018-11-16 08:33:48 -05:00
2019-11-12 08:46:43 -05:00
print(json)
2018-01-24 04:44:52 -05:00
/accounts :
get :
tags :
- Accounts
2020-04-21 06:09:54 -04:00
summary : List accounts
2019-08-22 07:33:07 -04:00
parameters :
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
2018-11-15 11:08:42 -05:00
'application/json' :
2018-11-15 08:10:15 -05:00
schema :
type : array
items :
$ref : '#/components/schemas/Account'
2018-01-24 04:44:52 -05:00
/config :
get :
tags :
- Config
2020-04-21 06:09:54 -04:00
summary : Get instance public configuration
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/ServerConfig'
2018-11-16 06:11:00 -05:00
/config/about :
get :
2020-04-21 06:09:54 -04:00
summary : Get instance "About" information
2018-11-16 06:11:00 -05:00
tags :
- Config
responses :
'200' :
description : successful operation
2019-08-22 07:33:07 -04:00
content :
application/json :
schema :
$ref : '#/components/schemas/ServerConfigAbout'
2018-11-16 06:11:00 -05:00
/config/custom :
get :
2020-04-21 06:09:54 -04:00
summary : Get instance runtime configuration
2018-11-16 06:11:00 -05:00
tags :
- Config
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-11-16 06:11:00 -05:00
responses :
'200' :
description : successful operation
2019-08-22 07:33:07 -04:00
content :
application/json :
schema :
$ref : '#/components/schemas/ServerConfigCustom'
2018-11-16 06:11:00 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Set instance runtime configuration
2018-11-16 06:11:00 -05:00
tags :
- Config
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-11-16 06:11:00 -05:00
responses :
'200' :
description : successful operation
2020-06-26 07:43:27 -04:00
'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
2018-11-16 06:11:00 -05:00
delete :
2020-04-21 06:09:54 -04:00
summary : Delete instance runtime configuration
2018-11-16 06:11:00 -05:00
tags :
- Config
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-11-16 06:11:00 -05:00
responses :
'200' :
description : successful operation
2018-11-19 16:10:35 -05:00
/jobs/{state}:
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List instance jobs
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-01-24 04:44:52 -05:00
tags :
- Job
2018-02-17 13:24:56 -05:00
parameters :
- name : state
in : path
required : true
2020-12-13 13:27:25 -05:00
description : The state of the job ('' for for no filter)
2018-11-15 08:10:15 -05:00
schema :
type : string
2018-11-19 16:07:29 -05:00
enum :
2020-12-13 13:27:25 -05:00
- ''
2018-11-19 16:07:29 -05:00
- active
- completed
- failed
- waiting
- delayed
2020-12-13 13:27:25 -05:00
- $ref : '#/components/parameters/jobType'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2020-06-26 07:43:27 -04:00
type : object
properties :
total :
type : integer
example : 1
data :
type : array
maxItems : 100
items :
$ref : '#/components/schemas/Job'
2018-01-24 04:44:52 -05:00
'/server/following/{host}' :
delete :
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-06-24 08:16:25 -04:00
- admin
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Instance Follows
summary : Unfollow a server
2018-01-24 04:44:52 -05:00
parameters :
- name : host
in : path
required : true
description : 'The host to unfollow '
2018-11-15 08:10:15 -05:00
schema :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2018-01-24 04:44:52 -05:00
responses :
'201' :
description : successful operation
/server/followers :
get :
tags :
2020-04-21 06:09:54 -04:00
- Instance Follows
summary : List instance followers
2018-02-17 13:24:56 -05:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/Follow'
2018-01-24 04:44:52 -05:00
/server/following :
get :
tags :
2020-04-21 06:09:54 -04:00
- Instance Follows
2020-06-24 16:25:05 -04:00
summary : List instances followed by the server
2018-02-17 13:24:56 -05:00
parameters :
2020-06-24 16:25:05 -04:00
- name : state
in : query
schema :
type : string
enum :
- pending
- accepted
- name : actorType
in : query
schema :
type : string
enum :
- Person
- Application
- Group
- Service
- Organization
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/Follow'
2018-01-24 04:44:52 -05:00
post :
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Instance Follows
2018-11-13 17:27:58 -05:00
summary : Follow a server
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 16:25:05 -04:00
'500' :
description : cannot follow a non-HTTPS server
2018-11-15 08:10:15 -05:00
requestBody :
content :
application/json :
schema :
2020-06-24 16:25:05 -04:00
type : object
properties :
hosts :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-24 16:25:05 -04:00
uniqueItems : true
2018-01-24 04:44:52 -05:00
/users :
post :
2020-04-21 06:09:54 -04:00
summary : Create a user
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Users
2018-01-24 04:44:52 -05:00
responses :
2020-07-02 08:23:50 -04:00
'200' :
2020-06-27 05:43:43 -04:00
description : user created
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/AddUserResponse'
2020-06-27 05:43:43 -04:00
links :
# GET /users/{id}
GetUserId :
operationId : getUserId
parameters :
id : '$response.body#/user/id'
# PUT /users/{id}
PutUserId :
operationId : putUserId
parameters :
id : '$response.body#/user/id'
# DELETE /users/{id}
DelUserId :
operationId : delUserId
parameters :
id : '$response.body#/user/id'
'403' :
description : insufficient authority to create an admin or moderator
2018-11-15 08:10:15 -05:00
requestBody :
content :
application/json :
schema :
$ref : '#/components/schemas/AddUser'
description : User to create
required : true
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List users
2018-04-16 04:48:17 -04:00
security :
2020-07-02 16:49:51 -04:00
- OAuth2 :
- admin
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Users
2018-02-17 13:24:56 -05:00
parameters :
2020-07-02 16:49:51 -04:00
- $ref : '#/components/parameters/usersSearch'
- $ref : '#/components/parameters/usersBlocked'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/usersSort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/User'
2018-01-24 04:44:52 -05:00
'/users/{id}' :
2020-06-27 05:43:43 -04:00
parameters :
- $ref : '#/components/parameters/id'
2018-01-24 04:44:52 -05:00
delete :
2020-04-21 06:09:54 -04:00
summary : Delete a user
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Users
2020-06-27 05:43:43 -04:00
operationId : delUserId
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get a user
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Users
2020-06-27 05:43:43 -04:00
operationId : getUserId
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/User'
2018-01-24 04:44:52 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Update a user
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Users
2020-06-27 05:43:43 -04:00
operationId : putUserId
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-11-15 08:10:15 -05:00
requestBody :
content :
application/json :
schema :
$ref : '#/components/schemas/UpdateUser'
required : true
2019-07-29 08:33:16 -04:00
/users/register :
post :
summary : Register a user
tags :
2020-04-21 06:09:54 -04:00
- Users
2019-07-29 08:33:16 -04:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2019-07-29 08:33:16 -04:00
requestBody :
content :
application/json :
schema :
$ref : '#/components/schemas/RegisterUser'
required : true
2018-01-24 04:44:52 -05:00
/users/me :
get :
2020-04-21 06:09:54 -04:00
summary : Get my user information
2018-04-16 04:48:17 -04:00
security :
2019-01-03 11:34:24 -05:00
- OAuth2 :
- user
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/User'
2018-01-24 04:44:52 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Update my user information
2018-04-16 04:48:17 -04:00
security :
2019-01-03 11:34:24 -05:00
- OAuth2 :
- user
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2018-01-24 04:44:52 -05:00
responses :
'204' :
2019-08-14 04:53:31 -04:00
description : successful operation
2018-11-15 08:10:15 -05:00
requestBody :
content :
application/json :
schema :
$ref : '#/components/schemas/UpdateMe'
required : true
2019-07-29 08:33:16 -04:00
/users/me/videos/imports :
get :
2020-04-21 06:09:54 -04:00
summary : Get video imports of my user
2019-07-29 08:33:16 -04:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2019-07-29 08:33:16 -04:00
tags :
2020-04-21 06:09:54 -04:00
- Videos
2019-07-29 08:33:16 -04:00
- My User
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/VideoImport'
2018-01-24 04:44:52 -05:00
/users/me/video-quota-used :
get :
2020-04-21 06:09:54 -04:00
summary : Get my user used quota
2018-04-16 04:48:17 -04:00
security :
2019-01-03 11:34:24 -05:00
- OAuth2 :
- user
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : number
2018-01-24 04:44:52 -05:00
'/users/me/videos/{videoId}/rating' :
get :
2020-04-21 09:24:19 -04:00
summary : Get rate of my user for a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2020-04-21 06:09:54 -04:00
- Video Rates
2018-01-24 04:44:52 -05:00
parameters :
- name : videoId
in : path
required : true
description : 'The video id '
2018-11-15 08:10:15 -05:00
schema :
type : string
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/GetMeVideoRating'
2018-01-24 04:44:52 -05:00
/users/me/videos :
get :
2020-04-21 06:09:54 -04:00
summary : Get videos of my user
2018-04-16 04:48:17 -04:00
security :
2019-01-03 11:34:24 -05:00
- OAuth2 :
- user
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2020-04-21 06:09:54 -04:00
- Videos
2018-02-17 13:24:56 -05:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2019-01-03 11:34:24 -05:00
/users/me/subscriptions :
get :
2020-04-21 06:09:54 -04:00
summary : Get my user subscriptions
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2019-01-03 11:34:24 -05:00
tags :
2020-04-21 06:09:54 -04:00
- My Subscriptions
2019-01-03 11:34:24 -05:00
parameters :
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
responses :
'200' :
description : successful operation
post :
2020-06-27 05:43:43 -04:00
tags :
- My Subscriptions
2020-04-21 06:09:54 -04:00
summary : Add subscription to my user
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2020-06-27 05:43:43 -04:00
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
2019-01-03 11:34:24 -05:00
responses :
'200' :
description : successful operation
/users/me/subscriptions/exist :
get :
2020-04-21 06:09:54 -04:00
summary : Get if subscriptions exist for my user
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2019-01-03 11:34:24 -05:00
tags :
2020-04-21 06:09:54 -04:00
- My Subscriptions
2019-01-03 11:34:24 -05:00
parameters :
- $ref : '#/components/parameters/subscriptionsUris'
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
/users/me/subscriptions/videos :
get :
2020-04-21 06:09:54 -04:00
summary : List videos of subscriptions of my user
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
- user
tags :
2020-04-21 06:09:54 -04:00
- My Subscriptions
- Videos
2019-01-03 11:34:24 -05:00
parameters :
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/categoryOneOf'
- $ref : '#/components/parameters/tagsOneOf'
- $ref : '#/components/parameters/tagsAllOf'
- $ref : '#/components/parameters/licenceOneOf'
- $ref : '#/components/parameters/languageOneOf'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
- $ref : '#/components/parameters/skipCount'
2019-01-03 11:34:24 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/videosSort'
2019-01-03 11:34:24 -05:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2019-07-03 11:28:09 -04:00
'/users/me/subscriptions/{subscriptionHandle}' :
2019-01-03 11:34:24 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get subscription of my user
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2019-01-03 11:34:24 -05:00
tags :
2020-04-21 06:09:54 -04:00
- My Subscriptions
2019-07-03 11:28:09 -04:00
parameters :
- $ref : '#/components/parameters/subscriptionHandle'
2019-01-03 11:34:24 -05:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/VideoChannel'
delete :
2020-04-21 06:09:54 -04:00
summary : Delete subscription of my user
2019-01-03 11:34:24 -05:00
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- user
2019-01-03 11:34:24 -05:00
tags :
2020-04-21 06:09:54 -04:00
- My Subscriptions
2019-07-03 11:28:09 -04:00
parameters :
- $ref : '#/components/parameters/subscriptionHandle'
2019-01-03 11:34:24 -05:00
responses :
'200' :
description : successful operation
2020-06-24 16:25:05 -04:00
/users/me/notifications :
get :
summary : List my notifications
security :
- OAuth2 : [ ]
tags :
- My Notifications
parameters :
- 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'
/users/me/notifications/read :
post :
summary : Mark notifications as read by their id
security :
- OAuth2 : [ ]
tags :
- My Notifications
requestBody :
content :
2020-06-27 05:43:43 -04:00
application/json :
2020-06-24 16:25:05 -04:00
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
/users/me/notifications/read-all :
post :
summary : Mark all my notification as read
security :
- OAuth2 : [ ]
tags :
- My Notifications
responses :
'204' :
description : successful operation
/users/me/notification-settings :
put :
summary : Update my notification settings
security :
- OAuth2 : [ ]
tags :
- My Notifications
requestBody :
content :
2020-06-27 05:43:43 -04:00
application/json :
2020-06-24 16:25:05 -04:00
schema :
type : object
properties :
newVideoFromSubscription :
$ref : '#/components/schemas/NotificationSettingValue'
newCommentOnMyVideo :
$ref : '#/components/schemas/NotificationSettingValue'
2020-07-07 08:34:16 -04:00
abuseAsModerator :
2020-06-24 16:25:05 -04:00
$ref : '#/components/schemas/NotificationSettingValue'
videoAutoBlacklistAsModerator :
$ref : '#/components/schemas/NotificationSettingValue'
blacklistOnMyVideo :
$ref : '#/components/schemas/NotificationSettingValue'
myVideoPublished :
$ref : '#/components/schemas/NotificationSettingValue'
myVideoImportFinished :
$ref : '#/components/schemas/NotificationSettingValue'
newFollow :
$ref : '#/components/schemas/NotificationSettingValue'
newUserRegistration :
$ref : '#/components/schemas/NotificationSettingValue'
commentMention :
$ref : '#/components/schemas/NotificationSettingValue'
newInstanceFollower :
$ref : '#/components/schemas/NotificationSettingValue'
autoInstanceFollowing :
$ref : '#/components/schemas/NotificationSettingValue'
responses :
'204' :
description : successful operation
2020-11-25 18:27:59 -05:00
/users/me/history/videos :
get :
summary : List watched videos history
security :
- OAuth2 : [ ]
tags :
- My History
parameters :
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2021-01-13 03:16:15 -05:00
- $ref : '#/components/parameters/search'
2020-11-25 18:27:59 -05:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/VideoListResponse'
/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
2018-01-24 04:44:52 -05:00
/users/me/avatar/pick :
post :
2020-04-21 06:09:54 -04:00
summary : Update my user avatar
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2019-07-29 08:33:16 -04:00
- My User
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/Avatar'
2020-11-23 04:45:42 -05:00
'413' :
description : image file too large
headers :
X-File-Maximum-Size :
schema :
type : string
format : Nginx size
description : Maximum file size for the avatar
2018-11-15 08:10:15 -05:00
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
avatarfile :
description : The file to upload.
type : string
format : binary
encoding :
2019-08-21 02:32:15 -04:00
avatarfile :
2018-11-15 08:10:15 -05:00
contentType : image/png, image/jpeg
2020-04-21 06:09:54 -04:00
/videos/ownership :
get :
summary : List video ownership changes
tags :
- Video Ownership Change
security :
- OAuth2 : [ ]
responses :
'200' :
description : successful operation
'/videos/ownership/{id}/accept' :
post :
summary : Accept ownership change request
tags :
- Video Ownership Change
security :
- OAuth2 : [ ]
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 08:16:25 -04:00
'403' :
description : cannot terminate an ownership change of another user
'404' :
description : video owneship change not found
2020-04-21 06:09:54 -04:00
'/videos/ownership/{id}/refuse' :
post :
summary : Refuse ownership change request
tags :
- Video Ownership Change
security :
- OAuth2 : [ ]
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 08:16:25 -04:00
'403' :
description : cannot terminate an ownership change of another user
'404' :
description : video owneship change not found
2020-04-21 06:09:54 -04:00
'/videos/{id}/give-ownership' :
post :
summary : Request ownership change
tags :
- Video Ownership Change
security :
- OAuth2 : [ ]
parameters :
- $ref : '#/components/parameters/idOrUUID'
requestBody :
required : true
content :
application/x-www-form-urlencoded :
schema :
type : object
properties :
username :
type : string
required :
- username
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-04-21 06:09:54 -04:00
'400' :
2020-06-24 08:16:25 -04:00
description : changing video ownership to a remote account is not supported yet
'404' :
description : video not found
2018-01-25 12:39:51 -05:00
/videos :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List videos
2018-01-24 04:44:52 -05:00
tags :
- Video
2018-02-17 13:24:56 -05:00
parameters :
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/categoryOneOf'
- $ref : '#/components/parameters/tagsOneOf'
- $ref : '#/components/parameters/tagsAllOf'
- $ref : '#/components/parameters/licenceOneOf'
- $ref : '#/components/parameters/languageOneOf'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/skipCount'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/videosSort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2018-01-25 12:39:51 -05:00
/videos/categories :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List available video categories
2018-01-24 04:44:52 -05:00
tags :
- Video
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/api/v1/videos/categories
2018-01-25 12:39:51 -05:00
/videos/licences :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List available video licences
2018-01-24 04:44:52 -05:00
tags :
- Video
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/api/v1/videos/licences
2018-01-25 12:39:51 -05:00
/videos/languages :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List available video languages
2018-01-24 04:44:52 -05:00
tags :
- Video
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/api/v1/videos/languages
2018-01-25 12:39:51 -05:00
/videos/privacies :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List available video privacies
2018-01-24 04:44:52 -05:00
tags :
- Video
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/api/v1/videos/privacies
2018-11-15 08:10:15 -05:00
'/videos/{id}' :
2018-01-24 04:44:52 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Update a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
- Video
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
2019-08-14 04:53:31 -04:00
'204' :
2018-01-24 04:44:52 -05:00
description : successful operation
2018-11-15 08:10:15 -05:00
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
thumbnailfile :
description : Video thumbnail file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2018-11-15 08:10:15 -05:00
previewfile :
description : Video preview file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2018-11-15 08:10:15 -05:00
category :
description : Video category
2020-06-26 07:43:27 -04:00
type : integer
example : 4
2018-11-15 08:10:15 -05:00
licence :
description : Video licence
2020-06-26 07:43:27 -04:00
type : integer
example : 2
2018-11-15 08:10:15 -05:00
language :
description : Video language
type : string
2020-04-21 09:04:39 -04:00
privacy :
$ref : '#/components/schemas/VideoPrivacySet'
2018-11-15 08:10:15 -05:00
description :
description : Video description
type : string
waitTranscoding :
description : Whether or not we wait transcoding before publish the video
type : string
support :
2020-06-27 07:12:30 -04:00
description : A text tell the audience how to support the video creator
example : Please support my work on <insert crowdfunding plateform>! <3
2018-11-15 08:10:15 -05:00
type : string
nsfw :
description : Whether or not this video contains sensitive content
2020-06-26 07:43:27 -04:00
type : boolean
2018-11-15 08:10:15 -05:00
name :
description : Video name
type : string
tags :
2019-03-29 06:45:41 -04:00
description : Video tags (maximum 5 tags each between 2 and 30 characters)
2019-01-09 08:10:25 -05:00
type : array
2019-08-12 04:19:45 -04:00
minItems : 1
maxItems : 5
2019-01-09 08:10:25 -05:00
items :
type : string
2019-08-12 04:19:45 -04:00
minLength : 2
maxLength : 30
2018-11-15 08:10:15 -05:00
commentsEnabled :
description : Enable or disable comments for this video
2020-06-26 07:43:27 -04:00
type : boolean
2019-08-14 04:53:31 -04:00
originallyPublishedAt :
description : Date when the content was originally published
type : string
format : date-time
2019-06-11 04:01:13 -04:00
scheduleUpdate :
$ref : '#/components/schemas/VideoScheduledUpdate'
2019-08-21 02:32:15 -04:00
encoding :
thumbnailfile :
contentType : image/jpeg
previewfile :
contentType : image/jpeg
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get a video
2018-01-24 04:44:52 -05:00
tags :
- Video
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-06-11 04:01:13 -04:00
$ref : '#/components/schemas/VideoDetails'
2018-01-24 04:44:52 -05:00
delete :
2020-04-21 06:09:54 -04:00
summary : Delete a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
- Video
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-11-15 08:10:15 -05:00
'/videos/{id}/description' :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get complete video description
2018-01-24 04:44:52 -05:00
tags :
- Video
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : string
'/videos/{id}/views' :
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Add a view to a video
2018-01-24 04:44:52 -05:00
tags :
- Video
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-11-16 06:11:00 -05:00
'/videos/{id}/watching' :
put :
2020-04-21 06:09:54 -04:00
summary : Set watching progress of a video
2018-11-16 06:11:00 -05:00
tags :
- Video
security :
- OAuth2 : [ ]
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-11-16 06:11:00 -05:00
requestBody :
content :
application/json :
schema :
$ref : '#/components/schemas/UserWatchingVideo'
required : true
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-01-25 12:39:51 -05:00
/videos/upload :
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Upload a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
- Video
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/VideoUploadResponse'
2020-12-08 15:16:10 -05:00
'400' :
description : invalid file field, schedule date or parameter
2020-01-14 17:34:03 -05:00
'403' :
2020-12-08 15:16:10 -05:00
description : video didn't pass upload filter
2020-01-14 17:34:03 -05:00
'408' :
2020-06-26 07:43:27 -04:00
description : upload has timed out
2020-11-23 04:45:42 -05:00
'413' :
2020-12-08 15:16:10 -05:00
description : video file too large, due to quota or max body size limit set by the reverse-proxy
2020-11-23 04:45:42 -05:00
headers :
X-File-Maximum-Size :
schema :
type : string
format : Nginx size
description : Maximum file size for the video
2020-12-08 15:16:10 -05:00
'415' :
description : video type unsupported
2020-01-14 17:34:03 -05:00
'422' :
2020-12-08 15:16:10 -05:00
description : video unreadable
2018-11-15 08:10:15 -05:00
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
videofile :
description : Video file
type : string
format : binary
channelId :
description : Channel id that will contain this video
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
thumbnailfile :
description : Video thumbnail file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2018-11-15 08:10:15 -05:00
previewfile :
description : Video preview file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2018-11-15 11:08:42 -05:00
privacy :
2019-05-24 04:09:27 -04:00
$ref : '#/components/schemas/VideoPrivacySet'
2018-11-15 08:10:15 -05:00
category :
description : Video category
2020-06-26 07:43:27 -04:00
type : integer
example : 4
2018-11-15 08:10:15 -05:00
licence :
description : Video licence
2020-06-26 07:43:27 -04:00
type : integer
example : 2
2021-03-04 09:06:22 -05:00
language :
description : Video language
type : string
2018-11-15 08:10:15 -05:00
description :
description : Video description
type : string
waitTranscoding :
description : Whether or not we wait transcoding before publish the video
2020-09-21 20:02:40 -04:00
type : boolean
2018-11-15 08:10:15 -05:00
support :
2020-06-27 07:12:30 -04:00
description : A text tell the audience how to support the video creator
example : Please support my work on <insert crowdfunding plateform>! <3
2018-11-15 08:10:15 -05:00
type : string
nsfw :
description : Whether or not this video contains sensitive content
2020-06-26 07:43:27 -04:00
type : boolean
2018-11-15 08:10:15 -05:00
name :
description : Video name
type : string
tags :
2019-08-12 04:19:45 -04:00
description : Video tags (maximum 5 tags each between 2 and 30 characters)
2019-01-09 08:10:25 -05:00
type : array
2019-08-12 04:19:45 -04:00
minItems : 1
maxItems : 5
2020-06-24 08:16:25 -04:00
uniqueItems : true
2019-01-09 08:10:25 -05:00
items :
type : string
2019-08-12 04:19:45 -04:00
minLength : 2
maxLength : 30
2018-11-15 08:10:15 -05:00
commentsEnabled :
description : Enable or disable comments for this video
2020-06-26 07:43:27 -04:00
type : boolean
2020-09-21 20:02:40 -04:00
downloadEnabled :
description : Enable or disable downloading for this video
type : boolean
2019-08-05 08:08:27 -04:00
originallyPublishedAt :
description : Date when the content was originally published
type : string
format : date-time
2019-06-11 04:01:13 -04:00
scheduleUpdate :
$ref : '#/components/schemas/VideoScheduledUpdate'
2018-11-15 08:10:15 -05:00
required :
- videofile
- channelId
2018-11-15 11:08:42 -05:00
- name
2019-08-21 02:32:15 -04:00
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
2018-11-15 11:08:42 -05:00
x-code-samples :
- lang : Shell
source : |
2020-07-28 07:48:55 -04:00
## DEPENDENCIES: jq
2018-11-15 11:08:42 -05:00
USERNAME="<your_username>"
PASSWORD="<your_password>"
FILE_PATH="<your_file_path>"
CHANNEL_ID="<your_channel_id>"
NAME="<video_name>"
API_PATH="https://peertube2.cpy.re/api/v1"
## AUTH
2020-07-28 07:48:55 -04:00
client_id=$(curl -s "$API_PATH/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API_PATH/oauth-clients/local" | jq -r ".client_secret")
token=$(curl -s "$API_PATH/users/token" \
--data client_id="$client_id" \
--data client_secret="$client_secret" \
--data grant_type=password \
--data response_type=code \
--data username="$USERNAME" \
--data password="$PASSWORD" \
2018-11-15 11:08:42 -05:00
| jq -r ".access_token")
## VIDEO UPLOAD
2020-07-28 07:48:55 -04:00
curl -s "$API_PATH/videos/upload" \
-H "Authorization: Bearer $token" \
--max-time 600 \
--form videofile=@"$FILE_PATH" \
--form channelId=$CHANNEL_ID \
--form name="$NAME"
2019-02-19 11:56:09 -05:00
/videos/imports :
post :
2020-04-21 06:09:54 -04:00
summary : Import a video
description : Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)
2019-02-19 11:56:09 -05:00
security :
- OAuth2 : [ ]
tags :
- Video
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
torrentfile :
description : Torrent File
type : string
format : binary
targetUrl :
description : HTTP target URL
type : string
magnetUri :
description : Magnet URI
type : string
channelId :
description : Channel id that will contain this video
2020-06-24 08:16:25 -04:00
type : integer
2019-02-19 11:56:09 -05:00
thumbnailfile :
description : Video thumbnail file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2019-02-19 11:56:09 -05:00
previewfile :
description : Video preview file
type : string
2019-08-21 02:32:15 -04:00
format : binary
2019-02-19 11:56:09 -05:00
privacy :
2019-05-24 04:09:27 -04:00
$ref : '#/components/schemas/VideoPrivacySet'
2019-02-19 11:56:09 -05:00
category :
description : Video category
2021-03-04 09:06:22 -05:00
type : integer
example : 4
2019-02-19 11:56:09 -05:00
licence :
description : Video licence
2021-03-04 09:06:22 -05:00
type : integer
example : 2
2019-02-19 11:56:09 -05:00
language :
description : Video language
type : string
description :
description : Video description
type : string
waitTranscoding :
description : Whether or not we wait transcoding before publish the video
2020-09-21 20:02:40 -04:00
type : boolean
2019-02-19 11:56:09 -05:00
support :
2020-06-27 07:12:30 -04:00
description : A text tell the audience how to support the video creator
example : Please support my work on <insert crowdfunding plateform>! <3
2019-02-19 11:56:09 -05:00
type : string
nsfw :
description : Whether or not this video contains sensitive content
2020-09-21 20:02:40 -04:00
type : boolean
2019-02-19 11:56:09 -05:00
name :
description : Video name
type : string
tags :
2019-08-12 04:19:45 -04:00
description : Video tags (maximum 5 tags each between 2 and 30 characters)
2019-02-19 11:56:09 -05:00
type : array
2019-08-12 04:19:45 -04:00
minItems : 1
maxItems : 5
2019-02-19 11:56:09 -05:00
items :
type : string
2019-08-12 04:19:45 -04:00
minLength : 2
maxLength : 30
2019-02-19 11:56:09 -05:00
commentsEnabled :
description : Enable or disable comments for this video
2020-09-21 20:02:40 -04:00
type : boolean
downloadEnabled :
description : Enable or disable downloading for this video
type : boolean
2019-06-11 04:01:13 -04:00
scheduleUpdate :
$ref : '#/components/schemas/VideoScheduledUpdate'
2019-02-19 11:56:09 -05:00
required :
- channelId
- name
2019-08-21 02:32:15 -04:00
encoding :
torrentfile :
contentType : application/x-bittorrent
thumbnailfile :
contentType : image/jpeg
previewfile :
contentType : image/jpeg
2020-06-24 08:16:25 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/VideoUploadResponse'
'400' :
description : '`magnetUri` or `targetUrl` or a torrent file missing'
2020-12-08 15:16:10 -05:00
'403' :
description : video didn't pass pre-import filter
'409' :
description : HTTP or Torrent/magnetURI import not enabled
2020-07-28 05:12:16 -04:00
2020-11-09 05:21:08 -05:00
/videos/live :
post :
summary : Create a live
security :
- OAuth2 : [ ]
tags :
- Live Videos
- Video
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/VideoUploadResponse'
'403' :
description : Live is not enabled, allow replay is not enabled, or max instance/user live videos limit is exceeded
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
channelId :
description : Channel id that will contain this live video
type : integer
saveReplay :
type : boolean
2020-12-03 08:10:54 -05:00
permanentLive :
description : User can stream multiple times in a permanent live
type : boolean
2020-11-09 05:21:08 -05:00
thumbnailfile :
description : Live video/replay thumbnail file
type : string
format : binary
previewfile :
description : Live video/replay preview file
type : string
format : binary
privacy :
$ref : '#/components/schemas/VideoPrivacySet'
category :
description : Live video/replay category
type : string
licence :
description : Live video/replay licence
type : string
language :
description : Live video/replay language
type : string
description :
description : Live video/replay description
type : string
support :
description : A text tell the audience how to support the creator
example : Please support my work on <insert crowdfunding plateform>! <3
type : string
nsfw :
description : Whether or not this live video/replay contains sensitive content
type : boolean
name :
description : Live video/replay name
type : string
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
commentsEnabled :
description : Enable or disable comments for this live video/replay
type : boolean
downloadEnabled :
description : Enable or disable downloading for the replay of this live
type : boolean
required :
- channelId
- name
encoding :
thumbnailfile :
contentType : image/jpeg
previewfile :
contentType : image/jpeg
/videos/live/{id}:
get :
summary : Get a live information
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 a live information
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
2020-07-28 05:12:16 -04:00
/users/me/abuses :
get :
summary : List my abuses
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/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/abusesSort'
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/Abuse'
2020-07-10 03:51:56 -04:00
/abuses :
2018-01-24 04:44:52 -05:00
get :
2020-07-08 09:51:46 -04:00
summary : List abuses
2018-04-16 04:48:17 -04:00
security :
2020-04-21 06:09:54 -04:00
- OAuth2 :
2020-06-24 08:16:25 -04:00
- admin
- moderator
2018-01-24 04:44:52 -05:00
tags :
2020-07-08 09:51:46 -04:00
- Abuses
2018-02-17 13:24:56 -05:00
parameters :
2020-06-26 07:43:27 -04:00
- 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 :
2020-07-10 03:51:56 -04:00
$ref : '#/components/schemas/PredefinedAbuseReasons'
2020-06-26 07:43:27 -04:00
- 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 :
2020-07-28 05:12:16 -04:00
$ref : '#/components/schemas/AbuseStateSet'
2020-06-26 07:43:27 -04:00
- 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
2020-07-10 03:39:53 -04:00
- name : videoIs
in : query
description : only list blacklisted or deleted 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'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/abusesSort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
2020-07-28 05:12:16 -04:00
$ref : '#/components/schemas/Abuse'
2020-07-10 03:51:56 -04:00
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Report an abuse
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-07-08 09:51:46 -04:00
- Abuses
2020-04-21 09:24:19 -04:00
requestBody :
2020-06-22 07:00:39 -04:00
required : true
2020-04-21 09:24:19 -04:00
content :
application/json :
schema :
type : object
properties :
reason :
description : Reason why the user reports this video
type : string
2020-06-26 07:43:27 -04:00
minLength : 4
2020-06-22 07:00:39 -04:00
predefinedReasons :
2020-07-10 03:51:56 -04:00
$ref : '#/components/schemas/PredefinedAbuseReasons'
video :
type : object
properties :
id :
description : Video id to report
type : number
startAt :
type : integer
description : Timestamp in the video that marks the beginning of the report
minimum : 0
endAt :
type : integer
description : Timestamp in the video that marks the ending of the report
minimum : 0
comment :
type : object
properties :
id :
description : Comment id to report
type : number
account :
type : object
properties :
id :
description : Account id to report
type : number
2020-06-22 07:00:39 -04:00
required :
- reason
2020-04-21 09:24:19 -04:00
responses :
'204' :
description : successful operation
2020-06-26 07:43:27 -04:00
'400' :
description : incorrect request parameters
2020-07-10 03:51:56 -04:00
'/abuses/{abuseId}' :
2020-04-21 09:24:19 -04:00
put :
summary : Update an abuse
security :
- OAuth2 :
- admin
- moderator
tags :
2020-07-08 09:51:46 -04:00
- Abuses
2020-04-21 09:24:19 -04:00
parameters :
- $ref : '#/components/parameters/abuseId'
requestBody :
content :
application/json :
schema :
type : object
properties :
state :
2020-07-07 08:34:16 -04:00
$ref : '#/components/schemas/AbuseStateSet'
2020-04-21 09:24:19 -04:00
moderationComment :
type : string
2020-06-26 07:43:27 -04:00
description : Update the report comment visible only to the moderation team
responses :
'204' :
description : successful operation
'404' :
2020-07-08 09:51:46 -04:00
description : abuse not found
2020-04-21 09:24:19 -04:00
delete :
2020-06-26 07:43:27 -04:00
tags :
2020-07-08 09:51:46 -04:00
- Abuses
2020-04-21 09:24:19 -04:00
summary : Delete an abuse
security :
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
- moderator
2020-06-26 07:43:27 -04:00
parameters :
- $ref : '#/components/parameters/abuseId'
2020-04-21 09:24:19 -04:00
responses :
'204' :
description : successful operation
2020-06-24 08:16:25 -04:00
'404' :
description : block not found
2020-07-28 05:12:16 -04:00
'/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 : array
items :
$ref : '#/components/schemas/AbuseMessage'
post :
summary : Add message to an abuse
security :
- OAuth2 : [ ]
tags :
- Abuses
2020-08-03 02:59:41 -04:00
parameters :
- $ref : '#/components/parameters/abuseId'
2020-07-28 05:12:16 -04:00
requestBody :
required : true
content :
application/json :
schema :
type : object
properties :
message :
description : Message to send
type : string
required :
- message
responses :
'200' :
description : successful operation
'400' :
description : incorrect request parameters
'/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
2020-04-21 09:24:19 -04:00
2018-11-15 08:10:15 -05:00
'/videos/{id}/blacklist' :
2018-01-24 04:44:52 -05:00
post :
2020-06-24 08:16:25 -04:00
summary : Block a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
- moderator
2018-01-24 04:44:52 -05:00
tags :
2020-06-24 08:16:25 -04:00
- Video Blocks
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-01-24 04:44:52 -05:00
delete :
2020-06-24 08:16:25 -04:00
summary : Unblock a video by its id
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
- moderator
2018-01-24 04:44:52 -05:00
tags :
2020-06-24 08:16:25 -04:00
- Video Blocks
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 08:16:25 -04:00
'404' :
description : block not found
2018-01-25 12:39:51 -05:00
/videos/blacklist :
2018-01-24 04:44:52 -05:00
get :
2020-06-24 08:16:25 -04:00
tags :
- Video Blocks
2020-06-24 16:25:05 -04:00
summary : List video blocks
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 :
2020-11-20 05:29:33 -05:00
- admin
- moderator
2018-02-17 13:24:56 -05:00
parameters :
2020-06-26 07:43:27 -04:00
- name : type
in : query
description : >
list only blocks that match this type :
- `1` : manual block
- `2` : automatic block that needs review
schema :
type : integer
enum :
- 1
- 2
- name : search
in : query
description : plain search that will match with video titles, and more
schema :
type : string
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/blacklistsSort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2020-06-26 07:43:27 -04:00
type : object
properties :
total :
type : integer
example : 1
data :
type : array
items :
$ref : '#/components/schemas/VideoBlacklist'
2019-05-24 04:01:08 -04:00
/videos/{id}/captions:
get :
2020-04-21 06:09:54 -04:00
summary : List captions of a video
2019-05-24 04:01:08 -04:00
tags :
2020-06-25 05:14:43 -04:00
- Video Captions
2019-05-24 04:01:08 -04:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2019-05-24 04:01:08 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
properties :
total :
type : integer
2020-06-26 07:43:27 -04:00
example : 1
2019-05-24 04:01:08 -04:00
data :
type : array
items :
$ref : '#/components/schemas/VideoCaption'
/videos/{id}/captions/{captionLanguage}:
put :
summary : Add or replace a video caption
2020-11-20 05:29:33 -05:00
security :
- OAuth2 :
- user
2019-05-24 04:01:08 -04:00
tags :
2020-06-25 05:14:43 -04:00
- Video Captions
2019-05-24 04:01:08 -04:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2019-05-24 04:01:08 -04:00
- $ref : '#/components/parameters/captionLanguage'
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
captionfile :
description : The file to upload.
type : string
format : binary
2019-08-21 02:32:15 -04:00
encoding :
captionfile :
2020-01-09 08:10:23 -05:00
contentType : text/vtt, application/x-subrip, text/plain
2019-05-24 04:01:08 -04:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 08:16:25 -04:00
'404' :
description : video or language not found
2019-05-24 04:01:08 -04:00
delete :
summary : Delete a video caption
2020-11-20 05:29:33 -05:00
security :
- OAuth2 :
- user
2019-05-24 04:01:08 -04:00
tags :
2020-06-25 05:14:43 -04:00
- Video Captions
2019-05-24 04:01:08 -04:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2019-05-24 04:01:08 -04:00
- $ref : '#/components/parameters/captionLanguage'
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-24 08:16:25 -04:00
'404' :
description : video or language or caption for that language not found
2018-04-24 11:05:32 -04:00
/video-channels :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List video channels
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
2018-02-17 13:24:56 -05:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2020-06-26 07:43:27 -04:00
type : object
properties :
total :
type : integer
example : 1
data :
type : array
items :
$ref : '#/components/schemas/VideoChannel'
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Create a video channel
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-11-15 08:10:15 -05:00
requestBody :
2019-05-31 10:30:11 -04:00
content :
application/json :
schema :
$ref : '#/components/schemas/VideoChannelCreate'
2019-04-24 10:57:23 -04:00
'/video-channels/{channelHandle}' :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get a video channel
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
2018-01-24 04:44:52 -05:00
parameters :
2019-04-24 10:57:23 -04:00
- $ref : '#/components/parameters/channelHandle'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/VideoChannel'
2018-01-24 04:44:52 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Update a video channel
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
2018-01-24 04:44:52 -05:00
parameters :
2019-04-24 10:57:23 -04:00
- $ref : '#/components/parameters/channelHandle'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2018-11-15 08:10:15 -05:00
requestBody :
2019-05-31 10:30:11 -04:00
content :
application/json :
schema :
$ref : '#/components/schemas/VideoChannelUpdate'
2018-01-24 04:44:52 -05:00
delete :
2020-04-21 06:09:54 -04:00
summary : Delete a video channel
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
2018-01-24 04:44:52 -05:00
parameters :
2019-04-24 10:57:23 -04:00
- $ref : '#/components/parameters/channelHandle'
2018-04-25 10:15:39 -04:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2019-04-24 10:57:23 -04:00
'/video-channels/{channelHandle}/videos' :
2018-04-25 10:15:39 -04:00
get :
2020-04-21 06:09:54 -04:00
summary : List videos of a video channel
2018-04-25 10:15:39 -04:00
tags :
2019-05-24 04:17:54 -04:00
- Video
2020-04-21 06:09:54 -04:00
- Video Channels
2018-04-25 10:15:39 -04:00
parameters :
2019-04-24 10:57:23 -04:00
- $ref : '#/components/parameters/channelHandle'
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/categoryOneOf'
- $ref : '#/components/parameters/tagsOneOf'
- $ref : '#/components/parameters/tagsAllOf'
- $ref : '#/components/parameters/licenceOneOf'
- $ref : '#/components/parameters/languageOneOf'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
- $ref : '#/components/parameters/skipCount'
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/videosSort'
2018-01-24 04:44:52 -05:00
responses :
2018-04-25 10:15:39 -04:00
'200' :
2018-01-24 04:44:52 -05:00
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2020-04-21 09:04:39 -04:00
/video-playlists/privacies :
get :
summary : List available playlist privacies
tags :
- Video Playlists
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/api/v1/video-playlists/privacies
2020-04-21 09:04:39 -04:00
2019-12-27 11:52:53 -05:00
/video-playlists :
get :
2020-04-21 06:09:54 -04:00
summary : List video playlists
2019-12-27 11:52:53 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Playlists
2019-12-27 11:52:53 -05:00
parameters :
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
responses :
'200' :
description : successful operation
content :
application/json :
schema :
2020-06-26 07:43:27 -04:00
type : object
properties :
total :
type : integer
example : 1
data :
type : array
items :
$ref : '#/components/schemas/VideoPlaylist'
2020-04-21 09:04:39 -04:00
post :
summary : Create a video playlist
description : 'If the video playlist is set as public, the videoChannelId is mandatory.'
security :
- OAuth2 : [ ]
tags :
- Video Playlists
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
properties :
videoPlaylist :
type : object
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
uuid :
type : string
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
displayName :
description : Video playlist display name
type : string
thumbnailfile :
description : Video playlist thumbnail file
type : string
format : binary
privacy :
$ref : '#/components/schemas/VideoPlaylistPrivacySet'
description :
description : Video playlist description
type : string
videoChannelId :
description : Video channel in which the playlist will be published
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
required :
- displayName
2020-06-27 05:43:43 -04:00
encoding :
thumbnailfile :
contentType : image/jpeg
2020-04-21 09:04:39 -04:00
/video-playlists/{id}:
get :
summary : Get a video playlist
tags :
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
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/idOrUUID'
requestBody :
content :
multipart/form-data :
schema :
type : object
properties :
displayName :
description : Video playlist display name
type : string
thumbnailfile :
description : Video playlist thumbnail file
type : string
format : binary
privacy :
$ref : '#/components/schemas/VideoPlaylistPrivacySet'
description :
description : Video playlist description
type : string
videoChannelId :
description : Video channel in which the playlist will be published
2020-06-24 08:16:25 -04:00
type : integer
2020-06-27 05:43:43 -04:00
encoding :
thumbnailfile :
contentType : image/jpeg
2020-04-21 09:04:39 -04:00
delete :
summary : Delete a video playlist
security :
- OAuth2 : [ ]
tags :
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'204' :
description : successful operation
/video-playlists/{id}/videos:
get :
summary : 'List videos of a playlist'
tags :
- Videos
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/VideoListResponse'
post :
summary : 'Add a video in a playlist'
security :
- OAuth2 : [ ]
tags :
- Videos
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
properties :
videoPlaylistElement :
type : object
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
requestBody :
content :
application/json :
schema :
type : object
properties :
videoId :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
description : 'Video to add in the playlist'
startTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
description : 'Start the video at this specific timestamp (in seconds)'
stopTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
description : 'Stop the video at this specific timestamp (in seconds)'
required :
- videoId
/video-playlists/{id}/videos/reorder:
post :
summary : 'Reorder a playlist'
security :
- OAuth2 : [ ]
tags :
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
responses :
'204' :
description : successful operation
requestBody :
content :
application/json :
schema :
type : object
properties :
startPosition :
2020-06-24 08:16:25 -04:00
type : integer
description : 'Start position of the element to reorder'
minimum : 1
2020-04-21 09:04:39 -04:00
insertAfterPosition :
2020-06-24 08:16:25 -04:00
type : integer
description : 'New position for the block to reorder, to add the block before the first element'
minimum : 0
2020-04-21 09:04:39 -04:00
reorderLength :
2020-06-24 08:16:25 -04:00
type : integer
description : 'How many element from `startPosition` to reorder'
minimum : 1
2020-04-21 09:04:39 -04:00
required :
- startPosition
- insertAfterPosition
2020-04-21 10:47:39 -04:00
/video-playlists/{id}/videos/{playlistElementId}:
2020-04-21 09:04:39 -04:00
put :
summary : 'Update a playlist element'
security :
- OAuth2 : [ ]
tags :
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
- $ref : '#/components/parameters/playlistElementId'
responses :
'204' :
description : successful operation
requestBody :
content :
application/json :
schema :
type : object
properties :
startTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
description : 'Start the video at this specific timestamp (in seconds)'
stopTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:04:39 -04:00
description : 'Stop the video at this specific timestamp (in seconds)'
delete :
summary : 'Delete an element from a playlist'
security :
- OAuth2 : [ ]
tags :
- Video Playlists
parameters :
- $ref : '#/components/parameters/idOrUUID'
- $ref : '#/components/parameters/playlistElementId'
responses :
'204' :
description : successful operation
2020-04-21 10:41:31 -04:00
'/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 :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
properties :
videoId :
type : array
items :
type : object
properties :
playlistElementId :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
playlistId :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
startTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
stopTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
2018-11-15 08:10:15 -05:00
'/accounts/{name}/video-channels' :
2018-04-25 04:21:38 -04:00
get :
2020-04-21 06:09:54 -04:00
summary : List video channels of an account
2018-04-25 04:21:38 -04:00
tags :
2020-04-21 06:09:54 -04:00
- Video Channels
- Accounts
2018-04-25 04:21:38 -04:00
parameters :
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/name'
2020-06-26 07:43:27 -04:00
- name : withStats
in : query
description : include view statistics for the last 30 days (only if authentified as the account user)
schema :
type : boolean
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
2018-04-25 04:21:38 -04:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/VideoChannel'
2019-04-09 05:02:02 -04:00
'/accounts/{name}/ratings' :
get :
2020-04-21 06:09:54 -04:00
summary : List ratings of an account
2019-04-09 05:02:02 -04:00
security :
- OAuth2 : [ ]
tags :
2020-04-21 06:09:54 -04:00
- Accounts
2019-04-09 05:02:02 -04:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/name'
2019-04-09 05:02:02 -04:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/sort'
- name : rating
in : query
required : false
2019-08-07 04:26:46 -04:00
description : Optionally filter which ratings to retrieve
2019-04-09 05:02:02 -04:00
schema :
type : string
enum :
- like
- dislike
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/VideoRating'
2018-11-15 08:10:15 -05:00
'/videos/{id}/comment-threads' :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : List threads of a video
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Comments
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2019-12-27 11:52:53 -05:00
- $ref : '#/components/parameters/commentsSort'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/CommentThreadResponse'
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Create a thread
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Comments
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/CommentThreadPostResponse'
2020-06-27 05:43:43 -04:00
'404' :
description : video does not exist
2020-04-21 09:28:17 -04:00
requestBody :
content :
application/json :
schema :
type : object
properties :
text :
type : string
description : 'Text comment'
required :
- text
2018-11-15 08:10:15 -05:00
'/videos/{id}/comment-threads/{threadId}' :
2018-01-24 04:44:52 -05:00
get :
2020-04-21 06:09:54 -04:00
summary : Get a thread
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Comments
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
- $ref : '#/components/parameters/threadId'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/VideoCommentThreadTree'
'/videos/{id}/comments/{commentId}' :
2018-01-24 04:44:52 -05:00
post :
2020-04-21 06:09:54 -04:00
summary : Reply to a thread of a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Comments
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/commentId'
2018-01-24 04:44:52 -05:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
$ref : '#/components/schemas/CommentThreadPostResponse'
2020-06-27 05:43:43 -04:00
'404' :
description : thread or video does not exist
2020-04-21 09:28:17 -04:00
requestBody :
content :
application/json :
schema :
type : object
properties :
text :
type : string
description : 'Text comment'
required :
- text
2018-01-24 04:44:52 -05:00
delete :
2020-04-21 06:09:54 -04:00
summary : Delete a comment or a reply
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Comments
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/commentId'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-26 07:43:27 -04:00
'403' :
description : cannot remove comment of another user
'404' :
description : comment or video does not exist
'409' :
description : comment is already deleted
2018-11-15 08:10:15 -05:00
'/videos/{id}/rate' :
2018-01-24 04:44:52 -05:00
put :
2020-04-21 06:09:54 -04:00
summary : Like/dislike a video
2018-04-16 04:48:17 -04:00
security :
2018-11-15 08:10:15 -05:00
- OAuth2 : [ ]
2018-01-24 04:44:52 -05:00
tags :
2020-04-21 06:09:54 -04:00
- Video Rates
2018-01-24 04:44:52 -05:00
parameters :
2019-07-03 11:28:09 -04:00
- $ref : '#/components/parameters/idOrUUID'
2018-01-24 04:44:52 -05:00
responses :
'204' :
2020-04-21 09:04:39 -04:00
description : successful operation
2020-06-27 05:43:43 -04:00
'404' :
description : video does not exist
2018-07-28 14:38:49 -04:00
/search/videos :
get :
tags :
- Search
2020-04-21 06:09:54 -04:00
summary : Search videos
2018-07-28 14:38:49 -04:00
parameters :
2020-06-26 07:43:27 -04:00
- 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.
schema :
type : string
2020-04-21 10:03:51 -04:00
- $ref : '#/components/parameters/categoryOneOf'
- $ref : '#/components/parameters/tagsOneOf'
- $ref : '#/components/parameters/tagsAllOf'
- $ref : '#/components/parameters/licenceOneOf'
- $ref : '#/components/parameters/languageOneOf'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
- $ref : '#/components/parameters/skipCount'
2018-11-15 08:10:15 -05:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
2020-06-10 09:18:15 -04:00
- $ref : '#/components/parameters/searchTarget'
2018-11-24 12:18:56 -05:00
- $ref : '#/components/parameters/videosSearchSort'
2020-06-10 09:18:15 -04:00
- 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
2018-11-15 08:10:15 -05:00
schema :
type : string
2020-06-10 09:18:15 -04:00
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 :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-10 09:18:15 -04:00
- name : durationMax
in : query
description : Get videos that have this maximum duration
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-27 05:43:43 -04:00
callbacks :
'searchTarget === search-index' :
$ref : '#/components/callbacks/searchIndex'
2018-07-28 14:38:49 -04:00
responses :
'200' :
description : successful operation
2018-11-15 08:10:15 -05:00
content :
application/json :
schema :
2019-05-24 04:17:54 -04:00
$ref : '#/components/schemas/VideoListResponse'
2020-06-27 05:43:43 -04:00
'500' :
description : search index unavailable
2020-06-10 09:18:15 -04:00
/search/video-channels :
get :
tags :
- Search
summary : Search channels
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.
schema :
type : string
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/start'
- $ref : '#/components/parameters/count'
- $ref : '#/components/parameters/searchTarget'
- $ref : '#/components/parameters/sort'
2020-06-27 05:43:43 -04:00
callbacks :
'searchTarget === search-index' :
$ref : '#/components/callbacks/searchIndex'
2020-06-10 09:18:15 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : array
items :
$ref : '#/components/schemas/VideoChannel'
2020-06-27 05:43:43 -04:00
'500' :
description : search index unavailable
2020-06-24 08:16:25 -04:00
/blocklist/accounts :
get :
tags :
- Account Blocks
summary : List account blocks
security :
- OAuth2 :
- admin
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
2020-06-26 07:43:27 -04:00
example : chocobozzz@example.org
2020-06-24 08:16:25 -04:00
description : account to block, in the form `username@domain`
required :
- accountName
responses :
'200' :
description : successful operation
'409' :
description : self-blocking forbidden
'/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
/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 :
2020-06-26 07:43:27 -04:00
host :
2020-06-24 08:16:25 -04:00
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-24 08:16:25 -04:00
description : server domain to block
required :
2020-06-26 07:43:27 -04:00
- host
2020-06-24 08:16:25 -04:00
responses :
'200' :
description : successful operation
'409' :
description : self-blocking forbidden
'/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
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-24 08:16:25 -04:00
responses :
'201' :
description : successful operation
'404' :
description : account block does not exist
2020-06-25 05:14:43 -04:00
/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
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-25 05:14:43 -04:00
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
/redundancy/videos :
get :
tags :
- Video Mirroring
summary : List videos being mirrored
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
security :
- OAuth2 :
- admin
requestBody :
content :
application/json :
schema :
type : object
properties :
videoId :
2020-06-26 07:43:27 -04:00
type : integer
2020-06-25 05:14:43 -04:00
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
/redundancy/videos/{redundancyId}:
delete :
tags :
- Video Mirroring
summary : Delete a mirror done on a video
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
2020-06-24 08:16:25 -04:00
'/feeds/video-comments.{format}' :
get :
tags :
- Feeds
summary : List comments on videos
2020-06-24 09:13:24 -04:00
servers :
- url : 'https://peertube2.cpy.re'
2020-06-24 16:25:05 -04:00
description : Live Test Server (live data - latest nightly version)
2020-06-24 09:13:24 -04:00
- url : 'https://peertube3.cpy.re'
description : Live Test Server (live data - latest RC version)
2020-06-24 16:25:05 -04:00
- url : 'https://peertube.cpy.re'
description : Live Test Server (live data - stable version)
2020-06-24 08:16:25 -04:00
parameters :
- name : format
in : path
required : true
2020-06-27 07:12:30 -04:00
description : 'format expected (we focus on making `rss` the most featureful ; it serves [Media RSS](https://www.rssboard.org/media-rss))'
2020-06-24 08:16:25 -04:00
schema :
type : string
enum :
- xml
- rss
- rss2
- atom
- atom1
- json
- json1
- name : videoId
2020-06-24 09:13:24 -04:00
in : query
2020-06-24 08:16:25 -04:00
description : 'limit listing to a specific video'
schema :
type : string
2020-06-27 07:12:30 -04:00
- 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
2020-06-24 08:16:25 -04:00
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'
application/rss+xml :
schema :
$ref : '#/components/schemas/VideoCommentsForXML'
text/xml :
schema :
$ref : '#/components/schemas/VideoCommentsForXML'
application/atom+xml :
schema :
$ref : '#/components/schemas/VideoCommentsForXML'
application/json :
schema :
type : object
2020-06-27 07:12:30 -04:00
'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
2020-06-24 08:16:25 -04:00
'406' :
description : accept header unsupported
'/feeds/videos.{format}' :
get :
tags :
- Feeds
summary : List videos
2020-06-24 09:13:24 -04:00
servers :
- url : 'https://peertube2.cpy.re'
2020-06-24 16:25:05 -04:00
description : Live Test Server (live data - latest nightly version)
2020-06-24 09:13:24 -04:00
- url : 'https://peertube3.cpy.re'
description : Live Test Server (live data - latest RC version)
2020-06-24 16:25:05 -04:00
- url : 'https://peertube.cpy.re'
description : Live Test Server (live data - stable version)
2020-06-24 08:16:25 -04:00
parameters :
- name : format
in : path
required : true
2020-06-27 07:12:30 -04:00
description : 'format expected (we focus on making `rss` the most featureful ; it serves [Media RSS](https://www.rssboard.org/media-rss))'
2020-06-24 08:16:25 -04:00
schema :
type : string
enum :
- xml
- rss
- rss2
- atom
- atom1
- json
- json1
- name : accountId
2020-06-24 09:13:24 -04:00
in : query
2020-06-24 08:16:25 -04:00
description : 'limit listing to a specific account'
schema :
type : string
- name : accountName
2020-06-24 09:13:24 -04:00
in : query
2020-06-24 08:16:25 -04:00
description : 'limit listing to a specific account'
schema :
type : string
- name : videoChannelId
2020-06-24 09:13:24 -04:00
in : query
2020-06-24 08:16:25 -04:00
description : 'limit listing to a specific video channel'
schema :
type : string
- name : videoChannelName
2020-06-24 09:13:24 -04:00
in : query
2020-06-24 08:16:25 -04:00
description : 'limit listing to a specific video channel'
schema :
type : string
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/sort'
- $ref : '#/components/parameters/nsfw'
- $ref : '#/components/parameters/filter'
2020-06-24 08:16:25 -04:00
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'
2020-06-26 07:43:27 -04:00
examples :
nightly :
externalValue : https://peertube2.cpy.re/feeds/videos.xml?filter=local
2020-06-24 08:16:25 -04:00
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
2020-06-27 07:12:30 -04:00
'404' :
description : video channel or account not found
2020-06-24 08:16:25 -04:00
'406' :
description : accept header unsupported
2020-06-25 06:16:08 -04:00
/plugins :
get :
tags :
- Plugins
summary : List plugins
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'
/plugins/available :
get :
tags :
- Plugins
summary : List available plugins
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
/plugins/install :
post :
tags :
- Plugins
summary : Install a plugin
security :
- OAuth2 :
- admin
requestBody :
content :
application/json :
schema :
oneOf :
- type : object
properties :
npmName :
type : string
2020-06-26 07:43:27 -04:00
example : peertube-plugin-auth-ldap
2020-06-25 06:16:08 -04:00
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
/plugins/update :
post :
tags :
- Plugins
summary : Update a plugin
security :
- OAuth2 :
- admin
requestBody :
content :
application/json :
schema :
oneOf :
- type : object
properties :
npmName :
type : string
2020-06-26 07:43:27 -04:00
example : peertube-plugin-auth-ldap
2020-06-25 06:16:08 -04:00
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
/plugins/uninstall :
post :
tags :
- Plugins
summary : Uninstall a plugin
security :
- OAuth2 :
- admin
requestBody :
content :
application/json :
schema :
type : object
properties :
npmName :
type : string
2020-06-26 07:43:27 -04:00
description : name of the plugin/theme in its package.json
example : peertube-plugin-auth-ldap
2020-06-25 06:16:08 -04:00
required :
- npmName
responses :
'204' :
description : successful operation
'404' :
description : existing plugin not found
/plugins/{npmName}:
get :
tags :
- Plugins
summary : Get a plugin
security :
- OAuth2 :
- admin
parameters :
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/npmName'
2020-06-25 06:16:08 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
$ref : '#/components/schemas/Plugin'
'404' :
description : plugin not found
/plugins/{npmName}/settings:
put :
tags :
- Plugins
summary : Set a plugin's settings
security :
- OAuth2 :
- admin
parameters :
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/npmName'
2020-06-25 06:16:08 -04:00
requestBody :
content :
application/json :
schema :
type : object
properties :
settings :
type : object
additionalProperties : true
responses :
'204' :
description : successful operation
'404' :
description : plugin not found
/plugins/{npmName}/public-settings:
get :
tags :
- Plugins
summary : Get a plugin's public settings
parameters :
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/npmName'
2020-06-25 06:16:08 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
additionalProperties : true
'404' :
description : plugin not found
/plugins/{npmName}/registered-settings:
get :
tags :
- Plugins
summary : Get a plugin's registered settings
security :
- OAuth2 :
- admin
parameters :
2020-06-26 07:43:27 -04:00
- $ref : '#/components/parameters/npmName'
2020-06-25 06:16:08 -04:00
responses :
'200' :
description : successful operation
content :
application/json :
schema :
type : object
additionalProperties : true
'404' :
description : plugin not found
2018-11-15 08:10:15 -05:00
servers :
2018-11-15 11:08:42 -05:00
- url : 'https://peertube2.cpy.re/api/v1'
2020-06-24 16:25:05 -04:00
description : Live Test Server (live data - latest nightly version)
2018-11-16 06:11:00 -05:00
- url : 'https://peertube3.cpy.re/api/v1'
2020-04-21 06:09:54 -04:00
description : Live Test Server (live data - latest RC version)
2020-06-24 16:25:05 -04:00
- url : 'https://peertube.cpy.re/api/v1'
description : Live Test Server (live data - stable version)
2018-11-15 08:10:15 -05:00
components :
parameters :
start :
name : start
in : query
required : false
2020-06-24 08:16:25 -04:00
description : Offset used to paginate results
2018-11-15 08:10:15 -05:00
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
minimum : 0
2018-11-15 08:10:15 -05:00
count :
name : count
in : query
required : false
2020-06-24 08:16:25 -04:00
description : "Number of items to return"
2018-11-15 08:10:15 -05:00
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
default : 15
2020-06-24 08:16:25 -04:00
maximum : 100
minimum : 1
2018-11-15 08:10:15 -05:00
sort :
name : sort
in : query
required : false
2020-06-26 07:43:27 -04:00
description : Sort column
2018-11-15 08:10:15 -05:00
schema :
type : string
2020-06-26 07:43:27 -04:00
example : -createdAt
2020-07-02 16:49:51 -04:00
search :
name : search
in : query
required : false
description : Plain text search, applied to various parts of the model depending on endpoint
schema :
type : string
2020-06-10 09:18:15 -04:00
searchTarget :
name : searchTarget
in : query
required : false
description : >
If the administrator enabled search index support, you can override the default search target.
**Warning**: If you choose to make an index search, PeerTube will get results from a third party service.
2020-06-26 07:43:27 -04:00
It means the instance may not yet know the objects you fetched. If you want to load video/channel information :
2020-06-10 09:18:15 -04:00
* If the current user has the ability to make a remote URI search (this information is available in the config endpoint),
then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database.
After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
2020-06-26 07:43:27 -04:00
* 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
2020-06-10 09:18:15 -04:00
the data from the origin instance API
schema :
type : string
enum :
- 'local'
- 'search-index'
2018-11-24 12:18:56 -05:00
videosSort :
name : sort
in : query
required : false
description : Sort videos by criteria
schema :
type : string
enum :
2020-06-25 05:14:43 -04:00
- name
2018-11-24 12:18:56 -05:00
- -duration
- -createdAt
- -publishedAt
- -views
- -likes
- -trending
2021-01-28 08:43:02 -05:00
- -hot
2018-11-24 12:18:56 -05:00
videosSearchSort :
name : sort
in : query
required : false
description : Sort videos by criteria
schema :
type : string
enum :
2020-06-25 05:14:43 -04:00
- name
2018-11-24 12:18:56 -05:00
- -duration
- -createdAt
- -publishedAt
- -views
- -likes
- -match
2019-12-27 11:52:53 -05:00
commentsSort :
name : sort
in : query
required : false
description : Sort comments by criteria
schema :
type : string
enum :
- -createdAt
- -totalReplies
2018-11-24 12:18:56 -05:00
blacklistsSort :
name : sort
in : query
required : false
description : Sort blacklists by criteria
schema :
type : string
enum :
- -id
2020-06-25 05:14:43 -04:00
- name
2018-11-24 12:18:56 -05:00
- -duration
- -views
- -likes
- -dislikes
- -uuid
- -createdAt
2020-07-02 16:49:51 -04:00
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
2018-11-24 12:18:56 -05:00
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
2020-06-25 05:14:43 -04:00
videoRedundanciesSort :
name : sort
in : query
required : false
description : Sort abuses by criteria
schema :
type : string
enum :
- name
2018-11-15 08:10:15 -05:00
name :
name : name
in : path
required : true
2020-12-08 15:16:10 -05:00
description : The username or handle of the account
2018-11-15 08:10:15 -05:00
schema :
type : string
2020-06-26 07:43:27 -04:00
example : chocobozzz | chocobozzz@example.org
2018-11-15 08:10:15 -05:00
id :
name : id
in : path
required : true
description : The user id
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
minimum : 0
example : 42
2019-07-03 11:28:09 -04:00
idOrUUID :
2018-11-15 08:10:15 -05:00
name : id
in : path
required : true
2020-04-21 09:04:39 -04:00
description : The object id or uuid
2018-11-15 08:10:15 -05:00
schema :
2020-06-26 07:43:27 -04:00
oneOf :
- type : integer
minimum : 0
example : 42
- type : string
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2020-04-21 09:04:39 -04:00
playlistElementId :
name : playlistElementId
in : path
required : true
description : Playlist element id
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 09:24:19 -04:00
abuseId :
name : abuseId
in : path
required : true
2020-07-08 09:51:46 -04:00
description : Abuse id
2020-04-21 09:24:19 -04:00
schema :
2020-06-24 08:16:25 -04:00
type : integer
2020-07-28 05:12:16 -04:00
abuseMessageId :
name : abuseMessageId
in : path
required : true
description : Abuse message id
schema :
type : integer
2019-05-24 04:01:08 -04:00
captionLanguage :
name : captionLanguage
in : path
required : true
description : The caption language
schema :
type : string
2019-04-24 10:57:23 -04:00
channelHandle :
name : channelHandle
2018-11-15 08:10:15 -05:00
in : path
required : true
2020-06-26 07:43:27 -04:00
description : The video channel handle
2018-11-15 08:10:15 -05:00
schema :
type : string
2020-06-26 07:43:27 -04:00
example : my_username | my_username@example.com
2019-07-03 11:28:09 -04:00
subscriptionHandle :
name : subscriptionHandle
in : path
required : true
2020-06-26 07:43:27 -04:00
description : The subscription handle
2019-07-03 11:28:09 -04:00
schema :
type : string
2020-06-26 07:43:27 -04:00
example : my_username | my_username@example.com
2019-07-03 11:28:09 -04:00
threadId :
2018-11-15 08:10:15 -05:00
name : threadId
in : path
required : true
2019-07-03 11:28:09 -04:00
description : The thread id (root comment id)
schema :
2020-06-24 08:16:25 -04:00
type : integer
2019-07-03 11:28:09 -04:00
commentId :
name : commentId
in : path
required : true
2018-11-15 08:10:15 -05:00
description : The comment id
schema :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-24 12:18:56 -05:00
categoryOneOf :
name : categoryOneOf
in : query
required : false
2020-06-26 07:43:27 -04:00
description : category id of the video (see [/videos/categories](#tag/Video/paths/~1videos~1categories/get))
2018-11-24 12:18:56 -05:00
schema :
oneOf :
2020-06-24 08:16:25 -04:00
- type : integer
2018-11-24 12:18:56 -05:00
- type : array
items :
2020-06-24 08:16:25 -04:00
type : integer
2018-12-04 07:50:50 -05:00
style : form
explode : false
2018-11-24 12:18:56 -05:00
tagsOneOf :
name : tagsOneOf
in : query
required : false
description : tag(s) of the video
schema :
oneOf :
- type : string
- type : array
items :
type : string
2018-12-04 07:50:50 -05:00
style : form
explode : false
2018-11-24 12:18:56 -05:00
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
2018-12-04 07:50:50 -05:00
style : form
explode : false
2018-11-24 12:18:56 -05:00
languageOneOf :
name : languageOneOf
in : query
required : false
2020-06-26 07:43:27 -04:00
description : language id of the video (see [/videos/languages](#tag/Video/paths/~1videos~1languages/get)). Use `_unknown` to filter on videos that don't have a video language
2018-11-24 12:18:56 -05:00
schema :
oneOf :
2018-12-04 07:50:50 -05:00
- type : string
2018-11-24 12:18:56 -05:00
- type : array
items :
2018-12-04 07:50:50 -05:00
type : string
style : form
explode : false
2018-11-24 12:18:56 -05:00
licenceOneOf :
name : licenceOneOf
in : query
required : false
2020-06-26 07:43:27 -04:00
description : licence id of the video (see [/videos/licences](#tag/Video/paths/~1videos~1licences/get))
2018-11-24 12:18:56 -05:00
schema :
oneOf :
2020-06-24 08:16:25 -04:00
- type : integer
2018-11-24 12:18:56 -05:00
- type : array
items :
2020-06-24 08:16:25 -04:00
type : integer
2018-12-04 07:50:50 -05:00
style : form
explode : false
2020-04-21 10:03:51 -04:00
skipCount :
name : skipCount
in : query
required : false
description : if you don't need the `total` in the response
schema :
type : string
enum :
- 'true'
- 'false'
2020-06-24 08:16:25 -04:00
default : 'false'
2018-11-24 12:18:56 -05:00
nsfw :
name : nsfw
in : query
required : false
description : whether to include nsfw videos, if any
schema :
type : string
enum :
- 'true'
- 'false'
filter :
name : filter
in : query
required : false
description : >
2020-11-18 09:29:38 -05:00
Special filters which might require special rights :
2018-11-24 12:18:56 -05:00
* `local` - only videos local to the instance
* `all-local` - only videos local to the instance, but showing private and unlisted videos (requires Admin privileges)
2020-11-18 09:29:38 -05:00
* `all` - all videos, showing private and unlisted videos (requires Admin privileges)
2018-11-24 12:18:56 -05:00
schema :
type : string
enum :
- local
- all-local
2019-01-03 11:34:24 -05:00
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
2020-06-26 07:43:27 -04:00
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
2020-12-13 13:27:25 -05:00
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-views
- activitypub-refresher
- video-redundancy
- video-live-ending
2018-11-15 08:10:15 -05:00
securitySchemes :
OAuth2 :
description : >
In the header: *Authorization : Bearer <token\>*
Authenticating via OAuth requires the following steps :
- Have an account with sufficient authorization levels
2021-02-12 04:12:19 -05:00
- [ Generate](https://docs.joinpeertube.org/api-rest-getting-started) a
2018-11-15 08:10:15 -05:00
Bearer Token
- Make Authenticated Requests
type : oauth2
flows :
password :
tokenUrl : 'https://peertube.example.com/api/v1/users/token'
scopes :
admin : Admin scope
moderator : Moderator scope
user : User scope
schemas :
VideoConstantNumber :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
label :
type : string
VideoConstantString :
properties :
id :
type : string
label :
type : string
2020-04-21 09:04:39 -04:00
VideoPlaylistPrivacySet :
type : integer
enum :
- 1
- 2
- 3
2020-06-24 08:16:25 -04:00
description : 'The video playlist privacy (Public = `1`, Unlisted = `2`, Private = `3`)'
2020-04-21 09:04:39 -04:00
VideoPlaylistPrivacyConstant :
properties :
id :
$ref : '#/components/schemas/VideoPlaylistPrivacySet'
label :
type : string
VideoPlaylistTypeSet :
type : integer
enum :
- 1
- 2
2020-06-24 08:16:25 -04:00
description : 'The video playlist type (Regular = `1`, Watch Later = `2`)'
2020-04-21 09:04:39 -04:00
VideoPlaylistTypeConstant :
properties :
id :
$ref : '#/components/schemas/VideoPlaylistTypeSet'
label :
type : string
2019-05-24 04:09:27 -04:00
VideoPrivacySet :
type : integer
2018-11-15 08:10:15 -05:00
enum :
2019-05-24 04:09:27 -04:00
- 1
- 2
- 3
2020-04-21 09:04:39 -04:00
- 4
2020-06-24 08:16:25 -04:00
description : 'The video privacy (Public = `1`, Unlisted = `2`, Private = `3`, Internal = `4`)'
2019-05-24 04:09:27 -04:00
VideoPrivacyConstant :
properties :
id :
2020-04-21 09:04:39 -04:00
$ref : '#/components/schemas/VideoPrivacySet'
2019-05-24 04:09:27 -04:00
label :
type : string
2020-04-21 09:24:19 -04:00
2020-04-21 10:41:31 -04:00
NSFWPolicy :
type : string
enum :
- display
- blur
- do_not_list
UserRole :
2020-06-24 08:16:25 -04:00
type : integer
2020-04-21 10:41:31 -04:00
enum :
- 0
- 1
- 2
2020-06-24 08:16:25 -04:00
description : 'The user role (Admin = `0`, Moderator = `1`, User = `2`)'
2020-06-27 05:43:43 -04:00
example : 2
2021-02-01 09:39:13 -05:00
UserAdminFlags :
type : integer
enum :
- 0
- 1
description : 'Admin flags for the user (None = `0`, Bypass video blacklist = `1`)'
example : 1
2020-04-21 10:41:31 -04:00
2019-06-11 04:01:13 -04:00
VideoStateConstant :
properties :
id :
type : integer
enum :
- 1
- 2
- 3
2020-06-24 08:16:25 -04:00
description : 'The video state (Published = `1`, to transcode = `2`, to import = `3`)'
2019-06-11 04:01:13 -04:00
label :
type : string
2020-04-21 09:24:19 -04:00
2020-07-07 08:34:16 -04:00
AbuseStateSet :
2020-04-21 09:24:19 -04:00
type : integer
enum :
- 1
- 2
- 3
2020-07-28 05:12:16 -04:00
description : 'The abuse state (Pending = `1`, Rejected = `2`, Accepted = `3`)'
2020-07-07 08:34:16 -04:00
AbuseStateConstant :
2020-04-21 09:24:19 -04:00
properties :
id :
2020-07-07 08:34:16 -04:00
$ref : '#/components/schemas/AbuseStateSet'
2020-04-21 09:24:19 -04:00
label :
type : string
2020-07-07 08:34:16 -04:00
AbusePredefinedReasons :
2020-06-22 07:00:39 -04:00
type : array
items :
type : string
enum :
- violentOrAbusive
- hatefulOrAbusive
- spamOrMisleading
- privacy
- rights
- serverRules
- thumbnails
- captions
2020-06-26 07:43:27 -04:00
example : [ spamOrMisleading]
2020-04-21 09:24:19 -04:00
2019-06-11 04:01:13 -04:00
VideoResolutionConstant :
properties :
id :
type : integer
2020-12-24 12:02:04 -05:00
description : 'Video resolution (240, 360, 720, 1080, 1440 or 2160)'
2020-06-26 07:43:27 -04:00
example : 240
2019-06-11 04:01:13 -04:00
label :
type : string
2020-06-26 07:43:27 -04:00
example : 240p
2019-06-11 04:01:13 -04:00
VideoScheduledUpdate :
properties :
privacy :
$ref : '#/components/schemas/VideoPrivacySet'
updateAt :
type : string
format : date
description : When to update the video
required :
- updateAt
2020-04-21 09:04:39 -04:00
AccountSummary :
2019-06-11 04:01:13 -04:00
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
name :
type : string
displayName :
type : string
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
host :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2019-06-11 04:01:13 -04:00
avatar :
nullable : true
2020-04-21 09:04:39 -04:00
allOf :
- $ref : '#/components/schemas/Avatar'
2019-06-11 04:01:13 -04:00
VideoChannelSummary :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
name :
type : string
displayName :
type : string
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
host :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2019-06-11 04:01:13 -04:00
avatar :
nullable : true
2020-04-21 09:04:39 -04:00
allOf :
- $ref : '#/components/schemas/Avatar'
2019-06-11 04:01:13 -04:00
PlaylistElement :
properties :
position :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
startTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
stopTimestamp :
2020-06-24 08:16:25 -04:00
type : integer
2019-07-31 09:57:32 -04:00
video :
nullable : true
2020-04-21 09:04:39 -04:00
allOf :
- $ref : '#/components/schemas/Video'
2019-06-11 04:01:13 -04:00
VideoFile :
properties :
magnetUri :
type : string
resolution :
$ref : '#/components/schemas/VideoResolutionConstant'
size :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
description : 'Video file size in bytes'
torrentUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-08-21 02:32:15 -04:00
torrentDownloadUrl :
2019-06-11 04:01:13 -04:00
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
fileUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
fileDownloadUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
fps :
type : number
2020-05-13 05:57:38 -04:00
metadataUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
VideoStreamingPlaylists :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
type :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
enum :
- 1
2020-06-24 08:16:25 -04:00
description : 'Playlist type (HLS = `1`)'
2019-06-11 04:01:13 -04:00
playlistUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
segmentsSha256Url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-05-13 05:57:38 -04:00
files :
type : array
2020-08-26 08:45:39 -04:00
description : 'Video files associated to this playlist. The difference with the root "files" property is that these files are fragmented, so they can be used in this streaming playlist (HLS etc)'
2020-05-13 05:57:38 -04:00
items :
$ref : '#/components/schemas/VideoFile'
2019-06-11 04:01:13 -04:00
redundancies :
type : array
items :
type : object
properties :
baseUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 16:25:05 -04:00
VideoInfo :
properties :
id :
type : integer
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2020-06-24 16:25:05 -04:00
name :
type : string
2018-11-15 08:10:15 -05:00
Video :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 8
2018-11-15 08:10:15 -05:00
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2020-11-09 05:21:08 -05:00
isLive :
type : boolean
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
publishedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-06-11 04:01:13 -04:00
originallyPublishedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
category :
$ref : '#/components/schemas/VideoConstantNumber'
licence :
$ref : '#/components/schemas/VideoConstantNumber'
language :
$ref : '#/components/schemas/VideoConstantString'
privacy :
2019-05-24 04:09:27 -04:00
$ref : '#/components/schemas/VideoPrivacyConstant'
2018-11-15 08:10:15 -05:00
description :
type : string
duration :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 1419
2018-11-15 08:10:15 -05:00
isLocal :
type : boolean
name :
type : string
2020-06-26 07:43:27 -04:00
example : What is PeerTube?
2018-11-15 08:10:15 -05:00
thumbnailPath :
type : string
2020-06-26 07:43:27 -04:00
example : /static/thumbnails/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg
2018-11-15 08:10:15 -05:00
previewPath :
type : string
2020-08-26 09:03:00 -04:00
example : /lazy-static/previews/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg
2018-11-15 08:10:15 -05:00
embedPath :
type : string
2020-06-26 07:43:27 -04:00
example : /videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee
2018-11-15 08:10:15 -05:00
views :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 1337
2018-11-15 08:10:15 -05:00
likes :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 42
2018-11-15 08:10:15 -05:00
dislikes :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 7
2018-11-15 08:10:15 -05:00
nsfw :
type : boolean
2019-06-11 04:01:13 -04:00
waitTranscoding :
type : boolean
nullable : true
state :
$ref : '#/components/schemas/VideoStateConstant'
scheduledUpdate :
nullable : true
2020-04-21 09:04:39 -04:00
allOf :
- $ref : '#/components/schemas/VideoScheduledUpdate'
2019-06-11 04:01:13 -04:00
blacklisted :
nullable : true
type : boolean
blacklistedReason :
nullable : true
type : string
2018-11-15 08:10:15 -05:00
account :
2020-04-21 09:04:39 -04:00
$ref : '#/components/schemas/AccountSummary'
2019-06-11 04:01:13 -04:00
channel :
$ref : '#/components/schemas/VideoChannelSummary'
userHistory :
nullable : true
2018-11-15 08:10:15 -05:00
type : object
properties :
2019-06-11 04:01:13 -04:00
currentTime :
2020-06-24 08:16:25 -04:00
type : integer
2019-06-11 04:01:13 -04:00
VideoDetails :
allOf :
- $ref : '#/components/schemas/Video'
- type : object
properties :
descriptionPath :
2018-11-15 08:10:15 -05:00
type : string
2019-06-11 04:01:13 -04:00
support :
2018-11-15 08:10:15 -05:00
type : string
2020-06-27 07:12:30 -04:00
description : A text tell the audience how to support the video creator
2020-06-26 07:43:27 -04:00
example : Please support my work on <insert crowdfunding plateform>! <3
2019-06-11 04:01:13 -04:00
channel :
$ref : '#/components/schemas/VideoChannel'
account :
$ref : '#/components/schemas/Account'
tags :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
example : [ flowers, gardening]
2019-06-11 04:01:13 -04:00
files :
type : array
2020-08-26 08:45:39 -04:00
description : 'WebTorrent/raw video files. Can be empty if WebTorrent is disabled on the server. In this case, video files will be in the "streamingPlaylists[].files" property'
2019-06-11 04:01:13 -04:00
items :
$ref : '#/components/schemas/VideoFile'
commentsEnabled :
type : boolean
downloadEnabled :
type : boolean
trackerUrls :
type : array
items :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-06-11 04:01:13 -04:00
streamingPlaylists :
type : array
items :
$ref : '#/components/schemas/VideoStreamingPlaylists'
2020-06-25 05:14:43 -04:00
FileRedundancyInformation :
properties :
id :
type : integer
fileUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-06-25 05:14:43 -04:00
strategy :
type : string
2020-06-26 07:43:27 -04:00
enum :
- manual
- most-views
- trending
- recently-added
2020-06-25 05:14:43 -04:00
size :
type : integer
createdAt :
type : string
format : date-time
updatedAt :
type : string
format : date-time
expiresOn :
type : string
format : date-time
VideoRedundancy :
properties :
id :
type : integer
name :
type : string
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-06-25 05:14:43 -04:00
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2020-06-25 05:14:43 -04:00
redundancies :
type : object
properties :
files :
type : array
items :
2020-07-02 08:23:50 -04:00
$ref : '#/components/schemas/FileRedundancyInformation'
2020-06-25 05:14:43 -04:00
streamingPlaylists :
type : array
items :
2020-07-02 08:23:50 -04:00
$ref : '#/components/schemas/FileRedundancyInformation'
2019-07-29 08:33:16 -04:00
VideoImportStateConstant :
properties :
id :
type : integer
enum :
- 1
- 2
- 3
2020-06-24 08:16:25 -04:00
description : 'The video import state (Pending = `1`, Success = `2`, Failed = `3`)'
2019-07-29 08:33:16 -04:00
label :
type : string
2020-06-26 07:43:27 -04:00
example : Pending
2019-07-29 08:33:16 -04:00
VideoImport :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 2
2019-07-29 08:33:16 -04:00
targetUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
example : https://framatube.org/videos/watch/9c9de5e8-0a1e-484a-b099-e80766180a6d
2019-07-29 08:33:16 -04:00
magnetUri :
type : string
2020-06-26 07:43:27 -04:00
format : uri
example : magnet:?xs=https%3A%2F%2Fframatube.org%2Fstatic%2Ftorrents%2F9c9de5e8-0a1e-484a-b099-e80766180a6d-240.torrent&xt=urn:btih:38b4747ff788b30bf61f59d1965cd38f9e48e01f&dn=What+is+PeerTube%3F&tr=wss%3A%2F%2Fframatube.org%2Ftracker%2Fsocket&tr=https%3A%2F%2Fframatube.org%2Ftracker%2Fannounce&ws=https%3A%2F%2Fframatube.org%2Fstatic%2Fwebseed%2F9c9de5e8-0a1e-484a-b099-e80766180a6d-240.mp4
2019-07-29 08:33:16 -04:00
torrentName :
type : string
state :
2020-06-26 07:43:27 -04:00
$ref : '#/components/schemas/VideoImportStateConstant'
2019-07-29 08:33:16 -04:00
error :
type : string
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-07-29 08:33:16 -04:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-07-29 08:33:16 -04:00
video :
$ref : '#/components/schemas/Video'
2020-07-28 05:12:16 -04:00
Abuse :
2018-11-15 08:10:15 -05:00
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 7
2018-11-15 08:10:15 -05:00
reason :
type : string
2020-06-26 07:43:27 -04:00
example : The video is a spam
2020-06-22 07:00:39 -04:00
predefinedReasons :
2020-07-07 08:34:16 -04:00
$ref : '#/components/schemas/AbusePredefinedReasons'
2018-11-15 08:10:15 -05:00
reporterAccount :
$ref : '#/components/schemas/Account'
2020-04-21 09:24:19 -04:00
state :
2020-07-07 08:34:16 -04:00
$ref : '#/components/schemas/AbuseStateConstant'
2020-04-21 09:24:19 -04:00
moderationComment :
type : string
2020-06-26 07:43:27 -04:00
example : Decided to ban the server since it spams us regularly
2018-11-15 08:10:15 -05:00
video :
type : object
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
name :
type : string
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2020-07-28 05:12:16 -04:00
AbuseMessage :
properties :
id :
type : integer
message :
type : string
byModerator :
type : boolean
createdAt :
type : string
format : date-time
account :
$ref : '#/components/schemas/AccountSummary'
2018-11-15 08:10:15 -05:00
VideoBlacklist :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
videoId :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
name :
type : string
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2018-11-15 08:10:15 -05:00
description :
type : string
duration :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
views :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
likes :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
dislikes :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
nsfw :
type : boolean
VideoChannel :
properties :
displayName :
type : string
description :
type : string
isLocal :
type : boolean
ownerAccount :
type : object
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2019-12-27 11:52:53 -05:00
VideoPlaylist :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2019-12-27 11:52:53 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-12-27 11:52:53 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-12-27 11:52:53 -05:00
description :
type : string
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2019-12-27 11:52:53 -05:00
displayName :
type : string
isLocal :
type : boolean
videoLength :
2020-06-24 08:16:25 -04:00
type : integer
2019-12-27 11:52:53 -05:00
thumbnailPath :
type : string
privacy :
2020-04-21 09:04:39 -04:00
$ref : '#/components/schemas/VideoPlaylistPrivacyConstant'
2019-12-27 11:52:53 -05:00
type :
2020-04-21 09:04:39 -04:00
$ref : '#/components/schemas/VideoPlaylistTypeConstant'
2019-12-27 11:52:53 -05:00
ownerAccount :
2020-04-21 09:04:39 -04:00
$ref : '#/components/schemas/AccountSummary'
videoChannel :
$ref : '#/components/schemas/VideoChannelSummary'
2018-11-15 08:10:15 -05:00
VideoComment :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2018-11-15 08:10:15 -05:00
text :
type : string
threadId :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
inReplyToCommentId :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
videoId :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2019-12-28 05:27:31 -05:00
totalRepliesFromVideoAuthor :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
totalReplies :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
account :
$ref : '#/components/schemas/Account'
VideoCommentThreadTree :
properties :
comment :
$ref : '#/components/schemas/VideoComment'
children :
type : array
items :
$ref : '#/components/schemas/VideoCommentThreadTree'
2019-05-24 04:01:08 -04:00
VideoCaption :
properties :
language :
$ref : '#/components/schemas/VideoConstantString'
captionPath :
type : string
2018-11-15 08:10:15 -05:00
Avatar :
properties :
path :
type : string
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2020-06-24 16:25:05 -04:00
ActorInfo :
properties :
id :
type : integer
2020-06-26 07:43:27 -04:00
example : 11
2020-06-24 16:25:05 -04:00
name :
type : string
displayName :
type : string
host :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-24 16:25:05 -04:00
avatar :
nullable : true
type : object
properties :
path :
type : string
2018-11-15 08:10:15 -05:00
Actor :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 11
2018-11-15 08:10:15 -05:00
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2018-11-15 08:10:15 -05:00
name :
type : string
host :
type : string
2020-06-26 07:43:27 -04:00
format : hostname
2018-11-15 08:10:15 -05:00
followingCount :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
followersCount :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
avatar :
$ref : '#/components/schemas/Avatar'
Account :
allOf :
- $ref : '#/components/schemas/Actor'
- properties :
2019-08-22 07:33:07 -04:00
userId :
type : string
2020-06-26 07:43:27 -04:00
example : 2
2018-11-15 08:10:15 -05:00
displayName :
type : string
2019-08-22 07:33:07 -04:00
description :
type : string
2018-11-16 06:11:00 -05:00
UserWatchingVideo :
properties :
currentTime :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
description : timestamp within the video, in seconds
example : 5
2018-11-15 08:10:15 -05:00
ServerConfig :
properties :
2019-08-22 07:33:07 -04:00
instance :
type : object
properties :
name :
type : string
shortDescription :
type : string
defaultClientRoute :
type : string
isNSFW :
type : boolean
defaultNSFWPolicy :
type : string
customizations :
type : object
properties :
javascript :
type : string
css :
type : string
2020-02-21 15:25:49 -05:00
search :
type : object
properties :
remoteUri :
type : object
properties :
users :
type : boolean
anonymous :
type : boolean
2019-08-22 07:33:07 -04:00
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
2018-11-15 08:10:15 -05:00
signup :
type : object
properties :
allowed :
type : boolean
2019-08-22 07:33:07 -04:00
allowedForCurrentIP :
type : boolean
requiresEmailVerification :
type : boolean
2018-11-15 08:10:15 -05:00
transcoding :
type : object
properties :
2019-08-22 07:33:07 -04:00
hls :
type : object
properties :
enabled :
type : boolean
2020-02-21 15:25:49 -05:00
webtorrent :
type : object
properties :
enabled :
type : boolean
2018-11-15 08:10:15 -05:00
enabledResolutions :
type : array
items :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
import :
type : object
properties :
videos :
type : object
properties :
http :
type : object
properties :
enabled :
type : boolean
torrent :
type : object
properties :
enabled :
type : boolean
autoBlacklist :
type : object
properties :
videos :
type : object
properties :
ofUsers :
type : object
properties :
enabled :
type : boolean
2018-11-15 08:10:15 -05:00
avatar :
type : object
properties :
file :
type : object
properties :
size :
type : object
properties :
max :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
extensions :
type : array
items :
type : string
video :
type : object
properties :
2019-08-22 07:33:07 -04:00
image :
type : object
properties :
extensions :
type : array
items :
type : string
size :
type : object
properties :
max :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
file :
type : object
properties :
extensions :
type : array
items :
type : string
2019-08-22 07:33:07 -04:00
videoCaption :
type : object
properties :
file :
type : object
properties :
size :
type : object
properties :
max :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
extensions :
type : array
items :
type : string
user :
type : object
properties :
videoQuota :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
videoQuotaDaily :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
trending :
type : object
properties :
videos :
type : object
properties :
intervalDays :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
tracker :
2019-10-29 03:26:24 -04:00
type : object
2019-08-22 07:33:07 -04:00
properties :
enabled :
type : boolean
2020-02-21 15:25:49 -05:00
followings :
type : object
properties :
instance :
type : object
properties :
autoFollowIndex :
type : object
properties :
indexUrl :
type : string
2020-06-26 07:43:27 -04:00
format : url
2019-08-22 07:33:07 -04:00
ServerConfigAbout :
properties :
instance :
type : object
properties :
name :
type : string
shortDescription :
type : string
description :
type : string
terms :
type : string
ServerConfigCustom :
properties :
instance :
type : object
properties :
name :
type : string
shortDescription :
type : string
description :
type : string
terms :
type : string
defaultClientRoute :
type : string
isNSFW :
type : boolean
defaultNSFWPolicy :
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
whitelisted :
type : boolean
cache :
type : object
properties :
previews :
type : object
properties :
size :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
captions :
type : object
properties :
size :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
signup :
type : object
properties :
enabled :
type : boolean
limit :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
requiresEmailVerification :
type : boolean
admin :
type : object
properties :
email :
type : string
2020-06-26 07:43:27 -04:00
format : email
2019-08-22 07:33:07 -04:00
contactForm :
type : object
properties :
enabled :
type : boolean
user :
type : object
properties :
videoQuota :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
videoQuotaDaily :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
transcoding :
type : object
properties :
enabled :
type : boolean
allowAdditionalExtensions :
type : boolean
allowAudioFiles :
type : boolean
threads :
2020-06-24 08:16:25 -04:00
type : integer
2019-08-22 07:33:07 -04:00
resolutions :
type : object
properties :
240p :
type : boolean
360p :
type : boolean
480p :
type : boolean
720p :
type : boolean
1080p :
type : boolean
2020-12-24 12:02:04 -05:00
1440p :
type : boolean
2019-08-22 07:33:07 -04:00
2160p :
type : boolean
hls :
type : object
properties :
enabled :
type : boolean
import :
type : object
properties :
videos :
type : object
properties :
http :
type : object
properties :
enabled :
type : boolean
torrent :
type : object
properties :
enabled :
type : boolean
autoBlacklist :
type : object
properties :
videos :
type : object
properties :
ofUsers :
type : object
properties :
enabled :
type : boolean
followers :
type : object
properties :
instance :
type : object
properties :
enabled :
type : boolean
manualApproval :
type : boolean
2018-11-15 08:10:15 -05:00
Follow :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2018-11-15 08:10:15 -05:00
follower :
$ref : '#/components/schemas/Actor'
following :
$ref : '#/components/schemas/Actor'
score :
type : number
2020-06-25 05:14:43 -04:00
description : score reflecting the reachability of the actor, with steps of `10` and a base score of `1000`.
2018-11-15 08:10:15 -05:00
state :
type : string
enum :
- pending
- accepted
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2018-11-15 08:10:15 -05:00
updatedAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
2020-07-10 03:51:56 -04:00
PredefinedAbuseReasons :
description : Reason categories that help triage reports
type : array
items :
type : string
enum :
- violentOrAbusive
- hatefulOrAbusive
- spamOrMisleading
- privacy
- rights
- serverRules
- thumbnails
- captions
2018-11-15 08:10:15 -05:00
Job :
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
minimum : 0
example : 42
2018-11-15 08:10:15 -05:00
state :
type : string
enum :
2020-06-26 07:43:27 -04:00
- active
- completed
- failed
- waiting
- delayed
type :
2018-11-15 08:10:15 -05:00
type : string
enum :
2020-06-26 07:43:27 -04:00
- activitypub-http-unicast
- activitypub-http-broadcast
- activitypub-http-fetcher
- activitypub-follow
- video-file-import
- video-transcoding
- email
- video-import
- videos-views
- activitypub-refresher
- video-redundancy
data :
type : object
additionalProperties : true
error :
type : object
additionalProperties : true
2018-11-15 08:10:15 -05:00
createdAt :
type : string
2020-06-26 07:43:27 -04:00
format : date-time
finishedOn :
2018-11-15 08:10:15 -05:00
type : string
2020-06-26 07:43:27 -04:00
format : date-time
processedOn :
type : string
format : date-time
2018-11-15 08:10:15 -05:00
AddUserResponse :
properties :
2020-06-27 05:43:43 -04:00
user :
type : object
properties :
id :
type : integer
example : 8
account :
type : object
properties :
id :
type : integer
example : 37
2018-11-15 08:10:15 -05:00
VideoUploadResponse :
properties :
video :
type : object
properties :
id :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 8
2018-11-15 08:10:15 -05:00
uuid :
type : string
2020-06-26 07:43:27 -04:00
format : uuid
example : 9c9de5e8-0a1e-484a-b099-e80766180a6d
2018-11-15 08:10:15 -05:00
CommentThreadResponse :
properties :
total :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 1
2018-11-15 08:10:15 -05:00
data :
type : array
2020-06-26 07:43:27 -04:00
maxItems : 100
2018-11-15 08:10:15 -05:00
items :
$ref : '#/components/schemas/VideoComment'
CommentThreadPostResponse :
properties :
comment :
$ref : '#/components/schemas/VideoComment'
2019-05-24 04:17:54 -04:00
VideoListResponse :
properties :
total :
2020-06-24 08:16:25 -04:00
type : integer
2020-06-26 07:43:27 -04:00
example : 1
2019-05-24 04:17:54 -04:00
data :
type : array
2020-06-26 07:43:27 -04:00
maxItems : 100
2019-05-24 04:17:54 -04:00
items :
$ref : '#/components/schemas/Video'
2020-06-26 07:43:27 -04:00
User :
properties :
id :
type : integer
readOnly : true
username :
type : string
description : The user username
minLength : 1
maxLength : 50
email :
type : string
format : email
description : The user email
2021-02-01 09:39:13 -05:00
pluginAuth :
type : string
description : Auth plugin to use to authenticate the user
2020-06-26 07:43:27 -04:00
theme :
type : string
description : Theme enabled by this user
emailVerified :
type : boolean
description : Has the user confirmed their email address?
nsfwPolicy :
$ref : '#/components/schemas/NSFWPolicy'
webtorrentEnabled :
type : boolean
description : Enable P2P in the player
autoPlayVideo :
type : boolean
description : Automatically start playing the video on the watch page
role :
$ref : '#/components/schemas/UserRole'
roleLabel :
type : string
enum :
- User
- Moderator
- Administrator
videoQuota :
type : integer
description : The user video quota
videoQuotaDaily :
type : integer
description : The user daily video quota
videosCount :
type : integer
2020-07-07 08:34:16 -04:00
abusesCount :
2020-06-26 07:43:27 -04:00
type : integer
2020-07-07 08:34:16 -04:00
abusesAcceptedCount :
2020-06-26 07:43:27 -04:00
type : integer
2020-07-07 08:34:16 -04:00
abusesCreatedCount :
2020-06-26 07:43:27 -04:00
type : integer
videoCommentsCount :
type : integer
noInstanceConfigWarningModal :
type : boolean
noWelcomeModal :
type : boolean
blocked :
type : boolean
blockedReason :
type : string
createdAt :
type : string
account :
$ref : '#/components/schemas/Account'
videoChannels :
type : array
items :
$ref : '#/components/schemas/VideoChannel'
2018-11-15 08:10:15 -05:00
AddUser :
properties :
username :
type : string
2020-06-26 07:43:27 -04:00
description : The user username
2020-06-24 08:16:25 -04:00
minLength : 1
maxLength : 50
2018-11-15 08:10:15 -05:00
password :
type : string
2020-06-26 07:43:27 -04:00
format : password
description : The user password. If the smtp server is configured, you can leave empty and an email will be sent
2020-06-24 08:16:25 -04:00
minLength : 6
maxLength : 255
2018-11-15 08:10:15 -05:00
email :
type : string
2020-06-26 07:43:27 -04:00
format : email
description : The user email
2018-11-15 08:10:15 -05:00
videoQuota :
2020-06-26 07:43:27 -04:00
type : integer
description : The user video quota
2019-04-24 10:54:17 -04:00
videoQuotaDaily :
2020-06-26 07:43:27 -04:00
type : integer
description : The user daily video quota
2021-02-01 09:39:13 -05:00
channelName :
type : string
description : The user default channel username
2018-11-15 08:10:15 -05:00
role :
2020-04-21 10:41:31 -04:00
$ref : '#/components/schemas/UserRole'
2021-02-01 09:39:13 -05:00
adminFlags :
$ref : '#/components/schemas/UserAdminFlags'
2018-11-15 08:10:15 -05:00
required :
- username
- password
- email
- videoQuota
2019-04-24 10:54:17 -04:00
- videoQuotaDaily
2018-11-15 08:10:15 -05:00
- role
UpdateUser :
properties :
id :
type : string
2020-06-26 07:43:27 -04:00
description : The user id
2018-11-15 08:10:15 -05:00
email :
type : string
2020-06-26 07:43:27 -04:00
format : email
description : The updated email of the user
2021-02-01 09:39:13 -05:00
emailVerified :
type : boolean
description : Set the email as verified
2018-11-15 08:10:15 -05:00
videoQuota :
2020-06-26 07:43:27 -04:00
type : integer
description : The updated video quota of the user
2019-04-24 10:54:17 -04:00
videoQuotaDaily :
2020-06-26 07:43:27 -04:00
type : integer
description : The updated daily video quota of the user
2021-02-01 09:39:13 -05:00
pluginAuth :
type : string
nullable : true
description : The auth plugin to use to authenticate the user
example : 'peertube-plugin-auth-saml2'
2018-11-15 08:10:15 -05:00
role :
2020-04-21 10:41:31 -04:00
$ref : '#/components/schemas/UserRole'
2021-02-01 09:39:13 -05:00
adminFlags :
$ref : '#/components/schemas/UserAdminFlags'
2018-11-15 08:10:15 -05:00
required :
- id
UpdateMe :
properties :
password :
type : string
2020-06-26 07:43:27 -04:00
format : password
description : Your new password
minLength : 6
maxLength : 255
2018-11-15 08:10:15 -05:00
email :
type : string
2020-06-26 07:43:27 -04:00
format : email
description : Your new email
2018-11-15 08:10:15 -05:00
displayNSFW :
type : string
2020-06-26 07:43:27 -04:00
description : Your new displayNSFW
enum :
- 'true'
- 'false'
- both
2018-11-15 08:10:15 -05:00
autoPlayVideo :
2020-06-26 07:43:27 -04:00
type : boolean
description : Your new autoPlayVideo
2018-11-15 08:10:15 -05:00
required :
- password
- email
- displayNSFW
- autoPlayVideo
GetMeVideoRating :
properties :
id :
type : string
2020-06-26 07:43:27 -04:00
description : Id of the video
2018-11-15 08:10:15 -05:00
rating :
type : number
2020-06-26 07:43:27 -04:00
description : Rating of the video
2018-11-15 08:10:15 -05:00
required :
- id
- rating
2019-04-09 05:02:02 -04:00
VideoRating :
properties :
video :
$ref : '#/components/schemas/Video'
rating :
type : number
description : 'Rating of the video'
required :
- video
- rating
2018-11-15 08:10:15 -05:00
RegisterUser :
properties :
username :
type : string
2020-06-26 07:43:27 -04:00
description : The username of the user
minLength : 1
maxLength : 50
pattern : '/^[a-z0-9._]{1,50}$/'
2018-11-15 08:10:15 -05:00
password :
type : string
2020-06-26 07:43:27 -04:00
format : password
description : The password of the user
minLength : 6
maxLength : 255
2018-11-15 08:10:15 -05:00
email :
type : string
2020-06-26 07:43:27 -04:00
format : email
description : The email of the user
2019-06-07 10:59:53 -04:00
displayName :
type : string
2020-06-26 07:43:27 -04:00
description : The user display name
minLength : 1
maxLength : 120
2019-06-07 10:59:53 -04:00
channel :
type : object
properties :
name :
type : string
2020-12-08 15:16:10 -05:00
description : The username for the default channel
2020-06-26 07:43:27 -04:00
pattern : '/^[ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\\-_.:]+$/'
2019-06-07 10:59:53 -04:00
displayName :
type : string
2020-06-26 07:43:27 -04:00
description : The display name for the default channel
minLength : 1
maxLength : 120
2018-11-15 08:10:15 -05:00
required :
- username
- password
- email
2019-05-31 10:30:11 -04:00
VideoChannelCreate :
2018-11-15 08:10:15 -05:00
properties :
name :
type : string
2019-05-31 10:30:11 -04:00
displayName :
type : string
2018-11-15 08:10:15 -05:00
description :
type : string
2019-05-31 10:30:11 -04:00
support :
type : string
2020-06-24 08:16:25 -04:00
description : 'A text shown by default on all videos of this channel, to tell the audience how to support it'
2020-06-27 07:12:30 -04:00
example : Please support my work on <insert crowdfunding plateform>! <3
2019-05-31 10:30:11 -04:00
required :
- name
- displayName
VideoChannelUpdate :
properties :
displayName :
type : string
description :
type : string
support :
type : string
2020-06-24 08:16:25 -04:00
description : 'A text shown by default on all videos of this channel, to tell the audience how to support it'
2020-06-27 07:12:30 -04:00
example : Please support my work on <insert crowdfunding plateform>! <3
2019-05-31 10:30:11 -04:00
bulkVideosSupportUpdate :
type : boolean
2020-06-24 08:16:25 -04:00
description : 'Update the support field for all videos of this channel'
2018-01-24 04:44:52 -05:00
2020-06-24 08:16:25 -04:00
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
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
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
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
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
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
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
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
description : video embed path, relative to the canonical URL domain (MRSS)
xml :
attribute : true
'media:player' :
type : object
properties :
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
description : video watch path, relative to the canonical URL domain (MRSS)
xml :
attribute : true
'media:thumbnail' :
type : object
properties :
url :
type : string
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
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
2020-06-26 07:43:27 -04:00
format : url
2020-06-24 08:16:25 -04:00
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'
2020-06-24 16:25:05 -04:00
- $ref : '#/components/schemas/MRSSGroupContent'
NotificationSettingValue :
type : integer
description : >
Notification type
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `0` NONE
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `1` WEB
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `2` EMAIL
enum :
- 0
- 1
- 3
Notification :
properties :
id :
type : integer
type :
type : integer
description : >
Notification type, following the `UserNotificationType` enum :
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `1` NEW_VIDEO_FROM_SUBSCRIPTION
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `2` NEW_COMMENT_ON_MY_VIDEO
2020-06-26 07:43:27 -04:00
2020-07-08 09:51:46 -04:00
- `3` NEW_ABUSE_FOR_MODERATORS
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `4` BLACKLIST_ON_MY_VIDEO
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `5` UNBLACKLIST_ON_MY_VIDEO
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `6` MY_VIDEO_PUBLISHED
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `7` MY_VIDEO_IMPORT_SUCCESS
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `8` MY_VIDEO_IMPORT_ERROR
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `9` NEW_USER_REGISTRATION
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `10` NEW_FOLLOW
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `11` COMMENT_MENTION
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `12` VIDEO_AUTO_BLACKLIST_FOR_MODERATORS
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `13` NEW_INSTANCE_FOLLOWER
2020-06-26 07:43:27 -04:00
2020-06-24 16:25:05 -04:00
- `14` AUTO_INSTANCE_FOLLOWING
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 :
type : integer
video :
nullable : true
$ref : '#/components/schemas/VideoInfo'
torrentName :
type : string
nullable : true
magnetUri :
type : string
2020-06-26 07:43:27 -04:00
format : uri
2020-06-24 16:25:05 -04:00
nullable : true
targetUri :
type : string
2020-06-26 07:43:27 -04:00
format : uri
2020-06-24 16:25:05 -04:00
nullable : true
comment :
nullable : true
type : object
properties :
id :
type : integer
threadId :
type : integer
video :
$ref : '#/components/schemas/VideoInfo'
account :
$ref : '#/components/schemas/ActorInfo'
videoAbuse :
nullable : true
type : object
properties :
id :
type : integer
video :
allOf :
- $ref : '#/components/schemas/VideoInfo'
videoBlacklist :
nullable : true
type : object
properties :
id :
type : integer
video :
allOf :
- $ref : '#/components/schemas/VideoInfo'
account :
nullable : true
allOf :
- $ref : '#/components/schemas/ActorInfo'
actorFollow :
type : object
nullable : true
properties :
id :
type : integer
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
2020-06-26 07:43:27 -04:00
format : hostname
2020-06-24 16:25:05 -04:00
createdAt :
type : string
format : date-time
updatedAt :
type : string
format : date-time
NotificationListResponse :
properties :
total :
type : integer
2020-06-26 07:43:27 -04:00
example : 1
2020-06-24 16:25:05 -04:00
data :
type : array
2020-06-26 07:43:27 -04:00
maxItems : 100
2020-06-24 16:25:05 -04:00
items :
2020-06-25 06:16:08 -04:00
$ref : '#/components/schemas/Notification'
Plugin :
properties :
name :
type : string
2020-06-26 07:43:27 -04:00
example : peertube-plugin-auth-ldap
2020-06-25 06:16:08 -04:00
type :
type : integer
2020-06-26 07:43:27 -04:00
description : >
- `1` : PLUGIN
- `2` : THEME
2020-06-25 06:16:08 -04:00
enum :
- 1
- 2
latestVersion :
type : string
2020-06-26 07:43:27 -04:00
example : 0.0 .3
2020-06-25 06:16:08 -04:00
version :
type : string
2020-06-26 07:43:27 -04:00
example : 0.0 .1
2020-06-25 06:16:08 -04:00
enabled :
type : boolean
uninstalled :
type : boolean
peertubeEngine :
type : string
2020-06-26 07:43:27 -04:00
example : 2.2 .0
2020-06-25 06:16:08 -04:00
description :
type : string
homepage :
type : string
2020-06-26 07:43:27 -04:00
format : url
example : https://framagit.org/framasoft/peertube/official-plugins/tree/master/peertube-plugin-auth-ldap
2020-06-25 06:16:08 -04:00
settings :
type : object
additionalProperties : true
createdAt :
type : string
format : date-time
updatedAt :
type : string
format : date-time
PluginResponse :
properties :
total :
type : integer
2020-06-26 07:43:27 -04:00
example : 1
2020-06-25 06:16:08 -04:00
data :
type : array
2020-06-26 07:43:27 -04:00
maxItems : 100
2020-06-25 06:16:08 -04:00
items :
2020-06-27 05:43:43 -04:00
$ref : '#/components/schemas/Plugin'
2020-11-09 05:21:08 -05:00
LiveVideoUpdate :
properties :
saveReplay :
type : boolean
2020-12-03 08:10:54 -05:00
permanentLive :
description : User can stream multiple times in a permanent live
type : boolean
2020-11-09 05:21:08 -05:00
LiveVideoResponse :
properties :
rtmpUrl :
type : string
streamKey :
type : string
description : RTMP stream key to use to stream into this live video
saveReplay :
type : boolean
2020-12-03 08:10:54 -05:00
permanentLive :
description : User can stream multiple times in a permanent live
type : boolean
2020-11-09 05:21:08 -05:00
2020-06-27 05:43:43 -04:00
callbacks :
searchIndex :
2020-08-03 03:12:51 -04:00
'https://search.example.org/api/v1/search/videos' :
2020-06-27 05:43:43 -04:00
post :
summary : third-party search index MAY be used instead of the local index, if enabled by the instance admin. see `searchTarget`
responses :
'200' :
description : successful operation
content :
application/json :
schema :
2020-07-02 08:23:50 -04:00
$ref : '#/components/schemas/VideoListResponse'