aboutsummaryrefslogtreecommitdiffhomepage
path: root/support/doc/api
diff options
context:
space:
mode:
Diffstat (limited to 'support/doc/api')
-rw-r--r--support/doc/api/openapi.yaml22
1 files changed, 11 insertions, 11 deletions
diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yaml
index 79417e34f..568a0ba0d 100644
--- a/support/doc/api/openapi.yaml
+++ b/support/doc/api/openapi.yaml
@@ -21,7 +21,7 @@ info:
21 - [Go](https://framagit.org/framasoft/peertube/clients/go) 21 - [Go](https://framagit.org/framasoft/peertube/clients/go)
22 - [Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin) 22 - [Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin)
23 23
24 See the [REST API quick start](https://docs.joinpeertube.org/api-rest-getting-started) for a few 24 See the [REST API quick start](https://docs.joinpeertube.org/api/rest-getting-started) for a few
25 examples of using the PeerTube API. 25 examples of using the PeerTube API.
26 26
27 # Authentication 27 # Authentication
@@ -33,7 +33,7 @@ info:
33 ## Roles 33 ## Roles
34 34
35 Accounts are given permissions based on their role. There are three roles on 35 Accounts are given permissions based on their role. There are three roles on
36 PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin-managing-users?id=roles) for a detail of their permissions. 36 PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin/managing-users?id=roles) for a detail of their permissions.
37 37
38 # Errors 38 # Errors
39 39
@@ -46,7 +46,7 @@ info:
46 46
47 { 47 {
48 "detail": "Video not found", 48 "detail": "Video not found",
49 "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", 49 "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo",
50 "status": 404, 50 "status": 404,
51 "title": "Not Found", 51 "title": "Not Found",
52 "type": "about:blank" 52 "type": "about:blank"
@@ -63,10 +63,10 @@ info:
63 63
64 { 64 {
65 "detail": "Cannot get this video regarding follow constraints", 65 "detail": "Cannot get this video regarding follow constraints",
66 "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", 66 "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo",
67 "status": 403, 67 "status": 403,
68 "title": "Forbidden", 68 "title": "Forbidden",
69 "type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints" 69 "type": "https://docs.joinpeertube.org/api/rest-reference.html#section/Errors/does_not_respect_follow_constraints"
70 } 70 }
71 ``` 71 ```
72 72
@@ -84,7 +84,7 @@ info:
84 84
85 { 85 {
86 "detail": "Incorrect request parameters: id", 86 "detail": "Incorrect request parameters: id",
87 "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", 87 "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo",
88 "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180", 88 "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180",
89 "invalid-params": { 89 "invalid-params": {
90 "id": { 90 "id": {
@@ -149,7 +149,7 @@ info:
149 149
150 In addition, all routes serving ActivityPub are CORS-enabled for all origins. 150 In addition, all routes serving ActivityPub are CORS-enabled for all origins.
151externalDocs: 151externalDocs:
152 url: https://docs.joinpeertube.org/api-rest-reference.html 152 url: https://docs.joinpeertube.org/api/rest-reference.html
153tags: 153tags:
154 - name: Register 154 - name: Register
155 description: | 155 description: |
@@ -204,7 +204,7 @@ tags:
204 information across its social graph by posting activities to actors' inbox 204 information across its social graph by posting activities to actors' inbox
205 endpoints. 205 endpoints.
206 externalDocs: 206 externalDocs:
207 url: https://docs.joinpeertube.org/admin-following-instances?id=instances-follows 207 url: https://docs.joinpeertube.org/admin/following-instances?id=instances-follows
208 - name: Instance Redundancy 208 - name: Instance Redundancy
209 description: > 209 description: >
210 Redundancy is part of the inter-server solidarity that PeerTube fosters. 210 Redundancy is part of the inter-server solidarity that PeerTube fosters.
@@ -212,12 +212,12 @@ tags:
212 to the policy of video selection of your choice. Note that you have a similar functionality 212 to the policy of video selection of your choice. Note that you have a similar functionality
213 to mirror individual videos, see [video mirroring](#tag/Video-Mirroring). 213 to mirror individual videos, see [video mirroring](#tag/Video-Mirroring).
214 externalDocs: 214 externalDocs:
215 url: https://docs.joinpeertube.org/admin-following-instances?id=instances-redundancy 215 url: https://docs.joinpeertube.org/admin/following-instances?id=instances-redundancy
216 - name: Plugins 216 - name: Plugins
217 description: > 217 description: >
218 Managing plugins installed from a local path or from NPM, or search for new ones. 218 Managing plugins installed from a local path or from NPM, or search for new ones.
219 externalDocs: 219 externalDocs:
220 url: https://docs.joinpeertube.org/api-plugins 220 url: https://docs.joinpeertube.org/api/plugins
221 - name: Abuses 221 - name: Abuses
222 description: | 222 description: |
223 Abuses deal with reports of local or remote videos/comments/accounts alike. 223 Abuses deal with reports of local or remote videos/comments/accounts alike.
@@ -5933,7 +5933,7 @@ components:
5933 Note that the __access token is valid for 1 day__ and is given 5933 Note that the __access token is valid for 1 day__ and is given
5934 along with a __refresh token valid for 2 weeks__. 5934 along with a __refresh token valid for 2 weeks__.
5935 5935
5936 [Generate]: https://docs.joinpeertube.org/api-rest-getting-started 5936 [Generate]: https://docs.joinpeertube.org/api/rest-getting-started
5937 type: oauth2 5937 type: oauth2
5938 flows: 5938 flows:
5939 password: 5939 password: