X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=support%2Fdoc%2Fapi%2Fhtml%2Findex.html;h=24017e674ad059eaf0b482b1995bf3997be69fe2;hb=aa1c3d929f524f57930f8bb0ae8b07e8b51f9952;hp=700b2a423f8a282994d15924bf61d719b1dab2b0;hpb=f209b32afaffbb8b93c265525ebde182ab66c37a;p=github%2FChocobozzz%2FPeerTube.git diff --git a/support/doc/api/html/index.html b/support/doc/api/html/index.html index 700b2a423..24017e674 100644 --- a/support/doc/api/html/index.html +++ b/support/doc/api/html/index.html @@ -17,14 +17,18 @@
@@ -255,10 +273,10 @@
+

PeerTube + API Reference +

-

PeerTube - API Reference -

Federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser with WebTorrent and Angular.

@@ -278,8 +296,45 @@
+ +

Authentication

+
+
+
+

+ OAuth2 + +

+
+

In the header: + Authorization: Bearer mytoken +

+
+
+
+
+
type
+
+
oauth2
+
+
+
+
flow
+
+
password
+
+
+
+
tokenUrl
+
+
https://peertube.example.com/api/v1/users/token
+
+
+
+
+

Accounts

-
+
@@ -291,7 +346,7 @@

GET - /accounts/{id} + /accounts/{name}

@@ -299,81 +354,58 @@
-
id
+
name
+
in path
+
+ string + +
-

The id of the account

-
-
-
-
type
-
- string - +

The name of the account (chocobozzz or + chocobozzz@peertube.cpy.re for example)

-
-
in
-
path
-
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -422,6 +454,118 @@ "updatedAt": "string" } } + + + +
+
+
+
+ + +
+ Accounts + +
+ + +

+ + GET + /accounts/{name}/videos + +

+
+
+
+
+
+
name
+ +
in path
+
+ string + +
+
+
+

The name of the account (chocobozzz or + chocobozzz@peertube.cpy.re for example)

+
+
+
+
+
+
+
+
+
+
+
+
200 OK
+
+ + Video + +
+ +
+
+

successful operation

+
+
+
+
+
+
Response Content-Types: + application/json +
+
+
Response Example + (200 OK) +
+
{
+  "id": "number",
+  "uuid": "string",
+  "createdAt": "string",
+  "publishedAt": "string",
+  "updatedAt": "string",
+  "category": {
+    "id": "number",
+    "label": "string"
+  },
+  "licence": {
+    "id": "number",
+    "label": "string"
+  },
+  "language": {
+    "id": "string",
+    "label": "string"
+  },
+  "privacy": "string",
+  "description": "string",
+  "duration": "number",
+  "isLocal": "boolean",
+  "name": "string",
+  "thumbnailPath": "string",
+  "previewPath": "string",
+  "embedPath": "string",
+  "views": "number",
+  "likes": "number",
+  "dislikes": "number",
+  "nsfw": "boolean",
+  "account": {
+    "name": "string",
+    "displayName": "string",
+    "url": "string",
+    "host": "string",
+    "avatar": {
+      "path": "string",
+      "createdAt": "string",
+      "updatedAt": "string"
+    }
+  }
+}
 
@@ -464,6 +608,17 @@

successful operation

+
+
type
+
+ + + Account + + + +
+
@@ -579,12 +734,12 @@
-

Job

-
+

Feeds

+
- Job + Feeds
@@ -592,7 +747,7 @@

GET - /jobs + /feeds/videos.{format}

@@ -600,81 +755,50 @@
-
state
+
format
+
in path
+
+ string + + xml, + atom, + json + + + xml +
-

The id of the account

-
-
-
-
type
-
- string - -
-
-
-
in
-
path
-
-
-
-
start
-
-
-

starting page

-
-
-
-
type
-
- number - +

The format expected (xml defaults to RSS 2.0, atom to ATOM 1.0 and json to JSON FEED 1.0

-
-
in
-
query
-
-
count
-
-
-

(no description)

+
accountId
+
in query
+
+ number + +
-
-
-
type
- number - +

The id of the local account to filter to (beware, users IDs and not actors IDs which will return empty feeds

-
-
in
-
query
-
-
sort
-
-
-

sorting

+
accountName
+
in query
+
+ string + +
-
-
-
type
- number - +

The name of the local account to filter to

-
-
in
-
query
-
@@ -685,12 +809,6 @@
200 OK
-
- - Job - -
-

successful operation

@@ -700,43 +818,25 @@
Response Content-Types: - application/json + application/atom+xml, application/rss+xml, application/json
-
-
Response Example - (200 OK) -
-
[
-  {
-    "id": "number",
-    "state": "string",
-    "category": "string",
-    "handlerName": "string",
-    "handlerInputData": "string",
-    "createdAt": "string",
-    "updatedAt": "string"
-  }
-]
-
- -
-

ServerFollowing

-
+

Job

+

- DELETE - /server/following/{host} + GET + /jobs

@@ -744,23 +844,170 @@
-
host
+
state
+
in path
+
+ string + +
-

The host to unfollow

+

The id of the account

+
+
+
+
+
start
+
in query
+
+ number + +
+
+
+

starting page

+
+
+
+
+
count
+
in query
+
+ number + +
+
+
+

(no description)

+
+
+
+
+
sort
+
in query
+
+ number + +
+
+
+

sorting

+
+
+
+
+
+
+
+
+
+
+
+
200 OK
+
+ + Job + +
+ +
+
+

successful operation

-
type
+
type
- string + + + Job + +
-
-
in
-
path
+
+
+
+
Response Content-Types: + application/json +
+
+
Response Example + (200 OK) +
+
[
+  {
+    "id": "number",
+    "state": "string",
+    "category": "string",
+    "handlerName": "string",
+    "handlerInputData": "string",
+    "createdAt": "string",
+    "updatedAt": "string"
+  }
+]
+
+ +
+
+
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
+
+

ServerFollowing

+
+ + + + + +

+ + DELETE + /server/following/{host} + +

+
+
+
+
+
+
host
+ +
in path
+
+ string + +
+
+
+

The host to unfollow

+
@@ -785,6 +1032,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -807,60 +1076,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -882,6 +1133,17 @@

successful operation

+
+
type
+
+ + + Follow + + + +
+
@@ -960,60 +1222,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -1035,6 +1279,17 @@

successful operation

+
+
type
+
+ + + Follow + + + +
+
@@ -1119,7 +1374,8 @@
- undefined + +

undefined

@@ -1194,6 +1450,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

User

@@ -1223,7 +1501,8 @@
- undefined + +

User to create

@@ -1283,6 +1562,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1305,60 +1606,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -1380,6 +1663,17 @@

successful operation

+
+
type
+
+ + + User + + + +
+
@@ -1422,41 +1716,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } ] } @@ -1466,6 +1729,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1489,22 +1774,16 @@
id
+
in path
+
+ string + +

The user id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -1528,6 +1807,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1551,22 +1852,16 @@
id
+
in path
+
+ string + +

The user id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -1629,41 +1924,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } ] } @@ -1672,6 +1936,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1700,7 +1986,8 @@
- undefined + +

undefined

@@ -1710,22 +1997,16 @@
id
+
in path
+
+ string + +

The user id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -1764,6 +2045,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1801,6 +2104,17 @@

successful operation

+
+
type
+
+ + + User + + + +
+
@@ -1843,41 +2157,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } ] } @@ -1887,6 +2170,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1915,7 +2220,8 @@
- undefined + +

undefined

@@ -1957,6 +2263,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -1990,6 +2318,13 @@

successful operation

+
+
type
+
+ number + +
+
@@ -2006,6 +2341,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -2029,22 +2386,16 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -2085,6 +2436,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -2107,60 +2480,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -2182,6 +2537,17 @@

successful operation

+
+
type
+
+ + + Video + + + +
+
@@ -2197,6 +2563,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -2207,9 +2574,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -2220,7 +2588,18 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } } ] @@ -2228,6 +2607,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -2256,7 +2657,8 @@
- undefined + +

undefined

@@ -2319,22 +2721,16 @@
avatarfile
+
in formData
+
+ file + +

The file to upload.

-
-
type
-
- file - -
-
-
-
in
-
formData
-
@@ -2376,6 +2772,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

Video

@@ -2399,60 +2817,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -2474,6 +2874,17 @@

successful operation

+
+
type
+
+ + + Video + + + +
+
@@ -2489,6 +2900,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -2499,9 +2911,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -2512,7 +2925,18 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } } ] @@ -2553,6 +2977,13 @@

successful operation

+
+
type
+
+ string[] + +
+
@@ -2604,6 +3035,13 @@

successful operation

+
+
type
+
+ string[] + +
+
@@ -2655,6 +3093,13 @@

successful operation

+
+
type
+
+ string[] + +
+
@@ -2706,6 +3151,13 @@

successful operation

+
+
type
+
+ string[] + +
+
@@ -2746,60 +3198,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -2821,6 +3255,17 @@

successful operation

+
+
type
+
+ + + Video + + + +
+
@@ -2836,6 +3281,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -2846,9 +3292,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -2859,7 +3306,18 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } } ] @@ -2890,21 +3348,201 @@
id
+
in path
+
+ string + +
-

The video id

+

The video id

-
-
type
+
+
+
thumbnailfile
+
in formData
+
+ file + +
+
- string - +

Video thumbnail file

-
-
in
-
path
+
+
+
previewfile
+
in formData
+
+ file + +
+
+
+

Video preview file

+
+
+
+
+
category
+
in formData
+
+ number + +
+
+
+

Video category

+
+
+
+
+
licence
+
in formData
+
+ number + +
+
+
+

Video licence

+
+
+
+
+
language
+
in formData
+
+ string + +
+
+
+

Video language

+
+
+
+
+
description
+
in formData
+
+ string + +
+
+
+

Video description

+
+
+
+
+
waitTranscoding
+
in formData
+
+ boolean + +
+
+
+

Whether or not we wait transcoding before publish the video

+
+
+
+
+
support
+
in formData
+
+ string + +
+
+
+

Text describing how to support the video uploader

+
+
+
+
+
nsfw
+
in formData
+
+ boolean + +
+
+
+

Whether or not this video contains sensitive content

+
+
+
+
+
name
+
in formData
+
+ string + +
+
+
+

Video name

+
+
+
+
+
tags
+
in formData
+
+ string[] + +
+
+
+

Video tags

+
+
+
+
+
commentsEnabled
+
in formData
+
+ boolean + +
+
+
+

Enable or disable comments for this video

+
+
+
+
+
privacy
+
in formData
+
+ string + + Public, + Unlisted + + +
+
+
+

Video privacy

+
+
+
+
+
scheduleUpdate
+
in formData
+
+ [object Object] + +
+
+
+

(no description)

+
@@ -2941,6 +3579,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -2951,9 +3590,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -2964,13 +3604,46 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } }
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -2994,22 +3667,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3045,6 +3712,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -3055,9 +3723,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -3068,7 +3737,18 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } } @@ -3098,22 +3778,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3137,6 +3811,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -3160,22 +3856,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3193,6 +3883,13 @@

successful operation

+
+
type
+
+ string + +
+
@@ -3232,22 +3929,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3293,33 +3984,229 @@
videofile
+ +
in formData
+
+ file + +
-

The file to upload.

+

Video file

-
-
type
+
+
+
thumbnailfile
+ +
in formData
+
+ file + +
+
- file - +

Video thumbnail file

-
-
in
-
formData
-
- -
-
- -
-
-
-
200 OK
-
+
previewfile
+ +
in formData
+
+ file + +
+
+
+

Video preview file

+
+
+
+
+
category
+
in formData
+
+ number + +
+
+
+

Video category

+
+
+
+
+
waitTranscoding
+
in formData
+
+ boolean + +
+
+
+

Whether or not we wait transcoding before publish the video

+
+
+
+
+
licence
+
in formData
+
+ number + +
+
+
+

Video licence

+
+
+
+
+
language
+
in formData
+
+ string + +
+
+
+

Video language

+
+
+
+
+
description
+
in formData
+
+ string + +
+
+
+

Video description

+
+
+
+
+
support
+
in formData
+
+ string + +
+
+
+

Text describing how to support the video uploader

+
+
+
+
+
channelId
+ +
in formData
+
+ number + +
+
+
+

Channel id that will contain this video

+
+
+
+
+
nsfw
+ +
in formData
+
+ boolean + +
+
+
+

Whether or not this video contains sensitive content

+
+
+
+
+
name
+ +
in formData
+
+ string + +
+
+
+

Video name

+
+
+
+
+
tags
+
in formData
+
+ string[] + +
+
+
+

Video tags

+
+
+
+
+
commentsEnabled
+
in formData
+
+ boolean + +
+
+
+

Enable or disable comments for this video

+
+
+
+
+
privacy
+ +
in formData
+
+ [object Object] + +
+
+
+

Video privacy

+
+
+
+
+
scheduleUpdate
+
in formData
+
+ [object Object] + +
+
+
+

(no description)

+
+
+
+
+
+
+
+
+
+
+
+
200 OK
+
VideoUploadResponse @@ -3341,14 +4228,38 @@ (200 OK)
{
-  "id": "number",
-  "uuid": "string"
+  "video": {
+    "id": "number",
+    "uuid": "string"
+  }
 }
 
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

VideoAbuse

@@ -3372,60 +4283,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -3447,6 +4340,17 @@

successful operation

+
+
type
+
+ + + VideoAbuse + + + +
+
@@ -3478,6 +4382,12 @@ "updatedAt": "string" } }, + "video": { + "id": "number", + "name": "string", + "uuid": "string", + "url": "string" + }, "createdAt": "string" } ] @@ -3486,6 +4396,28 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -3509,22 +4441,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3548,6 +4474,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

VideoBlacklist

@@ -3572,22 +4520,16 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3611,6 +4553,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -3634,22 +4598,16 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -3673,6 +4631,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -3695,60 +4675,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -3770,6 +4732,17 @@

successful operation

+
+
type
+
+ + + VideoBlacklist + + + +
+
@@ -3801,9 +4774,31 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

VideoChannel

-
+
@@ -3815,7 +4810,7 @@

GET - /videos/channels + /video-channels

@@ -3824,60 +4819,42 @@
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -3899,6 +4876,17 @@

successful operation

+
+
type
+
+ + + VideoChannel + + + +
+
@@ -3906,49 +4894,18 @@ application/json
-
Response Example - (200 OK) -
-
[
-  {
-    "displayName": "string",
-    "description": "string",
-    "isLocal": "boolean",
-    "owner": {
-      "name": "string",
-      "uuid": "string"
-    },
-    "videos": [
-      {
-        "id": "number",
-        "uuid": "string",
-        "createdAt": "string",
-        "updatedAt": "string",
-        "category": {
-          "id": "number",
-          "label": "string"
-        },
-        "licence": {
-          "id": "number",
-          "label": "string"
-        },
-        "language": {
-          "id": "number",
-          "label": "string"
-        },
-        "description": "string",
-        "duration": "number",
-        "isLocal": "boolean",
-        "name": "string",
-        "thumbnailPath": "string",
-        "previewPath": "string",
-        "embedPath": "string",
-        "views": "number",
-        "likes": "number",
-        "dislikes": "number",
-        "nsfw": "boolean"
-      }
-    ]
+                  
Response Example + (200 OK) +
+
[
+  {
+    "displayName": "string",
+    "description": "string",
+    "isLocal": "boolean",
+    "ownerAccount": {
+      "id": "number",
+      "uuid": "string"
+    }
   }
 ]
 
@@ -3957,7 +4914,7 @@
-
+
@@ -3969,7 +4926,7 @@

POST - /videos/channels + /video-channels

@@ -3984,7 +4941,8 @@
- undefined + +

undefined

@@ -4024,8 +4982,30 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
-
+
@@ -4037,7 +5017,7 @@

GET - /videos/channels/{id} + /video-channels/{id}

@@ -4047,22 +5027,16 @@
id
+
in path
+
+ string + +
-

The video id

-
-
-
-
type
-
- string - +

The video channel id

-
-
in
-
path
-
@@ -4098,41 +5072,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } }
@@ -4140,7 +5083,7 @@
-
+
@@ -4152,7 +5095,7 @@

PUT - /videos/channels/{id} + /video-channels/{id}

@@ -4167,7 +5110,8 @@
- undefined + +

undefined

@@ -4177,22 +5121,16 @@
id
+
in path
+
+ string + +
-

The video id

-
-
-
-
type
-
- string - +

The video channel id

-
-
in
-
path
-
@@ -4229,8 +5167,30 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
-
+
@@ -4242,7 +5202,7 @@

DELETE - /videos/channels/{id} + /video-channels/{id}

@@ -4252,22 +5212,16 @@
id
+
in path
+
+ string + +
-

The video id

-
-
-
-
type
-
- string - +

The video channel id

-
-
in
-
path
-
@@ -4291,8 +5245,30 @@
+
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
-
+
@@ -4304,7 +5280,7 @@

GET - /videos/accounts/{accountId}/channels + /video-channels/{id}/videos

@@ -4312,23 +5288,129 @@
-
accountId
+
id
+
in path
+
+ string + +
-

The account id

+

The video channel id

-
-
type
+
+
+
+
+
+
+
+
+
+
200 OK
+
+ + Video + +
+ +
- string - +

successful operation

-
-
in
-
path
+
+
+
+
Response Content-Types: + application/json +
+
+
Response Example + (200 OK) +
+
{
+  "id": "number",
+  "uuid": "string",
+  "createdAt": "string",
+  "publishedAt": "string",
+  "updatedAt": "string",
+  "category": {
+    "id": "number",
+    "label": "string"
+  },
+  "licence": {
+    "id": "number",
+    "label": "string"
+  },
+  "language": {
+    "id": "string",
+    "label": "string"
+  },
+  "privacy": "string",
+  "description": "string",
+  "duration": "number",
+  "isLocal": "boolean",
+  "name": "string",
+  "thumbnailPath": "string",
+  "previewPath": "string",
+  "embedPath": "string",
+  "views": "number",
+  "likes": "number",
+  "dislikes": "number",
+  "nsfw": "boolean",
+  "account": {
+    "name": "string",
+    "displayName": "string",
+    "url": "string",
+    "host": "string",
+    "avatar": {
+      "path": "string",
+      "createdAt": "string",
+      "updatedAt": "string"
+    }
+  }
+}
+
+ +
+
+
+
+
+ + +
+ VideoChannel + +
+ + +

+ + GET + /accounts/{name}/video-channels + +

+
+
+
+
+
+
name
+ +
in path
+
+ string + +
+
+
+

The name of the account (chocobozzz or + chocobozzz@peertube.cpy.re for example)

+
@@ -4351,6 +5433,17 @@

successful operation

+
+
type
+
+ + + VideoChannel + + + +
+
@@ -4366,41 +5459,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } ] @@ -4432,79 +5494,55 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
start
+
in query
+
+ number + +

starting page

-
-
type
-
- number - -
-
-
-
in
-
query
-
stop
+
in query
+
+ number + +

stopping page

-
-
type
-
- number - -
-
-
-
in
-
query
-
sort
+
in query
+
+ number + +

sorting

-
-
type
-
- number - -
-
-
-
in
-
query
-
@@ -4597,22 +5635,16 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -4679,6 +5711,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -4702,42 +5756,30 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
threadId
+
in path
+
+ string + +

The thread id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -4890,42 +5932,30 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
commentId
+
in path
+
+ string + +

The comment id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -4992,6 +6022,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+
@@ -5015,42 +6067,30 @@
videoId
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
commentId
+
in path
+
+ string + +

The comment id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -5074,6 +6114,28 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

VideoRate

@@ -5098,22 +6160,16 @@
id
+
in path
+
+ string + +

The video id

-
-
type
-
- string - -
-
-
-
in
-
path
-
@@ -5137,11 +6193,33 @@ +
+
+
+ + + + + + + + + + + + + +
+ OAuth2 +
+
+
+

Schema Definitions

-
+

- VideoConstant: + VideoConstantNumber: +

+
+
+
+
+
+ id: + string + +
+
+ label: + string + +
+
+
+
+
+
+
Example
+
{
+  "id": "string",
+  "label": "string"
+}
+
+ +
+
+
+
+
+

+ VideoPrivacy: string + +

+
+
+ string + + Public, + Unlisted, + Private + + +
+
+

Video: @@ -5206,6 +6348,11 @@ string +
+ publishedAt: + string + +
updatedAt: string @@ -5215,7 +6362,7 @@ category: - VideoConstant + VideoConstantNumber @@ -5224,7 +6371,7 @@ licence: - VideoConstant + VideoConstantNumber @@ -5233,7 +6380,16 @@ language: - VideoConstant + VideoConstantString + + + +
+
+ privacy: + + + VideoPrivacy @@ -5298,6 +6454,41 @@ object
+
+
+
+
+ name: + string + +
+
+ displayName: + string + +
+
+ url: + string + +
+
+ host: + string + +
+
+ avatar: + + + Avatar + + + +
+
+
+

@@ -5308,6 +6499,7 @@ "id": "number", "uuid": "string", "createdAt": "string", + "publishedAt": "string", "updatedAt": "string", "category": { "id": "number", @@ -5318,9 +6510,10 @@ "label": "string" }, "language": { - "id": "number", + "id": "string", "label": "string" }, + "privacy": "string", "description": "string", "duration": "number", "isLocal": "boolean", @@ -5331,7 +6524,18 @@ "views": "number", "likes": "number", "dislikes": "number", - "nsfw": "boolean" + "nsfw": "boolean", + "account": { + "name": "string", + "displayName": "string", + "url": "string", + "host": "string", + "avatar": { + "path": "string", + "createdAt": "string", + "updatedAt": "string" + } + } } @@ -5376,6 +6580,32 @@ object +
+
+
+
+ id: + number + +
+
+ name: + string + +
+
+ uuid: + string + +
+
+ url: + string + +
+
+
+
createdAt: string @@ -5407,6 +6637,12 @@ "updatedAt": "string" } }, + "video": { + "id": "number", + "name": "string", + "uuid": "string", + "url": "string" + }, "createdAt": "string" } @@ -5542,19 +6778,26 @@ boolean
-
- owner: +
+ ownerAccount: object
-
- videos: - - - Video - - - +
+
+
+
+ id: + number + +
+
+ uuid: + string + +
+
+
@@ -5566,41 +6809,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } @@ -5746,6 +6958,17 @@ +
+
+ + + VideoCommentThreadTree + + + +
+
+
@@ -6126,6 +7349,17 @@ +
+
+ + + VideoChannel + + + +
+
+
@@ -6163,41 +7397,10 @@ "displayName": "string", "description": "string", "isLocal": "boolean", - "owner": { - "name": "string", + "ownerAccount": { + "id": "number", "uuid": "string" - }, - "videos": [ - { - "id": "number", - "uuid": "string", - "createdAt": "string", - "updatedAt": "string", - "category": { - "id": "number", - "label": "string" - }, - "licence": { - "id": "number", - "label": "string" - }, - "language": { - "id": "number", - "label": "string" - }, - "description": "string", - "duration": "number", - "isLocal": "boolean", - "name": "string", - "thumbnailPath": "string", - "previewPath": "string", - "embedPath": "string", - "views": "number", - "likes": "number", - "dislikes": "number", - "nsfw": "boolean" - } - ] + } } ] } @@ -6225,21 +7428,124 @@ object +
+
+
+
+ allowed: + boolean + +
+
+
+
transcoding: object
+
+
+
+
+ enabledResolutions: + number[] + +
+
+
+ number + +
+
+
+
+
+
avatar: object
+
+
+
+
+ file: + object + +
+
+
+
+
+ size: + object + +
+
+
+
+
+ max: + number + +
+
+
+
+
+
+
+
+ extensions: + string[] + +
+
+
+ string + +
+
+
+
+
+
video: object
+
+
+
+
+ file: + object + +
+
+
+
+
+ extensions: + string[] + +
+
+
+ string + +
+
+
+
+
+
+
+
+
@@ -6521,15 +7827,26 @@
-
- id: - number +
+ video: + object
-
- uuid: - string - +
+
+
+
+ id: + number + +
+
+ uuid: + string + +
+
+
@@ -6538,8 +7855,10 @@
Example
{
-  "id": "number",
-  "uuid": "string"
+  "video": {
+    "id": "number",
+    "uuid": "string"
+  }
 }
 
@@ -6574,6 +7893,17 @@ +
+
+ + + VideoComment + + + +
+
+
@@ -7031,6 +8361,52 @@ "name": "string", "description": "string" } + + + + + + +
+

+ ScheduleVideoUpdate: + +

+
+
+
+
+
+ updateAt: + dateTime + +
+
+

When to update the video

+
+
+ privacy: + + + VideoPrivacy + + + +
+
+
+
+
+
+
Example
+
{
+  "updateAt": "dateTime",
+  "privacy": "string"
+}