From 5413e4c7e81bcbdb94534551745b0ecbaf8c4937 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 28 Jun 2024 23:27:24 +0200
Subject: [PATCH] Update Documentation with core changes (#113)

Co-authored-by: discoursebuild <build@discourse.org>
---
 openapi.json | 66 ++++++++++++++++++++++++++--------------------------
 openapi.yml  | 66 ++++++++++++++++++++++++++--------------------------
 2 files changed, 66 insertions(+), 66 deletions(-)

diff --git a/openapi.json b/openapi.json
index d750eb5..f156c70 100644
--- a/openapi.json
+++ b/openapi.json
@@ -2084,7 +2084,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -4440,7 +4440,7 @@
                           },
                           "flair_group_id": {
                             "type": [
-                              "string",
+                              "integer",
                               "null"
                             ]
                           },
@@ -4526,7 +4526,7 @@
                           },
                           "reviewable_id": {
                             "type": [
-                              "string",
+                              "integer",
                               "null"
                             ]
                           },
@@ -4667,7 +4667,7 @@
                     },
                     "flair_group_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -4761,7 +4761,7 @@
                     },
                     "reviewable_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -4912,7 +4912,7 @@
         ],
         "responses": {
           "200": {
-            "description": "single post",
+            "description": "single reviewable post",
             "content": {
               "application/json": {
                 "schema": {
@@ -5007,7 +5007,7 @@
                     },
                     "flair_group_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -5110,7 +5110,7 @@
                     },
                     "reviewable_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -5308,7 +5308,7 @@
                         },
                         "flair_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -5405,7 +5405,7 @@
                         },
                         "reviewable_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -5684,7 +5684,7 @@
                       },
                       "flair_group_id": {
                         "type": [
-                          "string",
+                          "integer",
                           "null"
                         ]
                       },
@@ -5794,7 +5794,7 @@
                       },
                       "reviewable_id": {
                         "type": [
-                          "string",
+                          "integer",
                           "null"
                         ]
                       },
@@ -6144,7 +6144,7 @@
                     },
                     "reviewable_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -6385,7 +6385,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -6411,7 +6411,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -6633,7 +6633,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -8307,7 +8307,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -9451,7 +9451,7 @@
                               },
                               "flair_group_id": {
                                 "type": [
-                                  "string",
+                                  "integer",
                                   "null"
                                 ]
                               },
@@ -10182,7 +10182,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -10417,7 +10417,7 @@
                                     },
                                     "primary_group_id": {
                                       "type": [
-                                        "string",
+                                        "integer",
                                         "null"
                                       ]
                                     }
@@ -10646,7 +10646,7 @@
                     },
                     "category_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     }
@@ -11728,7 +11728,7 @@
         ],
         "responses": {
           "200": {
-            "description": "user response",
+            "description": "user with primary group response",
             "content": {
               "application/json": {
                 "schema": {
@@ -11850,7 +11850,7 @@
                         },
                         "primary_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -11862,7 +11862,7 @@
                         },
                         "flair_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -11913,7 +11913,7 @@
                         },
                         "uploaded_avatar_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -12867,7 +12867,7 @@
                         },
                         "primary_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -12879,7 +12879,7 @@
                         },
                         "flair_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -12930,7 +12930,7 @@
                         },
                         "uploaded_avatar_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -13819,7 +13819,7 @@
                         },
                         "primary_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -13831,7 +13831,7 @@
                         },
                         "flair_group_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -13882,7 +13882,7 @@
                         },
                         "uploaded_avatar_id": {
                           "type": [
-                            "string",
+                            "integer",
                             "null"
                           ]
                         },
@@ -15138,7 +15138,7 @@
                     },
                     "primary_group_id": {
                       "type": [
-                        "string",
+                        "integer",
                         "null"
                       ]
                     },
@@ -15455,7 +15455,7 @@
                           },
                           "flair_group_id": {
                             "type": [
-                              "string",
+                              "integer",
                               "null"
                             ]
                           },
diff --git a/openapi.yml b/openapi.yml
index 1d73654..c9792ed 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -1529,7 +1529,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
                                 required:
                                 - extras
@@ -3176,7 +3176,7 @@ paths:
                           - 'null'
                         flair_group_id:
                           type:
-                          - string
+                          - integer
                           - 'null'
                         version:
                           type: integer
@@ -3233,7 +3233,7 @@ paths:
                           type: boolean
                         reviewable_id:
                           type:
-                          - string
+                          - integer
                           - 'null'
                         reviewable_score_count:
                           type: integer
@@ -3325,7 +3325,7 @@ paths:
                     - 'null'
                   flair_group_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   version:
                     type: integer
@@ -3388,7 +3388,7 @@ paths:
                     type: boolean
                   reviewable_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   reviewable_score_count:
                     type: integer
@@ -3512,7 +3512,7 @@ paths:
         required: true
       responses:
         '200':
-          description: single post
+          description: single reviewable post
           content:
             application/json:
               schema:
@@ -3578,7 +3578,7 @@ paths:
                     - 'null'
                   flair_group_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   version:
                     type: integer
@@ -3647,7 +3647,7 @@ paths:
                     type: boolean
                   reviewable_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   reviewable_score_count:
                     type: integer
@@ -3794,7 +3794,7 @@ paths:
                         - 'null'
                       flair_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       version:
                         type: integer
@@ -3859,7 +3859,7 @@ paths:
                         type: boolean
                       reviewable_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       reviewable_score_count:
                         type: integer
@@ -4060,7 +4060,7 @@ paths:
                       - 'null'
                     flair_group_id:
                       type:
-                      - string
+                      - integer
                       - 'null'
                     version:
                       type: integer
@@ -4134,7 +4134,7 @@ paths:
                       type: boolean
                     reviewable_id:
                       type:
-                      - string
+                      - integer
                       - 'null'
                     reviewable_score_count:
                       type: integer
@@ -4376,7 +4376,7 @@ paths:
                     type: object
                   reviewable_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   reviewable_score_count:
                     type: integer
@@ -4538,7 +4538,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
                             participants:
                               type: array
@@ -4555,7 +4555,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
   "/topics/private-messages-sent/{username}.json":
     get:
@@ -4700,7 +4700,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
                             participants:
                               type: array
@@ -5890,7 +5890,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
   "/t/{id}/posts.json":
     get:
@@ -6676,7 +6676,7 @@ paths:
                               - 'null'
                             flair_group_id:
                               type:
-                              - string
+                              - integer
                               - 'null'
                             admin:
                               type: boolean
@@ -7178,7 +7178,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
   "/top.json":
     get:
@@ -7331,7 +7331,7 @@ paths:
                                     type: integer
                                   primary_group_id:
                                     type:
-                                    - string
+                                    - integer
                                     - 'null'
   "/t/{id}/notifications.json":
     post:
@@ -7470,7 +7470,7 @@ paths:
                     type: boolean
                   category_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
       requestBody:
         content:
@@ -8326,7 +8326,7 @@ paths:
           type: string
       responses:
         '200':
-          description: user response
+          description: user with primary group response
           content:
             application/json:
               schema:
@@ -8412,7 +8412,7 @@ paths:
                         type: integer
                       primary_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       primary_group_name:
                         type:
@@ -8420,7 +8420,7 @@ paths:
                         - 'null'
                       flair_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       flair_name:
                         type:
@@ -8454,7 +8454,7 @@ paths:
                         type: boolean
                       uploaded_avatar_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       has_title_badges:
                         type: boolean
@@ -9142,7 +9142,7 @@ paths:
                         type: integer
                       primary_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       primary_group_name:
                         type:
@@ -9150,7 +9150,7 @@ paths:
                         - 'null'
                       flair_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       flair_name:
                         type:
@@ -9184,7 +9184,7 @@ paths:
                         type: boolean
                       uploaded_avatar_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       has_title_badges:
                         type: boolean
@@ -9833,7 +9833,7 @@ paths:
                         type: integer
                       primary_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       primary_group_name:
                         type:
@@ -9841,7 +9841,7 @@ paths:
                         - 'null'
                       flair_group_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       flair_name:
                         type:
@@ -9875,7 +9875,7 @@ paths:
                         type: boolean
                       uploaded_avatar_id:
                         type:
-                        - string
+                        - integer
                         - 'null'
                       has_title_badges:
                         type: boolean
@@ -10766,7 +10766,7 @@ paths:
                     - 'null'
                   primary_group_id:
                     type:
-                    - string
+                    - integer
                     - 'null'
                   badge_count:
                     type: integer
@@ -10991,7 +10991,7 @@ paths:
                           - 'null'
                         flair_group_id:
                           type:
-                          - string
+                          - integer
                           - 'null'
                         bio_raw:
                           type: