e621 3.0.2 → 3.0.3

package/dist/lib/generated/source.json

@@ -12,12 +12,19 @@
             "name": "Donovan_DMC",
             "url": "https://e621.net/forum_topics/46279"
         },
-        "version": "dfa164b"
+        "version": "4b7c2cd",
+        "x-e621ng-commit": "76a023eecea450486d1f1143c4ed9cb257a2be06",
+        "x-e621ng-master-behind-by": 0,
+        "x-e621ng-master-compare-url": "https://github.com/e621ng/e621ng/compare/76a023eecea450486d1f1143c4ed9cb257a2be06...master"
     },
     "servers": [
         {
             "url": "https://e621.net",
-            "description": "E621 (production)"
+            "description": "E621 (Production)"
+        },
+        {
+            "url": "https://e926.net",
+            "description": "E621 (Safe)"
         },
         {
             "url": "http://localhost:3000",
@@ -81,7 +88,7 @@
             "ipAddrQuery": {
                 "name": "search[ip_addr]",
                 "in": "query",
-                "description": "Must be Admin+ to use. See [postgres' documentation](https://www.postgresql.org/docs/9.3/functions-net.html) for information on how this is parsed. Specifically, \"is contained within or equals\" (`<<=`).",
+                "description": "Must be Admin+ to use. See [the PostgreSQL documentation](https://www.postgresql.org/docs/9.3/functions-net.html) for information on how this is parsed. Specifically, \"is contained within or equals\" (`<<=`).",
                 "schema": {
                     "type": "string"
                 }
@@ -191,9 +198,9 @@
                     "avoid_posting_delete",
                     "avoid_posting_undelete",
                     "avoid_posting_destroy",
+                    "blip_destroy",
                     "blip_delete",
-                    "blip_hide",
-                    "blip_unhide",
+                    "blip_undelete",
                     "blip_update",
                     "comment_delete",
                     "comment_hide",
@@ -678,7 +685,7 @@
                     "response_to",
                     "created_at",
                     "updated_at",
-                    "is_hidden",
+                    "is_deleted",
                     "warning_type",
                     "warning_user_id",
                     "updater_id",
@@ -702,10 +709,9 @@
                         "format": "date-time"
                     },
                     "updated_at": {
-                        "type": "string",
-                        "format": "date-time"
+                        "type": "string"
                     },
-                    "is_hidden": {
+                    "is_deleted": {
                         "type": "boolean"
                     },
                     "warning_type": {
@@ -4059,11 +4065,23 @@
             "RisingSearchTrend": {
                 "type": "object",
                 "required": [
-                    "tag"
+                    "name",
+                    "pretty_name",
+                    "post_count",
+                    "category"
                 ],
                 "properties": {
-                    "tag": {
+                    "name": {
+                        "type": "string"
+                    },
+                    "pretty_name": {
                         "type": "string"
+                    },
+                    "post_count": {
+                        "type": "integer"
+                    },
+                    "category": {
+                        "$ref": "#/components/schemas/TagCategories"
                     }
                 }
             },
@@ -4136,6 +4154,102 @@
                         "type": "string"
                     }
                 }
+            },
+            "PostRecommendation": {
+                "type": "object",
+                "required": [
+                    "post_id",
+                    "score",
+                    "explanation"
+                ],
+                "properties": {
+                    "post_id": {
+                        "type": "integer"
+                    },
+                    "score": {
+                        "description": "Currently hardcoded as 1, https://github.com/e621ng/e621ng/blob/5f83e77329d4074c5462c7516c3850f33125f441/app/controllers/posts_controller.rb#L177\n",
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "explanation": {
+                        "description": "Currently hardcoded as null, https://github.com/e621ng/e621ng/blob/5f83e77329d4074c5462c7516c3850f33125f441/app/controllers/posts_controller.rb#L178\n",
+                        "type": "string",
+                        "nullable": true
+                    }
+                }
+            },
+            "RecommendedPosts": {
+                "type": "object",
+                "required": [
+                    "post_id",
+                    "model_version",
+                    "results"
+                ],
+                "properties": {
+                    "post_id": {
+                        "type": "integer"
+                    },
+                    "model_version": {
+                        "type": "string",
+                        "enum": [
+                            "opensearch"
+                        ]
+                    },
+                    "results": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/PostRecommendation"
+                        }
+                    }
+                }
+            },
+            "PostVote": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "post_id",
+                    "user_id",
+                    "score",
+                    "created_at",
+                    "updated_at"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "integer"
+                    },
+                    "post_id": {
+                        "type": "integer"
+                    },
+                    "user_id": {
+                        "type": "integer"
+                    },
+                    "score": {
+                        "$ref": "#/components/schemas/UpDownVote"
+                    },
+                    "created_at": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                    }
+                }
+            },
+            "UpDownVote": {
+                "type": "integer",
+                "enum": [
+                    1,
+                    -1
+                ]
+            },
+            "UpDownMehVote": {
+                "type": "integer",
+                "enum": [
+                    1,
+                    0,
+                    -1
+                ]
             }
         },
         "responses": {
@@ -5481,7 +5595,7 @@
                         "basicAuth": []
                     }
                 ],
-                "description": "Must have the bd staff user flag.",
+                "description": "Soft deletion. Must have the bd staff user flag.",
                 "parameters": [
                     {
                         "$ref": "#/components/parameters/idOrNamePath"
@@ -5971,8 +6085,8 @@
                 }
             },
             "delete": {
-                "summary": "Delete Blip",
-                "operationId": "deleteBlip",
+                "summary": "Destroy Blip",
+                "operationId": "destroyBlip",
                 "tags": [
                     "Blips"
                 ],
@@ -6000,10 +6114,10 @@
                 }
             }
         },
-        "/blips/{id}/hide.json": {
+        "/blips/{id}/delete.json": {
             "post": {
-                "summary": "Hide Blip",
-                "operationId": "hideBlip",
+                "summary": "Delete Blip",
+                "operationId": "deleteBlip",
                 "tags": [
                     "Blips"
                 ],
@@ -6012,7 +6126,7 @@
                         "basicAuth": []
                     }
                 ],
-                "description": "You must be the creator or Moderator+.\n",
+                "description": "Soft deletion. You must be the creator or Moderator+.\n",
                 "parameters": [
                     {
                         "$ref": "#/components/parameters/idPath"
@@ -6038,10 +6152,10 @@
                 }
             }
         },
-        "/blips/{id}/unhide.json": {
+        "/blips/{id}/undelete.json": {
             "post": {
-                "summary": "Unhide Blip",
-                "operationId": "unhideBlip",
+                "summary": "Undelete Blip",
+                "operationId": "undeleteBlip",
                 "tags": [
                     "Blips"
                 ],
@@ -6297,7 +6411,7 @@
                 }
             }
         },
-        "/bulk_update_request/{id}.json": {
+        "/bulk_update_requests/{id}.json": {
             "get": {
                 "summary": "Get Bulk Update Request",
                 "operationId": "getBulkUpdateRequest",
@@ -6409,7 +6523,7 @@
                 }
             }
         },
-        "/bulk_update_request/{id}/approve.json": {
+        "/bulk_update_requests/{id}/approve.json": {
             "post": {
                 "summary": "Approve Bulk Update Request",
                 "operationId": "approveBulkUpdateRequest",
@@ -6887,11 +7001,7 @@
                         "in": "query",
                         "required": true,
                         "schema": {
-                            "type": "integer",
-                            "enum": [
-                                -1,
-                                1
-                            ]
+                            "$ref": "#/components/schemas/UpDownVote"
                         }
                     },
                     {
@@ -8183,12 +8293,7 @@
                                 ],
                                 "properties": {
                                     "forum_post_vote[score]": {
-                                        "type": "integer",
-                                        "enum": [
-                                            -1,
-                                            0,
-                                            1
-                                        ]
+                                        "$ref": "#/components/schemas/UpDownMehVote"
                                     }
                                 }
                             }
@@ -9978,7 +10083,7 @@
             }
         },
         "/notes/{id}/revert.json": {
-            "post": {
+            "put": {
                 "summary": "Revert Note",
                 "operationId": "revertNote",
                 "tags": [
@@ -11031,7 +11136,7 @@
             }
         },
         "/posts/{id}/mark_as_translated.json": {
-            "post": {
+            "put": {
                 "summary": "Mark Post As Translated",
                 "operationId": "markPostAsTranslated",
                 "tags": [
@@ -11147,7 +11252,7 @@
             }
         },
         "/posts/{id}/revert.json": {
-            "post": {
+            "put": {
                 "summary": "Revert Post",
                 "operationId": "revertPost",
                 "tags": [
@@ -11359,11 +11464,7 @@
                         "in": "query",
                         "required": true,
                         "schema": {
-                            "type": "integer",
-                            "enum": [
-                                -1,
-                                1
-                            ]
+                            "$ref": "#/components/schemas/UpDownVote"
                         }
                     },
                     {
@@ -11448,6 +11549,41 @@
                 }
             }
         },
+        "/posts/{id}/recommended.json": {
+            "get": {
+                "summary": "Get Recommended Posts",
+                "operationId": "getRecommendedPosts",
+                "tags": [
+                    "Posts"
+                ],
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/idPath"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limitQuery"
+                    },
+                    {
+                        "$ref": "#/components/parameters/pageQuery"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Success",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RecommendedPosts"
+                                }
+                            }
+                        }
+                    },
+                    "404": {
+                        "$ref": "#/components/responses/NotFound"
+                    }
+                }
+            }
+        },
         "/post_sets.json": {
             "get": {
                 "summary": "Search Post Sets",
@@ -13039,6 +13175,121 @@
                 }
             }
         },
+        "/post_votes.json": {
+            "get": {
+                "summary": "Search Post Votes",
+                "operationId": "searchPostVotes",
+                "tags": [
+                    "Post Votes"
+                ],
+                "security": [
+                    {
+                        "basicAuth": []
+                    }
+                ],
+                "description": "You must be Moderator+.",
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/limitQuery"
+                    },
+                    {
+                        "$ref": "#/components/parameters/pageQuery"
+                    },
+                    {
+                        "$ref": "#/components/parameters/idQuery"
+                    },
+                    {
+                        "name": "search[order]",
+                        "in": "query",
+                        "description": "The order of the results. You must be Admin+.",
+                        "schema": {
+                            "type": "string",
+                            "enum": [
+                                "id_asc",
+                                "id_desc",
+                                "ip_addr"
+                            ]
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[post_id]",
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[user_name]",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[user_id]",
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[post_creator_name]",
+                        "description": "Only usable if one of `post_id`, `user_name`, or `user_id` is also provided.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[post_creator_id]",
+                        "description": "Only usable if one of `post_id`, `user_name`, or `user_id` is also provided.",
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[user_ip_addr]",
+                        "description": "You must be Admin+. Only usable if one of `post_id`, `user_name`, or `user_id` is also provided. See [the PostgreSQL documentation](https://www.postgresql.org/docs/9.3/functions-net.html) for information on how this is parsed. Specifically, \"is contained within or equals\" (`<<=`).",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[score]",
+                        "description": "Only usable if one of `post_id`, `user_name`, or `user_id` is also provided.",
+                        "schema": {
+                            "$ref": "#/components/schemas/UpDownVote"
+                        }
+                    },
+                    {
+                        "in": "query",
+                        "name": "search[duplicates_only]",
+                        "description": "You must be Admin+. Only usable if one of `post_id`, `user_name`, or `user_id` is also provided.",
+                        "schema": {
+                            "type": "boolean"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Success",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "array",
+                                    "items": {
+                                        "$ref": "#/components/schemas/PostVote"
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
         "/post_votes/lock.json": {
             "post": {
                 "summary": "Lock Post Votes",
@@ -14218,6 +14469,12 @@
                             "type": "string",
                             "format": "date"
                         }
+                    },
+                    {
+                        "$ref": "#/components/parameters/limitQuery"
+                    },
+                    {
+                        "$ref": "#/components/parameters/pageQuery"
                     }
                 ],
                 "responses": {
@@ -14306,6 +14563,9 @@
                                     "trends_enabled": {
                                         "type": "boolean"
                                     },
+                                    "trends_displayed": {
+                                        "type": "boolean"
+                                    },
                                     "trends_min_today": {
                                         "type": "integer"
                                     },
@@ -17870,7 +18130,7 @@
                 }
             }
         },
-        "/wiki_page/{id}/revert.json": {
+        "/wiki_pages/{id}/revert.json": {
             "put": {
                 "summary": "Revert Wiki Page",
                 "operationId": "revertWikiPage",
@@ -18085,7 +18345,7 @@
                 }
             }
         },
-        "/admins/users/{id}.json": {
+        "/admin/users/{id}.json": {
             "patch": {
                 "summary": "Admin Edit User",
                 "operationId": "adminEditUser",
@@ -18172,7 +18432,7 @@
                 }
             }
         },
-        "/admins/users/{id}/anonymize.json": {
+        "/admin/users/{id}/anonymize.json": {
             "post": {
                 "summary": "Admin Anonymize User",
                 "operationId": "adminAnonymizeUser",