Merge branch 'master' of https://github.com/NodeBB/NodeBB

public/openapi/components/responses/400.yaml

@@ -0,0 +1,6 @@
+'400':
+  description: Bad Request
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/responses/401.yaml

@@ -0,0 +1,6 @@
+'401':
+  description: Not Authorized
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/responses/403.yaml

@@ -0,0 +1,6 @@
+'403':
+  description: Forbidden
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/responses/404.yaml

@@ -0,0 +1,6 @@
+'404':
+  description: Not Found
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/responses/426.yaml

@@ -0,0 +1,6 @@
+'426':
+  description: Upgrade Required
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/responses/500.yaml

@@ -0,0 +1,6 @@
+'500':
+  description: Internal Server Error
+  content:
+    application/json:
+      schema:
+        $ref: ../../components/schemas/Error.yaml#/Error

public/openapi/components/schemas/CategoryObj.yaml

@@ -0,0 +1,72 @@
+CategoryObj:
+  properties:
+    cid:
+      type: number
+      example: 1
+    name:
+      type: string
+      example: My New Category
+    description:
+      type: string
+      example: Lorem ipsum, dolor sit amet
+    descriptionParsed:
+      type: string
+      example: Lorem ipsum, dolor sit amet
+    icon:
+      type: string
+      example: bullhorn
+    bgColor:
+      type: string
+      example: '#ffffff'
+    color:
+      type: string
+      example: '#000000'
+    slug:
+      type: string
+      example: 1/my-new-category
+    parentCid:
+      type: number
+      example: 0
+    topic_count:
+      type: number
+      example: 0
+    post_count:
+      type: number
+      example: 0
+    disabled:
+      type: number
+      example: 0
+    order:
+      type: number
+      example: 5
+    link:
+      type: number
+      example: 'https://example.org'
+    numRecentReplies:
+      type: number
+      example: 1
+    class:
+      type: string
+      example: col-md-3 col-xs-6
+    imageClass:
+      type: string
+      example: cover
+    isSection:
+      type: number
+      example: 0
+    totalPostCount:
+      type: number
+      example: 0
+    totalTopicCount:
+      type: number
+      example: 0
+    tagWhitelist:
+      type: array
+      example:
+        - some-tag
+        - another-tag
+    unread-class:
+      type: string
+    backgroundImage:
+      type: string
+      example: '/assets/images/covers/Circuit1.png'

public/openapi/components/schemas/Error.yaml

@@ -0,0 +1,12 @@
+Error:
+  type: object
+  properties:
+    status:
+      type: object
+      properties:
+        code:
+          type: string
+        message:
+          type: string
+    response:
+      type: object

public/openapi/components/schemas/Status.yaml

@@ -0,0 +1,9 @@
+Status:
+  type: object
+  properties:
+    code:
+      type: string
+      example: ok
+    message:
+      type: string
+      example: OK

public/openapi/components/schemas/UserObj.yaml

@@ -0,0 +1,119 @@
+UserObj:
+  properties:
+    uid:
+      type: number
+      example: 1
+    username:
+      type: string
+      example: Dragon Fruit
+    userslug:
+      type: string
+      example: dragon-fruit
+    email:
+      type: string
+      example: dragonfruit@example.org
+    'email:confirmed':
+      type: number
+      example: 1
+    joindate:
+      type: number
+      example: 1585337827953
+    lastonline:
+      type: number
+      example: 1585337827953
+    picture:
+      type: string
+      example: 'https://images.unsplash.com/photo-1560070094-e1f2ddec4337?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=256&h=256&q=80'
+    fullname:
+      type: string
+      example: Mr. Dragon Fruit Jr.
+    location:
+      type: string
+      example: 'Toronto, Canada'
+    birthday:
+      type: string
+      description: A birthdate given in an ISO format parseable by the Date object
+      example: 03/27/2020
+    website:
+      type: string
+      example: 'https://example.org'
+    aboutme:
+      type: string
+      example: |
+        This is a paragraph all about how my life got twist-turned upside-down
+        and I'd like to take a minute and sit right here,
+        to tell you all about how I because the administrator of NodeBB
+    signature:
+      type: string
+      example: |
+        This is an example signature
+        It can span multiple lines.
+    uploadedpicture:
+      type: string
+      example: /assets/profile/1-profileimg.png
+      description: 'In almost all cases, defer to "picture" instead. Use this if you need to specifically reference the picture uploaded to the forum.'
+    profileviews:
+      type: number
+      example: 1000
+    reputation:
+      type: number
+      example: 100
+    postcount:
+      type: number
+      example: 1000
+    topiccount:
+      type: number
+      example: 50
+    lastposttime:
+      type: number
+      example: 1585337827953
+    banned:
+      type: number
+      example: 0
+    'banned:expire':
+      type: number
+      example: 1585337827953
+    status:
+      type: string
+      example: online
+    flags:
+      type: number
+      example: 0
+    followercount:
+      type: number
+      example: 2
+    followingcount:
+      type: number
+      example: 5
+    'cover:url':
+      type: string
+      example: /assets/profile/1-cover.png
+    'cover:position':
+      type: string
+      example: 50.0301% 19.2464%
+    groupTitle:
+      type: string
+      example: '["administrators","Staff"]'
+    groupTitleArray:
+      type: array
+      example:
+        - administrators
+        - Staff
+    'icon:text':
+      type: string
+      example: D
+    'icon:bgColor':
+      type: string
+      example: '#9c27b0'
+    joindateISO:
+      type: string
+      example: '2020-03-27T20:30:36.590Z'
+    lastonlineISO:
+      type: string
+      example: '2020-03-27T20:30:36.590Z'
+    banned_until:
+      type: number
+      example: 0
+    banned_until_readable:
+      type: string
+      example: Not Banned

public/openapi/components/schemas/UserRequest.yaml

@@ -0,0 +1,35 @@
+UserRequest:
+  properties:
+    username:
+      type: string
+      example: Dragon Fruit
+    email:
+      type: string
+      example: dragonfruit@example.org
+    fullname:
+      type: string
+      example: Mr. Dragon Fruit Jr.
+    website:
+      type: string
+      example: 'https://example.org'
+    location:
+      type: string
+      example: 'Toronto, Canada'
+    groupTitle:
+      type: string
+      example: '["administrators","Staff"]'
+    birthday:
+      type: string
+      description: A birthdate given in an ISO format parseable by the Date object
+      example: 03/27/2020
+    signature:
+      type: string
+      example: |
+        This is an example signature
+        It can span multiple lines.
+    aboutme:
+      type: string
+      example: |
+        This is a paragraph all about how my life got twist-turned upside-down
+        and I'd like to take a minute and sit right here,
+        to tell you all about how I because the administrator of NodeBB

public/openapi/read.yaml

@@ -56,252 +56,252 @@ tags:
     description: Convenience and utility routes for accessing other part of the API
 paths:
   /api/:
-    $ref: 'api/index.yaml'
+    $ref: 'read/index.yaml'
   /api/admin/dashboard:
-    $ref: 'api/admin/dashboard.yaml'
+    $ref: 'read/admin/dashboard.yaml'
   /api/admin/settings/languages:
-    $ref: 'api/admin/settings/languages.yaml'
+    $ref: 'read/admin/settings/languages.yaml'
   /api/admin/settings/navigation:
-    $ref: 'api/admin/settings/navigation.yaml'
+    $ref: 'read/admin/settings/navigation.yaml'
   /api/admin/settings/homepage:
-    $ref: 'api/admin/settings/homepage.yaml'
+    $ref: 'read/admin/settings/homepage.yaml'
   /api/admin/settings/social:
-    $ref: 'api/admin/settings/social.yaml'
+    $ref: 'read/admin/settings/social.yaml'
   /api/admin/manage/categories:
-    $ref: 'api/admin/manage/categories.yaml'
+    $ref: 'read/admin/manage/categories.yaml'
   "/api/admin/manage/categories/{category_id}":
-    $ref: 'api/admin/manage/categories/category_id.yaml'
+    $ref: 'read/admin/manage/categories/category_id.yaml'
   "/api/admin/manage/categories/{category_id}/analytics":
-    $ref: 'api/admin/manage/categories/category_id/analytics.yaml'
+    $ref: 'read/admin/manage/categories/category_id/analytics.yaml'
   "/api/admin/manage/privileges/{cid}":
-    $ref: 'api/admin/manage/privileges/cid.yaml'
+    $ref: 'read/admin/manage/privileges/cid.yaml'
   /api/admin/manage/tags:
-    $ref: 'api/admin/manage/tags.yaml'
+    $ref: 'read/admin/manage/tags.yaml'
   /api/admin/manage/users:
-    $ref: 'api/admin/manage/users.yaml'
+    $ref: 'read/admin/manage/users.yaml'
   /api/admin/manage/users/search:
-    $ref: 'api/admin/manage/users/search.yaml'
+    $ref: 'read/admin/manage/users/search.yaml'
   /api/admin/manage/users/latest:
-    $ref: 'api/admin/manage/users/latest.yaml'
+    $ref: 'read/admin/manage/users/latest.yaml'
   /api/admin/manage/users/not-validated:
-    $ref: 'api/admin/manage/users/not-validated.yaml'
+    $ref: 'read/admin/manage/users/not-validated.yaml'
   /api/admin/manage/users/no-posts:
-    $ref: 'api/admin/manage/users/no-posts.yaml'
+    $ref: 'read/admin/manage/users/no-posts.yaml'
   /api/admin/manage/users/top-posters:
-    $ref: 'api/admin/manage/users/top-posters.yaml'
+    $ref: 'read/admin/manage/users/top-posters.yaml'
   /api/admin/manage/users/most-reputation:
-    $ref: 'api/admin/manage/users/most-reputation.yaml'
+    $ref: 'read/admin/manage/users/most-reputation.yaml'
   /api/admin/manage/users/inactive:
-    $ref: 'api/admin/manage/users/inactive.yaml'
+    $ref: 'read/admin/manage/users/inactive.yaml'
   /api/admin/manage/users/flagged:
-    $ref: 'api/admin/manage/users/flagged.yaml'
+    $ref: 'read/admin/manage/users/flagged.yaml'
   /api/admin/manage/users/banned:
-    $ref: 'api/admin/manage/users/banned.yaml'
+    $ref: 'read/admin/manage/users/banned.yaml'
   /api/admin/manage/registration:
-    $ref: 'api/admin/manage/registration.yaml'
+    $ref: 'read/admin/manage/registration.yaml'
   /api/admin/manage/admins-mods:
-    $ref: 'api/admin/manage/admins-mods.yaml'
+    $ref: 'read/admin/manage/admins-mods.yaml'
   /api/admin/manage/groups:
-    $ref: 'api/admin/manage/groups.yaml'
+    $ref: 'read/admin/manage/groups.yaml'
   "/api/admin/manage/groups/{name}":
-    $ref: 'api/admin/manage/groups/name.yaml'
+    $ref: 'read/admin/manage/groups/name.yaml'
   /api/admin/manage/uploads:
-    $ref: 'api/admin/manage/uploads.yaml'
+    $ref: 'read/admin/manage/uploads.yaml'
   /api/admin/manage/digest:
-    $ref: 'api/admin/manage/digest.yaml'
+    $ref: 'read/admin/manage/digest.yaml'
   "/api/admin/settings/{term}":
-    $ref: 'api/admin/settings/term.yaml'
+    $ref: 'read/admin/settings/term.yaml'
   "/api/admin/appearance/{term}":
-    $ref: 'api/admin/appearance/term.yaml'
+    $ref: 'read/admin/appearance/term.yaml'
   /api/admin/extend/plugins:
-    $ref: 'api/admin/extend/plugins.yaml'
+    $ref: 'read/admin/extend/plugins.yaml'
   /api/admin/extend/widgets:
-    $ref: 'api/admin/extend/widgets.yaml'
+    $ref: 'read/admin/extend/widgets.yaml'
   /api/admin/extend/rewards:
-    $ref: 'api/admin/extend/rewards.yaml'
+    $ref: 'read/admin/extend/rewards.yaml'
   /api/admin/advanced/database:
-    $ref: 'api/admin/advanced/database.yaml'
+    $ref: 'read/admin/advanced/database.yaml'
   /api/admin/advanced/events:
-    $ref: 'api/admin/advanced/events.yaml'
+    $ref: 'read/admin/advanced/events.yaml'
   /api/admin/advanced/hooks:
-    $ref: 'api/admin/advanced/hooks.yaml'
+    $ref: 'read/admin/advanced/hooks.yaml'
   /api/admin/advanced/logs:
-    $ref: 'api/admin/advanced/logs.yaml'
+    $ref: 'read/admin/advanced/logs.yaml'
   /api/admin/advanced/errors:
-    $ref: 'api/admin/advanced/errors.yaml'
+    $ref: 'read/admin/advanced/errors.yaml'
   /api/admin/advanced/errors/export:
-    $ref: 'api/admin/advanced/errors/export.yaml'
+    $ref: 'read/admin/advanced/errors/export.yaml'
   /api/admin/advanced/cache:
-    $ref: 'api/admin/advanced/cache.yaml'
+    $ref: 'read/admin/advanced/cache.yaml'
   /api/admin/development/logger:
-    $ref: 'api/admin/development/logger.yaml'
+    $ref: 'read/admin/development/logger.yaml'
   /api/admin/development/info:
-    $ref: 'api/admin/development/info.yaml'
+    $ref: 'read/admin/development/info.yaml'
   /api/admin/users/csv:
-    $ref: 'api/admin/users/csv.yaml'
+    $ref: 'read/admin/users/csv.yaml'
   /api/admin/groups/{groupname}/csv:
-    $ref: 'api/admin/groups/groupname/csv.yaml'
+    $ref: 'read/admin/groups/groupname/csv.yaml'
   /api/admin/analytics:
-    $ref: 'api/admin/analytics.yaml'
+    $ref: 'read/admin/analytics.yaml'
   /api/admin/category/uploadpicture:
-    $ref: 'api/admin/category/uploadpicture.yaml'
+    $ref: 'read/admin/category/uploadpicture.yaml'
   /api/admin/uploadfavicon:
-    $ref: 'api/admin/uploadfavicon.yaml'
+    $ref: 'read/admin/uploadfavicon.yaml'
   /api/admin/uploadTouchIcon:
-    $ref: 'api/admin/uploadTouchIcon.yaml'
+    $ref: 'read/admin/uploadTouchIcon.yaml'
   /api/admin/uploadMaskableIcon:
-    $ref: 'api/admin/uploadMaskableIcon.yaml'
+    $ref: 'read/admin/uploadMaskableIcon.yaml'
   /api/admin/uploadlogo:
-    $ref: 'api/admin/uploadlogo.yaml'
+    $ref: 'read/admin/uploadlogo.yaml'
   /api/admin/uploadOgImage:
-    $ref: 'api/admin/uploadOgImage.yaml'
+    $ref: 'read/admin/uploadOgImage.yaml'
   /api/admin/upload/file:
-    $ref: 'api/admin/upload/file.yaml'
+    $ref: 'read/admin/upload/file.yaml'
   /api/admin/uploadDefaultAvatar:
-    $ref: 'api/admin/uploadDefaultAvatar.yaml'
+    $ref: 'read/admin/uploadDefaultAvatar.yaml'
   /api/config:
-    $ref: 'api/config.yaml'
+    $ref: 'read/config.yaml'
   /api/users:
-    $ref: 'api/users.yaml'
+    $ref: 'read/users.yaml'
   "/api/user/uid/{uid}":
-    $ref: 'api/user/uid/uid.yaml'
+    $ref: 'read/user/uid/uid.yaml'
   "/api/user/username/{username}":
-    $ref: 'api/user/username/username.yaml'
+    $ref: 'read/user/username/username.yaml'
   "/api/user/email/{email}":
-    $ref: 'api/user/email/email.yaml'
+    $ref: 'read/user/email/email.yaml'
   "/api/user/uid/{userslug}/export/posts":
-    $ref: 'api/user/uid/userslug/export/posts.yaml'
+    $ref: 'read/user/uid/userslug/export/posts.yaml'
   "/api/user/uid/{userslug}/export/uploads":
-    $ref: 'api/user/uid/userslug/export/uploads.yaml'
+    $ref: 'read/user/uid/userslug/export/uploads.yaml'
   "/api/user/uid/{userslug}/export/profile":
-    $ref: 'api/user/uid/userslug/export/profile.yaml'
+    $ref: 'read/user/uid/userslug/export/profile.yaml'
   "/api/post/pid/{id}":
-    $ref: 'api/post/pid/id.yaml'
+    $ref: 'read/post/pid/id.yaml'
   "/api/topic/tid/{id}":
-    $ref: 'api/topic/tid/id.yaml'
+    $ref: 'read/topic/tid/id.yaml'
   "/api/category/cid/{id}":
-    $ref: 'api/category/cid/id.yaml'
+    $ref: 'read/category/cid/id.yaml'
   /api/categories:
-    $ref: 'api/categories.yaml'
+    $ref: 'read/categories.yaml'
   "/api/categories/{cid}/moderators":
-    $ref: 'api/categories/cid/moderators.yaml'
+    $ref: 'read/categories/cid/moderators.yaml'
   "/api/topic/{topic_id}/{slug}/{post_index}":
-    $ref: 'api/topic/topic_id/slug/post_index.yaml'
+    $ref: 'read/topic/topic_id/slug/post_index.yaml'
   /api/recent:
-    $ref: 'api/recent.yaml'
+    $ref: 'read/recent.yaml'
   "/api/recent/posts/{term}":
-    $ref: 'api/recent/posts/term.yaml'
+    $ref: 'read/recent/posts/term.yaml'
   /api/unread:
-    $ref: 'api/unread.yaml'
+    $ref: 'read/unread.yaml'
   /api/unread/total:
-    $ref: 'api/unread/total.yaml'
+    $ref: 'read/unread/total.yaml'
   "/api/topic/teaser/{topic_id}":
-    $ref: 'api/topic/teaser/topic_id.yaml'
+    $ref: 'read/topic/teaser/topic_id.yaml'
   "/api/topic/pagination/{topic_id}":
-    $ref: 'api/topic/pagination/topic_id.yaml'
+    $ref: 'read/topic/pagination/topic_id.yaml'
   /api/post/upload:
-    $ref: 'api/post/upload.yaml'
+    $ref: 'read/post/upload.yaml'
   /api/topic/thumb/upload:
-    $ref: 'api/topic/thumb/upload.yaml'
+    $ref: 'read/topic/thumb/upload.yaml'
   /api/login:
-    $ref: 'api/login.yaml'
+    $ref: 'read/login.yaml'
   /api/register:
-    $ref: 'api/register.yaml'
+    $ref: 'read/register.yaml'
   /api/search:
-    $ref: 'api/search.yaml'
+    $ref: 'read/search.yaml'
   "/api/reset":
-    $ref: 'api/reset.yaml'
+    $ref: 'read/reset.yaml'
   "/api/reset/{code}":
-    $ref: 'api/reset/code.yaml'
+    $ref: 'read/reset/code.yaml'
   "/api/email/unsubscribe/{token}":
-    $ref: 'api/email/unsubscribe/token.yaml'
+    $ref: 'read/email/unsubscribe/token.yaml'
   "/api/post/{pid}":
-    $ref: 'api/post/pid.yaml'
+    $ref: 'read/post/pid.yaml'
   /api/flags:
-    $ref: 'api/flags.yaml'
+    $ref: 'read/flags.yaml'
   "/api/flags/{flagId}":
-    $ref: 'api/flags/flagId.yaml'
+    $ref: 'read/flags/flagId.yaml'
   /api/post-queue:
-    $ref: 'api/post-queue.yaml'
+    $ref: 'read/post-queue.yaml'
   /api/ip-blacklist:
-    $ref: 'api/ip-blacklist.yaml'
+    $ref: 'read/ip-blacklist.yaml'
   /api/registration-queue:
-    $ref: 'api/registration-queue.yaml'
+    $ref: 'read/registration-queue.yaml'
   /api/tags:
-    $ref: 'api/tags.yaml'
+    $ref: 'read/tags.yaml'
   "/api/tags/{tag}":
-    $ref: 'api/tags/tag.yaml'
+    $ref: 'read/tags/tag.yaml'
   /api/popular:
-    $ref: 'api/popular.yaml'
+    $ref: 'read/popular.yaml'
   /api/top:
-    $ref: 'api/top.yaml'
+    $ref: 'read/top.yaml'
   "/api/category/{category_id}/{slug}/{topic_index}":
-    $ref: 'api/category/category_id/slug/topic_index.yaml'
+    $ref: 'read/category/category_id/slug/topic_index.yaml'
   /api/self:
-    $ref: 'api/self.yaml'
+    $ref: 'read/self.yaml'
   /api/me:
-    $ref: 'api/me.yaml'
+    $ref: 'read/me.yaml'
   /api/me/*:
-    $ref: 'api/me.yaml'
+    $ref: 'read/me.yaml'
   "/api/uid/{uid}/*":
-    $ref: 'api/uid/uid.yaml'
+    $ref: 'read/uid/uid.yaml'
   "/api/user/{userslug}":
-    $ref: 'api/user/userslug.yaml'
+    $ref: 'read/user/userslug.yaml'
   "/api/user/{userslug}/following":
-    $ref: 'api/user/userslug/following.yaml'
+    $ref: 'read/user/userslug/following.yaml'
   "/api/user/{userslug}/followers":
-    $ref: 'api/user/userslug/followers.yaml'
+    $ref: 'read/user/userslug/followers.yaml'
   "/api/user/{userslug}/categories":
-    $ref: 'api/user/userslug/categories.yaml'
+    $ref: 'read/user/userslug/categories.yaml'
   "/api/user/{userslug}/posts":
-    $ref: 'api/user/userslug/posts.yaml'
+    $ref: 'read/user/userslug/posts.yaml'
   "/api/user/{userslug}/topics":
-    $ref: 'api/user/userslug/topics.yaml'
+    $ref: 'read/user/userslug/topics.yaml'
   "/api/user/{userslug}/best":
-    $ref: 'api/user/userslug/best.yaml'
+    $ref: 'read/user/userslug/best.yaml'
   "/api/user/{userslug}/groups":
-    $ref: 'api/user/userslug/groups.yaml'
+    $ref: 'read/user/userslug/groups.yaml'
   "/api/user/{userslug}/bookmarks":
-    $ref: 'api/user/userslug/bookmarks.yaml'
+    $ref: 'read/user/userslug/bookmarks.yaml'
   "/api/user/{userslug}/watched":
-    $ref: 'api/user/userslug/watched.yaml'
+    $ref: 'read/user/userslug/watched.yaml'
   "/api/user/{userslug}/ignored":
-    $ref: 'api/user/userslug/ignored.yaml'
+    $ref: 'read/user/userslug/ignored.yaml'
   "/api/user/{userslug}/upvoted":
-    $ref: 'api/user/userslug/upvoted.yaml'
+    $ref: 'read/user/userslug/upvoted.yaml'
   "/api/user/{userslug}/downvoted":
-    $ref: 'api/user/userslug/downvoted.yaml'
+    $ref: 'read/user/userslug/downvoted.yaml'
   "/api/user/{userslug}/edit":
-    $ref: 'api/user/userslug/edit.yaml'
+    $ref: 'read/user/userslug/edit.yaml'
   "/api/user/{userslug}/edit/username":
-    $ref: 'api/user/userslug/edit/username.yaml'
+    $ref: 'read/user/userslug/edit/username.yaml'
   "/api/user/{userslug}/edit/email":
-    $ref: 'api/user/userslug/edit/email.yaml'
+    $ref: 'read/user/userslug/edit/email.yaml'
   "/api/user/{userslug}/edit/password":
-    $ref: 'api/user/userslug/edit/password.yaml'
+    $ref: 'read/user/userslug/edit/password.yaml'
   "/api/user/{userslug}/info":
-    $ref: 'api/user/userslug/info.yaml'
+    $ref: 'read/user/userslug/info.yaml'
   "/api/user/{userslug}/settings":
-    $ref: 'api/user/userslug/settings.yaml'
+    $ref: 'read/user/userslug/settings.yaml'
   "/api/user/{userslug}/uploads":
-    $ref: 'api/user/userslug/uploads.yaml'
+    $ref: 'read/user/userslug/uploads.yaml'
   "/api/user/{userslug}/consent":
-    $ref: 'api/user/userslug/consent.yaml'
+    $ref: 'read/user/userslug/consent.yaml'
   "/api/user/{userslug}/blocks":
-    $ref: 'api/user/userslug/blocks.yaml'
+    $ref: 'read/user/userslug/blocks.yaml'
   "/api/user/{userslug}/sessions":
-    $ref: 'api/user/userslug/sessions.yaml'
+    $ref: 'read/user/userslug/sessions.yaml'
   "/api/user/{userslug}/session/{uuid}":
-    $ref: 'api/user/userslug/session/uuid.yaml'
+    $ref: 'read/user/userslug/session/uuid.yaml'
   /api/notifications:
-    $ref: 'api/notifications.yaml'
+    $ref: 'read/notifications.yaml'
   "/api/user/{userslug}/chats/{roomid}":
-    $ref: 'api/user/userslug/chats/roomid.yaml'
+    $ref: 'read/user/userslug/chats/roomid.yaml'
   "/api/chats/{roomid}":
-    $ref: 'api/chats/roomid.yaml'
+    $ref: 'read/chats/roomid.yaml'
   /api/groups:
-    $ref: 'api/groups.yaml'
+    $ref: 'read/groups.yaml'
   "/api/groups/{slug}":
-    $ref: 'api/groups/slug.yaml'
+    $ref: 'read/groups/slug.yaml'
   "/api/groups/{slug}/members":
-    $ref: 'api/groups/slug/members.yaml'
+    $ref: 'read/groups/slug/members.yaml'