e621 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/lib/generated/schemas.d.ts +89 -8
  2. package/dist/lib/generated/schemas.js +111 -8
  3. package/dist/lib/generated/sdk.d.ts +45 -1
  4. package/dist/lib/generated/sdk.js +77 -1
  5. package/dist/lib/generated/source.json +848 -1332
  6. package/dist/lib/generated/types.d.ts +430 -170
  7. package/dist/lib/models/Blip.d.ts +3 -3
  8. package/dist/lib/models/Blip.js +1 -1
  9. package/dist/lib/models/Comment.d.ts +5 -4
  10. package/dist/lib/models/Comment.js +1 -1
  11. package/dist/lib/models/ForumPost.d.ts +5 -4
  12. package/dist/lib/models/ForumPost.js +1 -1
  13. package/dist/lib/models/Post.d.ts +3 -2
  14. package/dist/lib/models/Post.js +1 -1
  15. package/dist/lib/models/RisingSearchTrend.d.ts +14 -0
  16. package/dist/lib/models/RisingSearchTrend.js +17 -0
  17. package/dist/lib/models/SearchTrend.d.ts +14 -0
  18. package/dist/lib/models/SearchTrend.js +17 -0
  19. package/dist/lib/models/SearchTrendBlacklist.d.ts +14 -0
  20. package/dist/lib/models/SearchTrendBlacklist.js +17 -0
  21. package/dist/lib/models/Takedown.d.ts +5 -5
  22. package/dist/lib/models/index.d.ts +3 -0
  23. package/dist/lib/models/index.js +4 -1
  24. package/dist/lib/modules/Blips.d.ts +5 -2
  25. package/dist/lib/modules/Blips.js +1 -1
  26. package/dist/lib/modules/Comments.d.ts +5 -2
  27. package/dist/lib/modules/Comments.js +1 -1
  28. package/dist/lib/modules/DText.d.ts +5 -1
  29. package/dist/lib/modules/DText.js +1 -1
  30. package/dist/lib/modules/Favorites.d.ts +9 -3
  31. package/dist/lib/modules/Favorites.js +1 -1
  32. package/dist/lib/modules/ForumPosts.d.ts +5 -2
  33. package/dist/lib/modules/ForumPosts.js +1 -1
  34. package/dist/lib/modules/Pools.d.ts +5 -2
  35. package/dist/lib/modules/Pools.js +1 -1
  36. package/dist/lib/modules/PostReplacements.d.ts +5 -2
  37. package/dist/lib/modules/PostReplacements.js +1 -1
  38. package/dist/lib/modules/PostSets.d.ts +5 -2
  39. package/dist/lib/modules/PostSets.js +1 -1
  40. package/dist/lib/modules/RelatedTags.d.ts +5 -2
  41. package/dist/lib/modules/RelatedTags.js +1 -1
  42. package/dist/lib/modules/SearchTrendBlacklists.d.ts +64 -0
  43. package/dist/lib/modules/SearchTrendBlacklists.js +101 -0
  44. package/dist/lib/modules/SearchTrends.d.ts +57 -0
  45. package/dist/lib/modules/SearchTrends.js +92 -0
  46. package/dist/lib/modules/Takedowns.d.ts +13 -4
  47. package/dist/lib/modules/Takedowns.js +1 -1
  48. package/dist/lib/modules/UploadWhitelists.d.ts +5 -2
  49. package/dist/lib/modules/UploadWhitelists.js +1 -1
  50. package/dist/lib/modules/Users.d.ts +9 -6
  51. package/dist/lib/modules/Users.js +5 -5
  52. package/dist/lib/modules/admin/Users.d.ts +3 -3
  53. package/dist/lib/modules/admin/Users.js +2 -2
  54. package/dist/lib/modules/comments/Votes.d.ts +7 -2
  55. package/dist/lib/modules/comments/Votes.js +2 -2
  56. package/dist/lib/modules/forum_posts/Votes.d.ts +5 -2
  57. package/dist/lib/modules/forum_posts/Votes.js +2 -2
  58. package/dist/lib/modules/index.d.ts +6 -0
  59. package/dist/lib/modules/index.js +5 -1
  60. package/dist/lib/modules/posts/Votes.d.ts +7 -2
  61. package/dist/lib/modules/posts/Votes.js +2 -2
  62. package/dist/lib/util.d.ts +2 -0
  63. package/dist/lib/util.js +1 -1
  64. package/dist/package.json +1 -1
  65. package/package.json +1 -1
@@ -12,7 +12,7 @@
12
12
  "name": "Donovan_DMC",
13
13
  "url": "https://e621.net/forum_topics/46279"
14
14
  },
15
- "version": "bdaa075"
15
+ "version": "dfa164b"
16
16
  },
17
17
  "servers": [
18
18
  {
@@ -43,7 +43,7 @@
43
43
  }
44
44
  },
45
45
  "parameters": {
46
- "id": {
46
+ "idQuery": {
47
47
  "name": "search[id]",
48
48
  "in": "query",
49
49
  "description": "Search for a specific id. Multiple can be separated by commas, up to 100.",
@@ -58,23 +58,7 @@
58
58
  ]
59
59
  }
60
60
  },
61
- "idOrName": {
62
- "name": "idOrName",
63
- "in": "path",
64
- "required": true,
65
- "schema": {
66
- "oneOf": [
67
- {
68
- "type": "integer"
69
- },
70
- {
71
- "type": "string"
72
- }
73
- ]
74
- },
75
- "description": "An ID that can be either an integer or a name."
76
- },
77
- "limit": {
61
+ "limitQuery": {
78
62
  "name": "limit",
79
63
  "in": "query",
80
64
  "description": "The maximum number of results to return. Between 0 and 320.",
@@ -84,7 +68,7 @@
84
68
  "maximum": 320
85
69
  }
86
70
  },
87
- "page": {
71
+ "pageQuery": {
88
72
  "name": "page",
89
73
  "in": "query",
90
74
  "description": "The page number of results to get. Between 1 and 750.",
@@ -94,13 +78,50 @@
94
78
  "maximum": 750
95
79
  }
96
80
  },
97
- "ip_addr": {
81
+ "ipAddrQuery": {
98
82
  "name": "search[ip_addr]",
99
83
  "in": "query",
100
84
  "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\" (`<<=`).",
101
85
  "schema": {
102
86
  "type": "string"
103
87
  }
88
+ },
89
+ "orderQuery": {
90
+ "name": "search[order]",
91
+ "in": "query",
92
+ "description": "The order of the results.",
93
+ "schema": {
94
+ "type": "string",
95
+ "enum": [
96
+ "id_asc",
97
+ "id_desc"
98
+ ]
99
+ }
100
+ },
101
+ "idPath": {
102
+ "name": "id",
103
+ "in": "path",
104
+ "description": "The ID of the item.",
105
+ "required": true,
106
+ "schema": {
107
+ "type": "integer"
108
+ }
109
+ },
110
+ "idOrNamePath": {
111
+ "name": "idOrName",
112
+ "in": "path",
113
+ "required": true,
114
+ "schema": {
115
+ "oneOf": [
116
+ {
117
+ "type": "integer"
118
+ },
119
+ {
120
+ "type": "string"
121
+ }
122
+ ]
123
+ },
124
+ "description": "An ID that can be either an integer or a name."
104
125
  }
105
126
  },
106
127
  "schemas": {
@@ -249,6 +270,7 @@
249
270
  "staff_note_update",
250
271
  "staff_note_delete",
251
272
  "staff_note_undelete",
273
+ "search_trend_blacklist_purge",
252
274
  "created_positive_record",
253
275
  "created_neutral_record",
254
276
  "created_negative_record",
@@ -1681,7 +1703,7 @@
1681
1703
  "type": "boolean"
1682
1704
  },
1683
1705
  "bit_flags": {
1684
- "type": "number"
1706
+ "type": "integer"
1685
1707
  },
1686
1708
  "tag_count_meta": {
1687
1709
  "type": "integer"
@@ -1971,7 +1993,7 @@
1971
1993
  "type": "integer"
1972
1994
  },
1973
1995
  "version": {
1974
- "type": "number"
1996
+ "type": "integer"
1975
1997
  },
1976
1998
  "is_active": {
1977
1999
  "type": "boolean"
@@ -2032,7 +2054,7 @@
2032
2054
  "type": "string"
2033
2055
  },
2034
2056
  "version": {
2035
- "type": "number"
2057
+ "type": "integer"
2036
2058
  },
2037
2059
  "is_active": {
2038
2060
  "type": "boolean"
@@ -2170,7 +2192,7 @@
2170
2192
  "$ref": "#/components/schemas/PoolCategories"
2171
2193
  },
2172
2194
  "version": {
2173
- "type": "number"
2195
+ "type": "integer"
2174
2196
  },
2175
2197
  "added_post_ids": {
2176
2198
  "type": "array",
@@ -2436,7 +2458,7 @@
2436
2458
  }
2437
2459
  },
2438
2460
  "change_seq": {
2439
- "type": "number"
2461
+ "type": "integer"
2440
2462
  },
2441
2463
  "flags": {
2442
2464
  "type": "object",
@@ -2535,6 +2557,7 @@
2535
2557
  },
2536
2558
  "duration": {
2537
2559
  "type": "number",
2560
+ "format": "float",
2538
2561
  "nullable": true
2539
2562
  },
2540
2563
  "uploader_name": {
@@ -2970,7 +2993,7 @@
2970
2993
  "type": "boolean"
2971
2994
  },
2972
2995
  "version": {
2973
- "type": "number"
2996
+ "type": "integer"
2974
2997
  },
2975
2998
  "obsolete_added_tags": {
2976
2999
  "type": "string"
@@ -3364,7 +3387,7 @@
3364
3387
  "type": "string"
3365
3388
  },
3366
3389
  "disp_id": {
3367
- "type": "number"
3390
+ "type": "integer"
3368
3391
  },
3369
3392
  "qtype": {
3370
3393
  "$ref": "#/components/schemas/TicketTypes"
@@ -4012,6 +4035,107 @@
4012
4035
  "$ref": "#/components/schemas/Tag"
4013
4036
  }
4014
4037
  }
4038
+ },
4039
+ "SearchTrend": {
4040
+ "type": "object",
4041
+ "required": [
4042
+ "tag",
4043
+ "count",
4044
+ "day"
4045
+ ],
4046
+ "properties": {
4047
+ "tag": {
4048
+ "type": "string"
4049
+ },
4050
+ "count": {
4051
+ "type": "integer"
4052
+ },
4053
+ "day": {
4054
+ "type": "string",
4055
+ "format": "date"
4056
+ }
4057
+ }
4058
+ },
4059
+ "RisingSearchTrend": {
4060
+ "type": "object",
4061
+ "required": [
4062
+ "tag"
4063
+ ],
4064
+ "properties": {
4065
+ "tag": {
4066
+ "type": "string"
4067
+ }
4068
+ }
4069
+ },
4070
+ "SearchTrendBlacklist": {
4071
+ "type": "object",
4072
+ "required": [
4073
+ "id",
4074
+ "tag",
4075
+ "reason",
4076
+ "creator_id",
4077
+ "created_at",
4078
+ "updated_at"
4079
+ ],
4080
+ "properties": {
4081
+ "id": {
4082
+ "type": "integer"
4083
+ },
4084
+ "tag": {
4085
+ "type": "string"
4086
+ },
4087
+ "reason": {
4088
+ "type": "string"
4089
+ },
4090
+ "creator_id": {
4091
+ "type": "integer"
4092
+ },
4093
+ "created_at": {
4094
+ "type": "string",
4095
+ "format": "date-time"
4096
+ },
4097
+ "updated_at": {
4098
+ "type": "string",
4099
+ "format": "date-time"
4100
+ }
4101
+ }
4102
+ },
4103
+ "MessageErrorResponse": {
4104
+ "type": "object",
4105
+ "required": [
4106
+ "success",
4107
+ "message"
4108
+ ],
4109
+ "properties": {
4110
+ "success": {
4111
+ "type": "boolean"
4112
+ },
4113
+ "message": {
4114
+ "type": "string"
4115
+ },
4116
+ "code": {
4117
+ "type": "string",
4118
+ "nullable": true
4119
+ }
4120
+ }
4121
+ },
4122
+ "MessageSuccessResponse": {
4123
+ "type": "object",
4124
+ "required": [
4125
+ "success",
4126
+ "message"
4127
+ ],
4128
+ "properties": {
4129
+ "success": {
4130
+ "type": "boolean",
4131
+ "enum": [
4132
+ true
4133
+ ]
4134
+ },
4135
+ "message": {
4136
+ "type": "string"
4137
+ }
4138
+ }
4015
4139
  }
4016
4140
  },
4017
4141
  "responses": {
@@ -4065,28 +4189,22 @@
4065
4189
  }
4066
4190
  }
4067
4191
  },
4192
+ "MessageSuccess": {
4193
+ "description": "Success",
4194
+ "content": {
4195
+ "application/json": {
4196
+ "schema": {
4197
+ "$ref": "#/components/schemas/MessageSuccessResponse"
4198
+ }
4199
+ }
4200
+ }
4201
+ },
4068
4202
  "MessageError": {
4069
4203
  "description": "Error",
4070
4204
  "content": {
4071
4205
  "application/json": {
4072
4206
  "schema": {
4073
- "type": "object",
4074
- "required": [
4075
- "success",
4076
- "message"
4077
- ],
4078
- "properties": {
4079
- "success": {
4080
- "type": "boolean"
4081
- },
4082
- "message": {
4083
- "type": "string"
4084
- },
4085
- "code": {
4086
- "type": "string",
4087
- "nullable": true
4088
- }
4089
- }
4207
+ "$ref": "#/components/schemas/MessageErrorResponse"
4090
4208
  }
4091
4209
  }
4092
4210
  }
@@ -4137,13 +4255,13 @@
4137
4255
  "description": "Requires [browser authentication](#operations-Sessions-login) (username & password), as well as hourly password confirmations (reauthentication).",
4138
4256
  "parameters": [
4139
4257
  {
4140
- "$ref": "#/components/parameters/limit"
4258
+ "$ref": "#/components/parameters/limitQuery"
4141
4259
  },
4142
4260
  {
4143
- "$ref": "#/components/parameters/page"
4261
+ "$ref": "#/components/parameters/pageQuery"
4144
4262
  },
4145
4263
  {
4146
- "$ref": "#/components/parameters/id"
4264
+ "$ref": "#/components/parameters/idQuery"
4147
4265
  },
4148
4266
  {
4149
4267
  "name": "search[order]",
@@ -4299,13 +4417,7 @@
4299
4417
  "description": "Requires [browser authentication](#operations-Sessions-login) (username & password), as well as hourly password confirmations (reauthentication).",
4300
4418
  "parameters": [
4301
4419
  {
4302
- "name": "id",
4303
- "in": "path",
4304
- "description": "The ID of the api key.",
4305
- "required": true,
4306
- "schema": {
4307
- "type": "integer"
4308
- }
4420
+ "$ref": "#/components/parameters/idPath"
4309
4421
  }
4310
4422
  ],
4311
4423
  "responses": {
@@ -4337,13 +4449,7 @@
4337
4449
  "description": "Requires [browser authentication](#operations-Sessions-login) (username & password), as well as hourly password confirmations (reauthentication).",
4338
4450
  "parameters": [
4339
4451
  {
4340
- "name": "id",
4341
- "in": "path",
4342
- "description": "The ID of the api key.",
4343
- "required": true,
4344
- "schema": {
4345
- "type": "integer"
4346
- }
4452
+ "$ref": "#/components/parameters/idPath"
4347
4453
  }
4348
4454
  ],
4349
4455
  "requestBody": {
@@ -4393,13 +4499,13 @@
4393
4499
  ],
4394
4500
  "parameters": [
4395
4501
  {
4396
- "$ref": "#/components/parameters/limit"
4502
+ "$ref": "#/components/parameters/limitQuery"
4397
4503
  },
4398
4504
  {
4399
- "$ref": "#/components/parameters/page"
4505
+ "$ref": "#/components/parameters/pageQuery"
4400
4506
  },
4401
4507
  {
4402
- "$ref": "#/components/parameters/id"
4508
+ "$ref": "#/components/parameters/idQuery"
4403
4509
  },
4404
4510
  {
4405
4511
  "name": "search[order]",
@@ -4619,7 +4725,7 @@
4619
4725
  ],
4620
4726
  "parameters": [
4621
4727
  {
4622
- "$ref": "#/components/parameters/idOrName"
4728
+ "$ref": "#/components/parameters/idOrNamePath"
4623
4729
  }
4624
4730
  ],
4625
4731
  "responses": {
@@ -4655,7 +4761,7 @@
4655
4761
  "type": "string"
4656
4762
  },
4657
4763
  {
4658
- "type": "number"
4764
+ "type": "integer"
4659
4765
  }
4660
4766
  ]
4661
4767
  }
@@ -4693,7 +4799,7 @@
4693
4799
  "description": "If an artist is locked, you must be Janitor+ to edit them.\n`other_names` & `urls` are silently truncated to 25 entries.\n`notes` is silently truncated to the wiki page limit (250,000).\nIndividual `other_names` are silently truncated to 100 characters.\nIf an artist is on the avoid posting list, you must have the bd staff user flag to edit name, other_names, or group_name.\n",
4694
4800
  "parameters": [
4695
4801
  {
4696
- "$ref": "#/components/parameters/idOrName"
4802
+ "$ref": "#/components/parameters/idOrNamePath"
4697
4803
  }
4698
4804
  ],
4699
4805
  "requestBody": {
@@ -4767,7 +4873,7 @@
4767
4873
  "description": "You must be an Admin+ to delete an artist.\n",
4768
4874
  "parameters": [
4769
4875
  {
4770
- "$ref": "#/components/parameters/idOrName"
4876
+ "$ref": "#/components/parameters/idOrNamePath"
4771
4877
  }
4772
4878
  ],
4773
4879
  "responses": {
@@ -4798,7 +4904,7 @@
4798
4904
  "description": "If an artist is locked, you must be Janitor+ to revert them.\n",
4799
4905
  "parameters": [
4800
4906
  {
4801
- "$ref": "#/components/parameters/idOrName"
4907
+ "$ref": "#/components/parameters/idOrNamePath"
4802
4908
  },
4803
4909
  {
4804
4910
  "name": "version_id",
@@ -4835,16 +4941,16 @@
4835
4941
  ],
4836
4942
  "parameters": [
4837
4943
  {
4838
- "$ref": "#/components/parameters/limit"
4944
+ "$ref": "#/components/parameters/limitQuery"
4839
4945
  },
4840
4946
  {
4841
- "$ref": "#/components/parameters/page"
4947
+ "$ref": "#/components/parameters/pageQuery"
4842
4948
  },
4843
4949
  {
4844
- "$ref": "#/components/parameters/id"
4950
+ "$ref": "#/components/parameters/idQuery"
4845
4951
  },
4846
4952
  {
4847
- "$ref": "#/components/parameters/ip_addr"
4953
+ "$ref": "#/components/parameters/ipAddrQuery"
4848
4954
  },
4849
4955
  {
4850
4956
  "name": "search[order]",
@@ -4918,13 +5024,13 @@
4918
5024
  ],
4919
5025
  "parameters": [
4920
5026
  {
4921
- "$ref": "#/components/parameters/limit"
5027
+ "$ref": "#/components/parameters/limitQuery"
4922
5028
  },
4923
5029
  {
4924
- "$ref": "#/components/parameters/page"
5030
+ "$ref": "#/components/parameters/pageQuery"
4925
5031
  },
4926
5032
  {
4927
- "$ref": "#/components/parameters/id"
5033
+ "$ref": "#/components/parameters/idQuery"
4928
5034
  },
4929
5035
  {
4930
5036
  "name": "search[order]",
@@ -5063,27 +5169,19 @@
5063
5169
  ],
5064
5170
  "parameters": [
5065
5171
  {
5066
- "$ref": "#/components/parameters/limit"
5172
+ "$ref": "#/components/parameters/limitQuery"
5067
5173
  },
5068
5174
  {
5069
- "$ref": "#/components/parameters/page"
5175
+ "$ref": "#/components/parameters/pageQuery"
5070
5176
  },
5071
5177
  {
5072
- "$ref": "#/components/parameters/id"
5178
+ "$ref": "#/components/parameters/idQuery"
5073
5179
  },
5074
5180
  {
5075
- "$ref": "#/components/parameters/ip_addr"
5181
+ "$ref": "#/components/parameters/ipAddrQuery"
5076
5182
  },
5077
5183
  {
5078
- "name": "search[order]",
5079
- "in": "query",
5080
- "schema": {
5081
- "type": "string",
5082
- "enum": [
5083
- "id_asc",
5084
- "id_desc"
5085
- ]
5086
- }
5184
+ "$ref": "#/components/parameters/orderQuery"
5087
5185
  },
5088
5186
  {
5089
5187
  "name": "search[creator_name]",
@@ -5252,7 +5350,7 @@
5252
5350
  ],
5253
5351
  "parameters": [
5254
5352
  {
5255
- "$ref": "#/components/parameters/idOrName"
5353
+ "$ref": "#/components/parameters/idOrNamePath"
5256
5354
  }
5257
5355
  ],
5258
5356
  "responses": {
@@ -5285,7 +5383,7 @@
5285
5383
  "description": "Must have the bd staff user flag.",
5286
5384
  "parameters": [
5287
5385
  {
5288
- "$ref": "#/components/parameters/idOrName"
5386
+ "$ref": "#/components/parameters/idOrNamePath"
5289
5387
  }
5290
5388
  ],
5291
5389
  "requestBody": {
@@ -5355,7 +5453,7 @@
5355
5453
  "description": "Must have the bd staff user flag.",
5356
5454
  "parameters": [
5357
5455
  {
5358
- "$ref": "#/components/parameters/idOrName"
5456
+ "$ref": "#/components/parameters/idOrNamePath"
5359
5457
  }
5360
5458
  ],
5361
5459
  "responses": {
@@ -5386,7 +5484,7 @@
5386
5484
  "description": "Must have the bd staff user flag.",
5387
5485
  "parameters": [
5388
5486
  {
5389
- "$ref": "#/components/parameters/idOrName"
5487
+ "$ref": "#/components/parameters/idOrNamePath"
5390
5488
  }
5391
5489
  ],
5392
5490
  "responses": {
@@ -5417,7 +5515,7 @@
5417
5515
  "description": "Must have the bd staff user flag.",
5418
5516
  "parameters": [
5419
5517
  {
5420
- "$ref": "#/components/parameters/idOrName"
5518
+ "$ref": "#/components/parameters/idOrNamePath"
5421
5519
  }
5422
5520
  ],
5423
5521
  "responses": {
@@ -5442,28 +5540,19 @@
5442
5540
  ],
5443
5541
  "parameters": [
5444
5542
  {
5445
- "$ref": "#/components/parameters/limit"
5543
+ "$ref": "#/components/parameters/limitQuery"
5446
5544
  },
5447
5545
  {
5448
- "$ref": "#/components/parameters/page"
5546
+ "$ref": "#/components/parameters/pageQuery"
5449
5547
  },
5450
5548
  {
5451
- "$ref": "#/components/parameters/id"
5549
+ "$ref": "#/components/parameters/idQuery"
5452
5550
  },
5453
5551
  {
5454
- "$ref": "#/components/parameters/ip_addr"
5552
+ "$ref": "#/components/parameters/ipAddrQuery"
5455
5553
  },
5456
5554
  {
5457
- "name": "search[order]",
5458
- "in": "query",
5459
- "description": "The order of the results.",
5460
- "schema": {
5461
- "type": "string",
5462
- "enum": [
5463
- "id_asc",
5464
- "id_desc"
5465
- ]
5466
- }
5555
+ "$ref": "#/components/parameters/orderQuery"
5467
5556
  },
5468
5557
  {
5469
5558
  "name": "search[updater_name]",
@@ -5556,13 +5645,13 @@
5556
5645
  ],
5557
5646
  "parameters": [
5558
5647
  {
5559
- "$ref": "#/components/parameters/limit"
5648
+ "$ref": "#/components/parameters/limitQuery"
5560
5649
  },
5561
5650
  {
5562
- "$ref": "#/components/parameters/page"
5651
+ "$ref": "#/components/parameters/pageQuery"
5563
5652
  },
5564
5653
  {
5565
- "$ref": "#/components/parameters/id"
5654
+ "$ref": "#/components/parameters/idQuery"
5566
5655
  },
5567
5656
  {
5568
5657
  "name": "search[order]",
@@ -5652,13 +5741,7 @@
5652
5741
  ],
5653
5742
  "parameters": [
5654
5743
  {
5655
- "name": "id",
5656
- "in": "path",
5657
- "description": "The ID of the ban to get.",
5658
- "required": true,
5659
- "schema": {
5660
- "type": "integer"
5661
- }
5744
+ "$ref": "#/components/parameters/idPath"
5662
5745
  }
5663
5746
  ],
5664
5747
  "responses": {
@@ -5687,16 +5770,16 @@
5687
5770
  ],
5688
5771
  "parameters": [
5689
5772
  {
5690
- "$ref": "#/components/parameters/limit"
5773
+ "$ref": "#/components/parameters/limitQuery"
5691
5774
  },
5692
5775
  {
5693
- "$ref": "#/components/parameters/page"
5776
+ "$ref": "#/components/parameters/pageQuery"
5694
5777
  },
5695
5778
  {
5696
- "$ref": "#/components/parameters/id"
5779
+ "$ref": "#/components/parameters/idQuery"
5697
5780
  },
5698
5781
  {
5699
- "$ref": "#/components/parameters/ip_addr"
5782
+ "$ref": "#/components/parameters/ipAddrQuery"
5700
5783
  },
5701
5784
  {
5702
5785
  "name": "search[order]",
@@ -5819,13 +5902,7 @@
5819
5902
  ],
5820
5903
  "parameters": [
5821
5904
  {
5822
- "name": "id",
5823
- "in": "path",
5824
- "description": "The ID of the blip to get.",
5825
- "required": true,
5826
- "schema": {
5827
- "type": "integer"
5828
- }
5905
+ "$ref": "#/components/parameters/idPath"
5829
5906
  }
5830
5907
  ],
5831
5908
  "responses": {
@@ -5861,13 +5938,7 @@
5861
5938
  "description": "Unless Admin+, blips cannot be edited after 5 minutes. Marked blips cannot be edited.",
5862
5939
  "parameters": [
5863
5940
  {
5864
- "name": "id",
5865
- "in": "path",
5866
- "description": "The ID of the blip.",
5867
- "required": true,
5868
- "schema": {
5869
- "type": "integer"
5870
- }
5941
+ "$ref": "#/components/parameters/idPath"
5871
5942
  }
5872
5943
  ],
5873
5944
  "requestBody": {
@@ -5913,13 +5984,7 @@
5913
5984
  "description": "You must be Admin+.\n",
5914
5985
  "parameters": [
5915
5986
  {
5916
- "name": "id",
5917
- "in": "path",
5918
- "required": true,
5919
- "description": "The ID of the blip.",
5920
- "schema": {
5921
- "type": "integer"
5922
- }
5987
+ "$ref": "#/components/parameters/idPath"
5923
5988
  }
5924
5989
  ],
5925
5990
  "responses": {
@@ -5950,13 +6015,7 @@
5950
6015
  "description": "You must be the creator or Moderator+.\n",
5951
6016
  "parameters": [
5952
6017
  {
5953
- "name": "id",
5954
- "in": "path",
5955
- "required": true,
5956
- "description": "The ID of the blip.",
5957
- "schema": {
5958
- "type": "integer"
5959
- }
6018
+ "$ref": "#/components/parameters/idPath"
5960
6019
  }
5961
6020
  ],
5962
6021
  "responses": {
@@ -5994,13 +6053,7 @@
5994
6053
  "description": "You must be Moderator+.\n",
5995
6054
  "parameters": [
5996
6055
  {
5997
- "name": "id",
5998
- "in": "path",
5999
- "required": true,
6000
- "description": "The ID of the blip.",
6001
- "schema": {
6002
- "type": "integer"
6003
- }
6056
+ "$ref": "#/components/parameters/idPath"
6004
6057
  }
6005
6058
  ],
6006
6059
  "responses": {
@@ -6038,13 +6091,7 @@
6038
6091
  "description": "You must be Moderator+.",
6039
6092
  "parameters": [
6040
6093
  {
6041
- "name": "id",
6042
- "in": "path",
6043
- "required": true,
6044
- "description": "The ID of the blip.",
6045
- "schema": {
6046
- "type": "integer"
6047
- }
6094
+ "$ref": "#/components/parameters/idPath"
6048
6095
  }
6049
6096
  ],
6050
6097
  "requestBody": {
@@ -6079,13 +6126,13 @@
6079
6126
  ],
6080
6127
  "parameters": [
6081
6128
  {
6082
- "$ref": "#/components/parameters/limit"
6129
+ "$ref": "#/components/parameters/limitQuery"
6083
6130
  },
6084
6131
  {
6085
- "$ref": "#/components/parameters/page"
6132
+ "$ref": "#/components/parameters/pageQuery"
6086
6133
  },
6087
6134
  {
6088
- "$ref": "#/components/parameters/id"
6135
+ "$ref": "#/components/parameters/idQuery"
6089
6136
  },
6090
6137
  {
6091
6138
  "name": "search[order]",
@@ -6259,13 +6306,7 @@
6259
6306
  ],
6260
6307
  "parameters": [
6261
6308
  {
6262
- "name": "id",
6263
- "in": "path",
6264
- "required": true,
6265
- "description": "The ID of the bulk update request.",
6266
- "schema": {
6267
- "type": "integer"
6268
- }
6309
+ "$ref": "#/components/parameters/idPath"
6269
6310
  }
6270
6311
  ],
6271
6312
  "responses": {
@@ -6298,13 +6339,7 @@
6298
6339
  "description": "You must be the creator of the BUR, or Admin+.",
6299
6340
  "parameters": [
6300
6341
  {
6301
- "name": "id",
6302
- "in": "path",
6303
- "required": true,
6304
- "description": "The ID of the bulk update request.",
6305
- "schema": {
6306
- "type": "integer"
6307
- }
6342
+ "$ref": "#/components/parameters/idPath"
6308
6343
  }
6309
6344
  ],
6310
6345
  "requestBody": {
@@ -6358,13 +6393,7 @@
6358
6393
  "description": "You must be the creator of the BUR, or Admin+.",
6359
6394
  "parameters": [
6360
6395
  {
6361
- "name": "id",
6362
- "in": "path",
6363
- "required": true,
6364
- "description": "The ID of the bulk update request.",
6365
- "schema": {
6366
- "type": "integer"
6367
- }
6396
+ "$ref": "#/components/parameters/idPath"
6368
6397
  }
6369
6398
  ],
6370
6399
  "responses": {
@@ -6390,13 +6419,7 @@
6390
6419
  "description": "Must be Admin+.",
6391
6420
  "parameters": [
6392
6421
  {
6393
- "name": "id",
6394
- "in": "path",
6395
- "required": true,
6396
- "description": "The ID of the bulk update request.",
6397
- "schema": {
6398
- "type": "integer"
6399
- }
6422
+ "$ref": "#/components/parameters/idPath"
6400
6423
  }
6401
6424
  ],
6402
6425
  "responses": {
@@ -6422,16 +6445,16 @@
6422
6445
  "description": "For searching comments, group_by=comment must be set.",
6423
6446
  "parameters": [
6424
6447
  {
6425
- "$ref": "#/components/parameters/limit"
6448
+ "$ref": "#/components/parameters/limitQuery"
6426
6449
  },
6427
6450
  {
6428
- "$ref": "#/components/parameters/page"
6451
+ "$ref": "#/components/parameters/pageQuery"
6429
6452
  },
6430
6453
  {
6431
- "$ref": "#/components/parameters/id"
6454
+ "$ref": "#/components/parameters/idQuery"
6432
6455
  },
6433
6456
  {
6434
- "$ref": "#/components/parameters/ip_addr"
6457
+ "$ref": "#/components/parameters/ipAddrQuery"
6435
6458
  },
6436
6459
  {
6437
6460
  "name": "search[order]",
@@ -6620,13 +6643,7 @@
6620
6643
  "description": "If the comment is hidden, you must be the creator or Janitor+ to see it.",
6621
6644
  "parameters": [
6622
6645
  {
6623
- "name": "id",
6624
- "in": "path",
6625
- "required": true,
6626
- "description": "The ID of the comment.",
6627
- "schema": {
6628
- "type": "integer"
6629
- }
6646
+ "$ref": "#/components/parameters/idPath"
6630
6647
  }
6631
6648
  ],
6632
6649
  "responses": {
@@ -6662,13 +6679,7 @@
6662
6679
  "description": "You must be the creator of the comment, or Admin+ to edit. Marked comments cannot be edited.\n",
6663
6680
  "parameters": [
6664
6681
  {
6665
- "name": "id",
6666
- "in": "path",
6667
- "required": true,
6668
- "description": "The ID of the comment.",
6669
- "schema": {
6670
- "type": "integer"
6671
- }
6682
+ "$ref": "#/components/parameters/idPath"
6672
6683
  }
6673
6684
  ],
6674
6685
  "requestBody": {
@@ -6722,13 +6733,7 @@
6722
6733
  "description": "You must be Admin+.\n",
6723
6734
  "parameters": [
6724
6735
  {
6725
- "name": "id",
6726
- "in": "path",
6727
- "required": true,
6728
- "description": "The ID of the comment.",
6729
- "schema": {
6730
- "type": "integer"
6731
- }
6736
+ "$ref": "#/components/parameters/idPath"
6732
6737
  }
6733
6738
  ],
6734
6739
  "responses": {
@@ -6759,13 +6764,7 @@
6759
6764
  "description": "You must be the creator or Moderator+.\n",
6760
6765
  "parameters": [
6761
6766
  {
6762
- "name": "id",
6763
- "in": "path",
6764
- "required": true,
6765
- "description": "The ID of the comment.",
6766
- "schema": {
6767
- "type": "integer"
6768
- }
6767
+ "$ref": "#/components/parameters/idPath"
6769
6768
  }
6770
6769
  ],
6771
6770
  "responses": {
@@ -6803,13 +6802,7 @@
6803
6802
  "description": "You must be Moderator+.\n",
6804
6803
  "parameters": [
6805
6804
  {
6806
- "name": "id",
6807
- "in": "path",
6808
- "required": true,
6809
- "description": "The ID of the comment.",
6810
- "schema": {
6811
- "type": "integer"
6812
- }
6805
+ "$ref": "#/components/parameters/idPath"
6813
6806
  }
6814
6807
  ],
6815
6808
  "responses": {
@@ -6847,13 +6840,7 @@
6847
6840
  "description": "You must be Moderator+.",
6848
6841
  "parameters": [
6849
6842
  {
6850
- "name": "id",
6851
- "in": "path",
6852
- "required": true,
6853
- "description": "The ID of the comment.",
6854
- "schema": {
6855
- "type": "integer"
6856
- }
6843
+ "$ref": "#/components/parameters/idPath"
6857
6844
  }
6858
6845
  ],
6859
6846
  "requestBody": {
@@ -6893,13 +6880,7 @@
6893
6880
  ],
6894
6881
  "parameters": [
6895
6882
  {
6896
- "name": "id",
6897
- "in": "path",
6898
- "required": true,
6899
- "description": "The ID of the comment.",
6900
- "schema": {
6901
- "type": "integer"
6902
- }
6883
+ "$ref": "#/components/parameters/idPath"
6903
6884
  },
6904
6885
  {
6905
6886
  "name": "score",
@@ -6968,13 +6949,7 @@
6968
6949
  ],
6969
6950
  "parameters": [
6970
6951
  {
6971
- "name": "id",
6972
- "in": "path",
6973
- "required": true,
6974
- "description": "The ID of the comment.",
6975
- "schema": {
6976
- "type": "integer"
6977
- }
6952
+ "$ref": "#/components/parameters/idPath"
6978
6953
  }
6979
6954
  ],
6980
6955
  "responses": {
@@ -7076,13 +7051,13 @@
7076
7051
  ],
7077
7052
  "parameters": [
7078
7053
  {
7079
- "$ref": "#/components/parameters/limit"
7054
+ "$ref": "#/components/parameters/limitQuery"
7080
7055
  },
7081
7056
  {
7082
- "$ref": "#/components/parameters/page"
7057
+ "$ref": "#/components/parameters/pageQuery"
7083
7058
  },
7084
7059
  {
7085
- "$ref": "#/components/parameters/id"
7060
+ "$ref": "#/components/parameters/idQuery"
7086
7061
  },
7087
7062
  {
7088
7063
  "in": "query",
@@ -7175,13 +7150,7 @@
7175
7150
  "description": "Fetching a dmail will not mark it as read.",
7176
7151
  "parameters": [
7177
7152
  {
7178
- "name": "id",
7179
- "in": "path",
7180
- "required": true,
7181
- "description": "The ID of the dmail.",
7182
- "schema": {
7183
- "type": "integer"
7184
- }
7153
+ "$ref": "#/components/parameters/idPath"
7185
7154
  }
7186
7155
  ],
7187
7156
  "responses": {
@@ -7217,13 +7186,7 @@
7217
7186
  "description": "Deleting simply hides your copy of the dmail.",
7218
7187
  "parameters": [
7219
7188
  {
7220
- "name": "id",
7221
- "in": "path",
7222
- "required": true,
7223
- "description": "The ID of the dmail.",
7224
- "schema": {
7225
- "type": "integer"
7226
- }
7189
+ "$ref": "#/components/parameters/idPath"
7227
7190
  }
7228
7191
  ],
7229
7192
  "responses": {
@@ -7253,13 +7216,7 @@
7253
7216
  ],
7254
7217
  "parameters": [
7255
7218
  {
7256
- "name": "id",
7257
- "in": "path",
7258
- "required": true,
7259
- "description": "The ID of the dmail.",
7260
- "schema": {
7261
- "type": "integer"
7262
- }
7219
+ "$ref": "#/components/parameters/idPath"
7263
7220
  }
7264
7221
  ],
7265
7222
  "responses": {
@@ -7289,13 +7246,7 @@
7289
7246
  ],
7290
7247
  "parameters": [
7291
7248
  {
7292
- "name": "id",
7293
- "in": "path",
7294
- "required": true,
7295
- "description": "The ID of the dmail.",
7296
- "schema": {
7297
- "type": "integer"
7298
- }
7249
+ "$ref": "#/components/parameters/idPath"
7299
7250
  }
7300
7251
  ],
7301
7252
  "responses": {
@@ -7398,27 +7349,19 @@
7398
7349
  "description": "You must be Moderator+.",
7399
7350
  "parameters": [
7400
7351
  {
7401
- "$ref": "#/components/parameters/limit"
7352
+ "$ref": "#/components/parameters/limitQuery"
7402
7353
  },
7403
7354
  {
7404
- "$ref": "#/components/parameters/page"
7355
+ "$ref": "#/components/parameters/pageQuery"
7405
7356
  },
7406
7357
  {
7407
- "$ref": "#/components/parameters/id"
7358
+ "$ref": "#/components/parameters/idQuery"
7408
7359
  },
7409
7360
  {
7410
- "$ref": "#/components/parameters/ip_addr"
7361
+ "$ref": "#/components/parameters/ipAddrQuery"
7411
7362
  },
7412
7363
  {
7413
- "name": "search[order]",
7414
- "in": "query",
7415
- "schema": {
7416
- "type": "string",
7417
- "enum": [
7418
- "id_asc",
7419
- "id_desc"
7420
- ]
7421
- }
7364
+ "$ref": "#/components/parameters/orderQuery"
7422
7365
  },
7423
7366
  {
7424
7367
  "in": "query",
@@ -7503,13 +7446,7 @@
7503
7446
  "description": "You must be Moderator+.",
7504
7447
  "parameters": [
7505
7448
  {
7506
- "name": "id",
7507
- "in": "path",
7508
- "required": true,
7509
- "description": "The versionable id.",
7510
- "schema": {
7511
- "type": "integer"
7512
- }
7449
+ "$ref": "#/components/parameters/idPath"
7513
7450
  },
7514
7451
  {
7515
7452
  "name": "type",
@@ -7555,13 +7492,13 @@
7555
7492
  ],
7556
7493
  "parameters": [
7557
7494
  {
7558
- "$ref": "#/components/parameters/limit"
7495
+ "$ref": "#/components/parameters/limitQuery"
7559
7496
  },
7560
7497
  {
7561
- "$ref": "#/components/parameters/page"
7498
+ "$ref": "#/components/parameters/pageQuery"
7562
7499
  },
7563
7500
  {
7564
- "$ref": "#/components/parameters/id"
7501
+ "$ref": "#/components/parameters/idQuery"
7565
7502
  },
7566
7503
  {
7567
7504
  "name": "search[order]",
@@ -7672,13 +7609,7 @@
7672
7609
  "description": "You must be Admin+.",
7673
7610
  "parameters": [
7674
7611
  {
7675
- "name": "id",
7676
- "in": "path",
7677
- "required": true,
7678
- "description": "The ID of the email blacklist.",
7679
- "schema": {
7680
- "type": "integer"
7681
- }
7612
+ "$ref": "#/components/parameters/idPath"
7682
7613
  }
7683
7614
  ],
7684
7615
  "responses": {
@@ -7703,10 +7634,10 @@
7703
7634
  ],
7704
7635
  "parameters": [
7705
7636
  {
7706
- "$ref": "#/components/parameters/limit"
7637
+ "$ref": "#/components/parameters/limitQuery"
7707
7638
  },
7708
7639
  {
7709
- "$ref": "#/components/parameters/page"
7640
+ "$ref": "#/components/parameters/pageQuery"
7710
7641
  },
7711
7642
  {
7712
7643
  "in": "query",
@@ -7788,10 +7719,10 @@
7788
7719
  ],
7789
7720
  "properties": {
7790
7721
  "post_id": {
7791
- "type": "number"
7722
+ "type": "integer"
7792
7723
  },
7793
7724
  "favorite_count": {
7794
- "type": "number"
7725
+ "type": "integer"
7795
7726
  }
7796
7727
  }
7797
7728
  }
@@ -7824,12 +7755,7 @@
7824
7755
  ],
7825
7756
  "parameters": [
7826
7757
  {
7827
- "name": "id",
7828
- "in": "path",
7829
- "required": true,
7830
- "schema": {
7831
- "type": "integer"
7832
- }
7758
+ "$ref": "#/components/parameters/idPath"
7833
7759
  }
7834
7760
  ],
7835
7761
  "responses": {
@@ -7845,10 +7771,10 @@
7845
7771
  ],
7846
7772
  "properties": {
7847
7773
  "post_id": {
7848
- "type": "number"
7774
+ "type": "integer"
7849
7775
  },
7850
7776
  "favorite_count": {
7851
- "type": "number"
7777
+ "type": "integer"
7852
7778
  }
7853
7779
  }
7854
7780
  }
@@ -7876,24 +7802,16 @@
7876
7802
  ],
7877
7803
  "parameters": [
7878
7804
  {
7879
- "$ref": "#/components/parameters/limit"
7805
+ "$ref": "#/components/parameters/limitQuery"
7880
7806
  },
7881
7807
  {
7882
- "$ref": "#/components/parameters/page"
7808
+ "$ref": "#/components/parameters/pageQuery"
7883
7809
  },
7884
7810
  {
7885
- "$ref": "#/components/parameters/id"
7811
+ "$ref": "#/components/parameters/idQuery"
7886
7812
  },
7887
7813
  {
7888
- "name": "search[order]",
7889
- "in": "query",
7890
- "schema": {
7891
- "type": "string",
7892
- "enum": [
7893
- "id_asc",
7894
- "id_desc"
7895
- ]
7896
- }
7814
+ "$ref": "#/components/parameters/orderQuery"
7897
7815
  },
7898
7816
  {
7899
7817
  "in": "query",
@@ -8023,13 +7941,7 @@
8023
7941
  "description": "If the forum post is hidden, you must be the creator or Moderator+ to see it.",
8024
7942
  "parameters": [
8025
7943
  {
8026
- "name": "id",
8027
- "in": "path",
8028
- "required": true,
8029
- "description": "The ID of the forum post.",
8030
- "schema": {
8031
- "type": "integer"
8032
- }
7944
+ "$ref": "#/components/parameters/idPath"
8033
7945
  }
8034
7946
  ],
8035
7947
  "responses": {
@@ -8065,13 +7977,7 @@
8065
7977
  "description": "You must be the creator of the forum post, or Admin+ to edit. Marked forum posts cannot be edited.",
8066
7978
  "parameters": [
8067
7979
  {
8068
- "name": "id",
8069
- "in": "path",
8070
- "required": true,
8071
- "description": "The ID of the forum post.",
8072
- "schema": {
8073
- "type": "integer"
8074
- }
7980
+ "$ref": "#/components/parameters/idPath"
8075
7981
  }
8076
7982
  ],
8077
7983
  "requestBody": {
@@ -8117,13 +8023,7 @@
8117
8023
  "description": "You must be Admin+.",
8118
8024
  "parameters": [
8119
8025
  {
8120
- "name": "id",
8121
- "in": "path",
8122
- "required": true,
8123
- "description": "The ID of the forum post.",
8124
- "schema": {
8125
- "type": "integer"
8126
- }
8026
+ "$ref": "#/components/parameters/idPath"
8127
8027
  }
8128
8028
  ],
8129
8029
  "responses": {
@@ -8154,13 +8054,7 @@
8154
8054
  "description": "You must be the creator or Moderator+.",
8155
8055
  "parameters": [
8156
8056
  {
8157
- "name": "id",
8158
- "in": "path",
8159
- "required": true,
8160
- "description": "The ID of the forum post.",
8161
- "schema": {
8162
- "type": "integer"
8163
- }
8057
+ "$ref": "#/components/parameters/idPath"
8164
8058
  }
8165
8059
  ],
8166
8060
  "responses": {
@@ -8198,13 +8092,7 @@
8198
8092
  "description": "You must be Moderator+.",
8199
8093
  "parameters": [
8200
8094
  {
8201
- "name": "id",
8202
- "in": "path",
8203
- "required": true,
8204
- "description": "The ID of the forum post.",
8205
- "schema": {
8206
- "type": "integer"
8207
- }
8095
+ "$ref": "#/components/parameters/idPath"
8208
8096
  }
8209
8097
  ],
8210
8098
  "responses": {
@@ -8242,13 +8130,7 @@
8242
8130
  "description": "You must be Moderator+.\n",
8243
8131
  "parameters": [
8244
8132
  {
8245
- "name": "id",
8246
- "in": "path",
8247
- "required": true,
8248
- "description": "The ID of the forum post.",
8249
- "schema": {
8250
- "type": "integer"
8251
- }
8133
+ "$ref": "#/components/parameters/idPath"
8252
8134
  }
8253
8135
  ],
8254
8136
  "requestBody": {
@@ -8288,13 +8170,7 @@
8288
8170
  ],
8289
8171
  "parameters": [
8290
8172
  {
8291
- "name": "id",
8292
- "in": "path",
8293
- "required": true,
8294
- "description": "The ID of the forum post.",
8295
- "schema": {
8296
- "type": "integer"
8297
- }
8173
+ "$ref": "#/components/parameters/idPath"
8298
8174
  }
8299
8175
  ],
8300
8176
  "requestBody": {
@@ -8354,13 +8230,7 @@
8354
8230
  ],
8355
8231
  "parameters": [
8356
8232
  {
8357
- "name": "id",
8358
- "in": "path",
8359
- "required": true,
8360
- "description": "The ID of the forum post.",
8361
- "schema": {
8362
- "type": "integer"
8363
- }
8233
+ "$ref": "#/components/parameters/idPath"
8364
8234
  }
8365
8235
  ],
8366
8236
  "responses": {
@@ -8388,13 +8258,13 @@
8388
8258
  ],
8389
8259
  "parameters": [
8390
8260
  {
8391
- "$ref": "#/components/parameters/limit"
8261
+ "$ref": "#/components/parameters/limitQuery"
8392
8262
  },
8393
8263
  {
8394
- "$ref": "#/components/parameters/page"
8264
+ "$ref": "#/components/parameters/pageQuery"
8395
8265
  },
8396
8266
  {
8397
- "$ref": "#/components/parameters/id"
8267
+ "$ref": "#/components/parameters/idQuery"
8398
8268
  },
8399
8269
  {
8400
8270
  "name": "search[order]",
@@ -8545,13 +8415,7 @@
8545
8415
  "description": "If the forum topic is hidden, you must be the creator or Moderator+ to see it.",
8546
8416
  "parameters": [
8547
8417
  {
8548
- "name": "id",
8549
- "in": "path",
8550
- "required": true,
8551
- "description": "The ID of the forum topic.",
8552
- "schema": {
8553
- "type": "integer"
8554
- }
8418
+ "$ref": "#/components/parameters/idPath"
8555
8419
  }
8556
8420
  ],
8557
8421
  "responses": {
@@ -8586,13 +8450,7 @@
8586
8450
  ],
8587
8451
  "parameters": [
8588
8452
  {
8589
- "name": "id",
8590
- "in": "path",
8591
- "required": true,
8592
- "description": "The ID of the forum topic.",
8593
- "schema": {
8594
- "type": "integer"
8595
- }
8453
+ "$ref": "#/components/parameters/idPath"
8596
8454
  }
8597
8455
  ],
8598
8456
  "requestBody": {
@@ -8657,13 +8515,7 @@
8657
8515
  "description": "You must be Admin+.",
8658
8516
  "parameters": [
8659
8517
  {
8660
- "name": "id",
8661
- "in": "path",
8662
- "required": true,
8663
- "description": "The ID of the forum topic.",
8664
- "schema": {
8665
- "type": "integer"
8666
- }
8518
+ "$ref": "#/components/parameters/idPath"
8667
8519
  }
8668
8520
  ],
8669
8521
  "responses": {
@@ -8694,13 +8546,7 @@
8694
8546
  "description": "You must be the creator or Moderator+.",
8695
8547
  "parameters": [
8696
8548
  {
8697
- "name": "id",
8698
- "in": "path",
8699
- "required": true,
8700
- "description": "The ID of the forum topic.",
8701
- "schema": {
8702
- "type": "integer"
8703
- }
8549
+ "$ref": "#/components/parameters/idPath"
8704
8550
  }
8705
8551
  ],
8706
8552
  "responses": {
@@ -8738,13 +8584,7 @@
8738
8584
  "description": "You must be Moderator+.",
8739
8585
  "parameters": [
8740
8586
  {
8741
- "name": "id",
8742
- "in": "path",
8743
- "required": true,
8744
- "description": "The ID of the forum topic.",
8745
- "schema": {
8746
- "type": "integer"
8747
- }
8587
+ "$ref": "#/components/parameters/idPath"
8748
8588
  }
8749
8589
  ],
8750
8590
  "responses": {
@@ -8781,13 +8621,7 @@
8781
8621
  ],
8782
8622
  "parameters": [
8783
8623
  {
8784
- "name": "id",
8785
- "in": "path",
8786
- "required": true,
8787
- "description": "The ID of the forum topic.",
8788
- "schema": {
8789
- "type": "integer"
8790
- }
8624
+ "$ref": "#/components/parameters/idPath"
8791
8625
  }
8792
8626
  ],
8793
8627
  "responses": {
@@ -8824,13 +8658,7 @@
8824
8658
  ],
8825
8659
  "parameters": [
8826
8660
  {
8827
- "name": "id",
8828
- "in": "path",
8829
- "required": true,
8830
- "description": "The ID of the forum topic.",
8831
- "schema": {
8832
- "type": "integer"
8833
- }
8661
+ "$ref": "#/components/parameters/idPath"
8834
8662
  }
8835
8663
  ],
8836
8664
  "responses": {
@@ -8988,7 +8816,6 @@
8988
8816
  "name": "id",
8989
8817
  "in": "path",
8990
8818
  "required": true,
8991
- "description": "The ID or name of the help page.",
8992
8819
  "schema": {
8993
8820
  "oneOf": [
8994
8821
  {
@@ -8998,7 +8825,8 @@
8998
8825
  "type": "string"
8999
8826
  }
9000
8827
  ]
9001
- }
8828
+ },
8829
+ "description": "An ID that can be either an integer or a name."
9002
8830
  }
9003
8831
  ],
9004
8832
  "responses": {
@@ -9034,13 +8862,7 @@
9034
8862
  "description": "You must be Admin+",
9035
8863
  "parameters": [
9036
8864
  {
9037
- "name": "id",
9038
- "in": "path",
9039
- "required": true,
9040
- "description": "The ID of the help page.",
9041
- "schema": {
9042
- "type": "integer"
9043
- }
8865
+ "$ref": "#/components/parameters/idPath"
9044
8866
  }
9045
8867
  ],
9046
8868
  "requestBody": {
@@ -9096,13 +8918,7 @@
9096
8918
  "description": "You must be Admin+.",
9097
8919
  "parameters": [
9098
8920
  {
9099
- "name": "id",
9100
- "in": "path",
9101
- "required": true,
9102
- "description": "The ID of the help page.",
9103
- "schema": {
9104
- "type": "integer"
9105
- }
8921
+ "$ref": "#/components/parameters/idPath"
9106
8922
  }
9107
8923
  ],
9108
8924
  "responses": {
@@ -9132,27 +8948,19 @@
9132
8948
  ],
9133
8949
  "parameters": [
9134
8950
  {
9135
- "$ref": "#/components/parameters/limit"
8951
+ "$ref": "#/components/parameters/limitQuery"
9136
8952
  },
9137
8953
  {
9138
- "$ref": "#/components/parameters/page"
8954
+ "$ref": "#/components/parameters/pageQuery"
9139
8955
  },
9140
8956
  {
9141
- "$ref": "#/components/parameters/id"
8957
+ "$ref": "#/components/parameters/idQuery"
9142
8958
  },
9143
8959
  {
9144
- "$ref": "#/components/parameters/ip_addr"
8960
+ "$ref": "#/components/parameters/ipAddrQuery"
9145
8961
  },
9146
8962
  {
9147
- "name": "search[order]",
9148
- "in": "query",
9149
- "schema": {
9150
- "type": "string",
9151
- "enum": [
9152
- "id_asc",
9153
- "id_desc"
9154
- ]
9155
- }
8963
+ "$ref": "#/components/parameters/orderQuery"
9156
8964
  },
9157
8965
  {
9158
8966
  "in": "query",
@@ -9260,13 +9068,7 @@
9260
9068
  "description": "You must be Admin+.",
9261
9069
  "parameters": [
9262
9070
  {
9263
- "name": "id",
9264
- "in": "path",
9265
- "required": true,
9266
- "description": "The ID of the ip ban.",
9267
- "schema": {
9268
- "type": "integer"
9269
- }
9071
+ "$ref": "#/components/parameters/idPath"
9270
9072
  }
9271
9073
  ],
9272
9074
  "responses": {
@@ -9294,7 +9096,7 @@
9294
9096
  "name": "search[score_cutoff]",
9295
9097
  "in": "query",
9296
9098
  "schema": {
9297
- "type": "number"
9099
+ "type": "integer"
9298
9100
  }
9299
9101
  },
9300
9102
  {
@@ -9355,7 +9157,7 @@
9355
9157
  "format": "binary"
9356
9158
  },
9357
9159
  "search[score_cutoff]": {
9358
- "type": "number"
9160
+ "type": "integer"
9359
9161
  },
9360
9162
  "search[url]": {
9361
9163
  "type": "string"
@@ -9419,13 +9221,13 @@
9419
9221
  ],
9420
9222
  "parameters": [
9421
9223
  {
9422
- "$ref": "#/components/parameters/limit"
9224
+ "$ref": "#/components/parameters/limitQuery"
9423
9225
  },
9424
9226
  {
9425
- "$ref": "#/components/parameters/page"
9227
+ "$ref": "#/components/parameters/pageQuery"
9426
9228
  },
9427
9229
  {
9428
- "$ref": "#/components/parameters/id"
9230
+ "$ref": "#/components/parameters/idQuery"
9429
9231
  }
9430
9232
  ],
9431
9233
  "responses": {
@@ -9535,13 +9337,7 @@
9535
9337
  "description": "You must be Admin+.",
9536
9338
  "parameters": [
9537
9339
  {
9538
- "name": "id",
9539
- "in": "path",
9540
- "required": true,
9541
- "description": "The ID of the mascot.",
9542
- "schema": {
9543
- "type": "integer"
9544
- }
9340
+ "$ref": "#/components/parameters/idPath"
9545
9341
  }
9546
9342
  ],
9547
9343
  "requestBody": {
@@ -9610,13 +9406,7 @@
9610
9406
  "description": "You must be Admin+.",
9611
9407
  "parameters": [
9612
9408
  {
9613
- "name": "id",
9614
- "in": "path",
9615
- "required": true,
9616
- "description": "The ID of the mascot.",
9617
- "schema": {
9618
- "type": "integer"
9619
- }
9409
+ "$ref": "#/components/parameters/idPath"
9620
9410
  }
9621
9411
  ],
9622
9412
  "responses": {
@@ -9642,13 +9432,13 @@
9642
9432
  "description": "Note that some mod actions are not in use anymore. Their entries exist for historical purposes only.<br>\nThe current legacy actions are as follows:<br>\n* `created_positive_record`, `created_neutral_record`, `created_negative_record`\n* `created_flag_reason`, `edited_flag_reason`, `deleted_flag_reason`\n* `post_move_favorites`, `post_delete`, `post_undelete`, `post_destroy`, `post_rating_lock`, `post_unapprove`\n* `post_replacement_accept`, `post_replacement_reject`, `post_replacement_delete`\n",
9643
9433
  "parameters": [
9644
9434
  {
9645
- "$ref": "#/components/parameters/limit"
9435
+ "$ref": "#/components/parameters/limitQuery"
9646
9436
  },
9647
9437
  {
9648
- "$ref": "#/components/parameters/page"
9438
+ "$ref": "#/components/parameters/pageQuery"
9649
9439
  },
9650
9440
  {
9651
- "$ref": "#/components/parameters/id"
9441
+ "$ref": "#/components/parameters/idQuery"
9652
9442
  },
9653
9443
  {
9654
9444
  "name": "search[order]",
@@ -9709,13 +9499,7 @@
9709
9499
  ],
9710
9500
  "parameters": [
9711
9501
  {
9712
- "name": "id",
9713
- "in": "path",
9714
- "required": true,
9715
- "description": "The ID of the mod action.",
9716
- "schema": {
9717
- "type": "integer"
9718
- }
9502
+ "$ref": "#/components/parameters/idPath"
9719
9503
  }
9720
9504
  ],
9721
9505
  "responses": {
@@ -9747,10 +9531,10 @@
9747
9531
  ],
9748
9532
  "parameters": [
9749
9533
  {
9750
- "$ref": "#/components/parameters/limit"
9534
+ "$ref": "#/components/parameters/limitQuery"
9751
9535
  },
9752
9536
  {
9753
- "$ref": "#/components/parameters/page"
9537
+ "$ref": "#/components/parameters/pageQuery"
9754
9538
  }
9755
9539
  ],
9756
9540
  "responses": {
@@ -9833,13 +9617,7 @@
9833
9617
  "description": "You must be Admin+",
9834
9618
  "parameters": [
9835
9619
  {
9836
- "name": "id",
9837
- "in": "path",
9838
- "required": true,
9839
- "description": "The ID of the news update.",
9840
- "schema": {
9841
- "type": "integer"
9842
- }
9620
+ "$ref": "#/components/parameters/idPath"
9843
9621
  }
9844
9622
  ],
9845
9623
  "requestBody": {
@@ -9888,13 +9666,7 @@
9888
9666
  "description": "You must be Admin+.",
9889
9667
  "parameters": [
9890
9668
  {
9891
- "name": "id",
9892
- "in": "path",
9893
- "required": true,
9894
- "description": "The ID of the news update.",
9895
- "schema": {
9896
- "type": "integer"
9897
- }
9669
+ "$ref": "#/components/parameters/idPath"
9898
9670
  }
9899
9671
  ],
9900
9672
  "responses": {
@@ -9919,24 +9691,16 @@
9919
9691
  ],
9920
9692
  "parameters": [
9921
9693
  {
9922
- "$ref": "#/components/parameters/limit"
9694
+ "$ref": "#/components/parameters/limitQuery"
9923
9695
  },
9924
9696
  {
9925
- "$ref": "#/components/parameters/page"
9697
+ "$ref": "#/components/parameters/pageQuery"
9926
9698
  },
9927
9699
  {
9928
- "$ref": "#/components/parameters/id"
9700
+ "$ref": "#/components/parameters/idQuery"
9929
9701
  },
9930
9702
  {
9931
- "name": "search[order]",
9932
- "in": "query",
9933
- "schema": {
9934
- "type": "string",
9935
- "enum": [
9936
- "id_asc",
9937
- "id_desc"
9938
- ]
9939
- }
9703
+ "$ref": "#/components/parameters/orderQuery"
9940
9704
  },
9941
9705
  {
9942
9706
  "in": "query",
@@ -10108,13 +9872,7 @@
10108
9872
  ],
10109
9873
  "parameters": [
10110
9874
  {
10111
- "name": "id",
10112
- "in": "path",
10113
- "required": true,
10114
- "description": "The ID of the note.",
10115
- "schema": {
10116
- "type": "integer"
10117
- }
9875
+ "$ref": "#/components/parameters/idPath"
10118
9876
  }
10119
9877
  ],
10120
9878
  "responses": {
@@ -10146,13 +9904,7 @@
10146
9904
  ],
10147
9905
  "parameters": [
10148
9906
  {
10149
- "name": "id",
10150
- "in": "path",
10151
- "required": true,
10152
- "description": "The ID of the note.",
10153
- "schema": {
10154
- "type": "integer"
10155
- }
9907
+ "$ref": "#/components/parameters/idPath"
10156
9908
  }
10157
9909
  ],
10158
9910
  "requestBody": {
@@ -10209,13 +9961,7 @@
10209
9961
  ],
10210
9962
  "parameters": [
10211
9963
  {
10212
- "name": "id",
10213
- "in": "path",
10214
- "required": true,
10215
- "description": "The ID of the note.",
10216
- "schema": {
10217
- "type": "integer"
10218
- }
9964
+ "$ref": "#/components/parameters/idPath"
10219
9965
  }
10220
9966
  ],
10221
9967
  "responses": {
@@ -10245,13 +9991,7 @@
10245
9991
  ],
10246
9992
  "parameters": [
10247
9993
  {
10248
- "name": "id",
10249
- "in": "path",
10250
- "required": true,
10251
- "description": "The ID of the note.",
10252
- "schema": {
10253
- "type": "integer"
10254
- }
9994
+ "$ref": "#/components/parameters/idPath"
10255
9995
  },
10256
9996
  {
10257
9997
  "name": "version_id",
@@ -10288,28 +10028,19 @@
10288
10028
  ],
10289
10029
  "parameters": [
10290
10030
  {
10291
- "$ref": "#/components/parameters/limit"
10031
+ "$ref": "#/components/parameters/limitQuery"
10292
10032
  },
10293
10033
  {
10294
- "$ref": "#/components/parameters/page"
10034
+ "$ref": "#/components/parameters/pageQuery"
10295
10035
  },
10296
10036
  {
10297
- "$ref": "#/components/parameters/id"
10037
+ "$ref": "#/components/parameters/idQuery"
10298
10038
  },
10299
10039
  {
10300
- "$ref": "#/components/parameters/ip_addr"
10040
+ "$ref": "#/components/parameters/ipAddrQuery"
10301
10041
  },
10302
10042
  {
10303
- "name": "search[order]",
10304
- "in": "query",
10305
- "description": "The order of the results.",
10306
- "schema": {
10307
- "type": "string",
10308
- "enum": [
10309
- "id_asc",
10310
- "id_desc"
10311
- ]
10312
- }
10043
+ "$ref": "#/components/parameters/orderQuery"
10313
10044
  },
10314
10045
  {
10315
10046
  "in": "query",
@@ -10380,13 +10111,13 @@
10380
10111
  ],
10381
10112
  "parameters": [
10382
10113
  {
10383
- "$ref": "#/components/parameters/limit"
10114
+ "$ref": "#/components/parameters/limitQuery"
10384
10115
  },
10385
10116
  {
10386
- "$ref": "#/components/parameters/page"
10117
+ "$ref": "#/components/parameters/pageQuery"
10387
10118
  },
10388
10119
  {
10389
- "$ref": "#/components/parameters/id"
10120
+ "$ref": "#/components/parameters/idQuery"
10390
10121
  },
10391
10122
  {
10392
10123
  "name": "search[order]",
@@ -10538,13 +10269,7 @@
10538
10269
  ],
10539
10270
  "parameters": [
10540
10271
  {
10541
- "name": "id",
10542
- "in": "path",
10543
- "required": true,
10544
- "description": "The ID of the pool.",
10545
- "schema": {
10546
- "type": "integer"
10547
- }
10272
+ "$ref": "#/components/parameters/idPath"
10548
10273
  }
10549
10274
  ],
10550
10275
  "responses": {
@@ -10576,13 +10301,7 @@
10576
10301
  ],
10577
10302
  "parameters": [
10578
10303
  {
10579
- "name": "id",
10580
- "in": "path",
10581
- "required": true,
10582
- "description": "The ID of the pool.",
10583
- "schema": {
10584
- "type": "integer"
10585
- }
10304
+ "$ref": "#/components/parameters/idPath"
10586
10305
  }
10587
10306
  ],
10588
10307
  "requestBody": {
@@ -10648,13 +10367,7 @@
10648
10367
  ],
10649
10368
  "parameters": [
10650
10369
  {
10651
- "name": "id",
10652
- "in": "path",
10653
- "required": true,
10654
- "description": "The ID of the pool.",
10655
- "schema": {
10656
- "type": "integer"
10657
- }
10370
+ "$ref": "#/components/parameters/idPath"
10658
10371
  }
10659
10372
  ],
10660
10373
  "responses": {
@@ -10684,13 +10397,7 @@
10684
10397
  ],
10685
10398
  "parameters": [
10686
10399
  {
10687
- "name": "id",
10688
- "in": "path",
10689
- "required": true,
10690
- "description": "The ID of the pool.",
10691
- "schema": {
10692
- "type": "integer"
10693
- }
10400
+ "$ref": "#/components/parameters/idPath"
10694
10401
  },
10695
10402
  {
10696
10403
  "name": "version_id",
@@ -10892,28 +10599,19 @@
10892
10599
  ],
10893
10600
  "parameters": [
10894
10601
  {
10895
- "$ref": "#/components/parameters/limit"
10602
+ "$ref": "#/components/parameters/limitQuery"
10896
10603
  },
10897
10604
  {
10898
- "$ref": "#/components/parameters/page"
10605
+ "$ref": "#/components/parameters/pageQuery"
10899
10606
  },
10900
10607
  {
10901
- "$ref": "#/components/parameters/id"
10608
+ "$ref": "#/components/parameters/idQuery"
10902
10609
  },
10903
10610
  {
10904
- "$ref": "#/components/parameters/ip_addr"
10611
+ "$ref": "#/components/parameters/ipAddrQuery"
10905
10612
  },
10906
10613
  {
10907
- "name": "search[order]",
10908
- "in": "query",
10909
- "description": "The order of the results.",
10910
- "schema": {
10911
- "type": "string",
10912
- "enum": [
10913
- "id_asc",
10914
- "id_desc"
10915
- ]
10916
- }
10614
+ "$ref": "#/components/parameters/orderQuery"
10917
10615
  },
10918
10616
  {
10919
10617
  "in": "query",
@@ -10963,7 +10661,7 @@
10963
10661
  ],
10964
10662
  "parameters": [
10965
10663
  {
10966
- "$ref": "#/components/parameters/limit"
10664
+ "$ref": "#/components/parameters/limitQuery"
10967
10665
  },
10968
10666
  {
10969
10667
  "name": "date",
@@ -11022,10 +10720,10 @@
11022
10720
  ],
11023
10721
  "parameters": [
11024
10722
  {
11025
- "$ref": "#/components/parameters/limit"
10723
+ "$ref": "#/components/parameters/limitQuery"
11026
10724
  },
11027
10725
  {
11028
- "$ref": "#/components/parameters/page"
10726
+ "$ref": "#/components/parameters/pageQuery"
11029
10727
  },
11030
10728
  {
11031
10729
  "in": "query",
@@ -11124,13 +10822,7 @@
11124
10822
  ],
11125
10823
  "parameters": [
11126
10824
  {
11127
- "name": "id",
11128
- "in": "path",
11129
- "required": true,
11130
- "description": "The ID of the post.",
11131
- "schema": {
11132
- "type": "integer"
11133
- }
10825
+ "$ref": "#/components/parameters/idPath"
11134
10826
  }
11135
10827
  ],
11136
10828
  "responses": {
@@ -11171,13 +10863,7 @@
11171
10863
  "description": "Most errors are silently swallowed.",
11172
10864
  "parameters": [
11173
10865
  {
11174
- "name": "id",
11175
- "in": "path",
11176
- "required": true,
11177
- "description": "The ID of the post.",
11178
- "schema": {
11179
- "type": "integer"
11180
- }
10866
+ "$ref": "#/components/parameters/idPath"
11181
10867
  }
11182
10868
  ],
11183
10869
  "requestBody": {
@@ -11310,13 +10996,7 @@
11310
10996
  "description": "You must be Admin+.",
11311
10997
  "parameters": [
11312
10998
  {
11313
- "name": "id",
11314
- "in": "path",
11315
- "required": true,
11316
- "description": "The ID of the post.",
11317
- "schema": {
11318
- "type": "integer"
11319
- }
10999
+ "$ref": "#/components/parameters/idPath"
11320
11000
  }
11321
11001
  ],
11322
11002
  "responses": {
@@ -11365,13 +11045,7 @@
11365
11045
  "description": "Will error if no body is provided.",
11366
11046
  "parameters": [
11367
11047
  {
11368
- "name": "id",
11369
- "in": "path",
11370
- "required": true,
11371
- "description": "The ID of the post.",
11372
- "schema": {
11373
- "type": "integer"
11374
- }
11048
+ "$ref": "#/components/parameters/idPath"
11375
11049
  }
11376
11050
  ],
11377
11051
  "requestBody": {
@@ -11436,13 +11110,7 @@
11436
11110
  ],
11437
11111
  "parameters": [
11438
11112
  {
11439
- "name": "id",
11440
- "in": "path",
11441
- "required": true,
11442
- "description": "The ID of the post.",
11443
- "schema": {
11444
- "type": "integer"
11445
- }
11113
+ "$ref": "#/components/parameters/idPath"
11446
11114
  }
11447
11115
  ],
11448
11116
  "requestBody": {
@@ -11492,13 +11160,7 @@
11492
11160
  ],
11493
11161
  "parameters": [
11494
11162
  {
11495
- "name": "id",
11496
- "in": "path",
11497
- "required": true,
11498
- "description": "The ID of the post.",
11499
- "schema": {
11500
- "type": "integer"
11501
- }
11163
+ "$ref": "#/components/parameters/idPath"
11502
11164
  },
11503
11165
  {
11504
11166
  "name": "version_id",
@@ -11535,13 +11197,7 @@
11535
11197
  ],
11536
11198
  "parameters": [
11537
11199
  {
11538
- "name": "id",
11539
- "in": "path",
11540
- "required": true,
11541
- "description": "The ID of the post.",
11542
- "schema": {
11543
- "type": "integer"
11544
- }
11200
+ "$ref": "#/components/parameters/idPath"
11545
11201
  },
11546
11202
  {
11547
11203
  "name": "seq",
@@ -11602,13 +11258,7 @@
11602
11258
  ],
11603
11259
  "parameters": [
11604
11260
  {
11605
- "name": "id",
11606
- "in": "path",
11607
- "required": true,
11608
- "description": "The ID of the post.",
11609
- "schema": {
11610
- "type": "integer"
11611
- }
11261
+ "$ref": "#/components/parameters/idPath"
11612
11262
  }
11613
11263
  ],
11614
11264
  "requestBody": {
@@ -11648,13 +11298,7 @@
11648
11298
  ],
11649
11299
  "parameters": [
11650
11300
  {
11651
- "name": "id",
11652
- "in": "path",
11653
- "required": true,
11654
- "description": "The ID of the post.",
11655
- "schema": {
11656
- "type": "integer"
11657
- }
11301
+ "$ref": "#/components/parameters/idPath"
11658
11302
  },
11659
11303
  {
11660
11304
  "name": "limit",
@@ -11667,7 +11311,7 @@
11667
11311
  }
11668
11312
  },
11669
11313
  {
11670
- "$ref": "#/components/parameters/page"
11314
+ "$ref": "#/components/parameters/pageQuery"
11671
11315
  }
11672
11316
  ],
11673
11317
  "description": "You must be the user or Moderator+ to see users that have their favorites hidden.",
@@ -11708,13 +11352,7 @@
11708
11352
  ],
11709
11353
  "parameters": [
11710
11354
  {
11711
- "name": "id",
11712
- "in": "path",
11713
- "required": true,
11714
- "description": "The ID of the post.",
11715
- "schema": {
11716
- "type": "integer"
11717
- }
11355
+ "$ref": "#/components/parameters/idPath"
11718
11356
  },
11719
11357
  {
11720
11358
  "name": "score",
@@ -11791,13 +11429,7 @@
11791
11429
  ],
11792
11430
  "parameters": [
11793
11431
  {
11794
- "name": "id",
11795
- "in": "path",
11796
- "required": true,
11797
- "description": "The ID of the post.",
11798
- "schema": {
11799
- "type": "integer"
11800
- }
11432
+ "$ref": "#/components/parameters/idPath"
11801
11433
  }
11802
11434
  ],
11803
11435
  "responses": {
@@ -11825,13 +11457,13 @@
11825
11457
  ],
11826
11458
  "parameters": [
11827
11459
  {
11828
- "$ref": "#/components/parameters/limit"
11460
+ "$ref": "#/components/parameters/limitQuery"
11829
11461
  },
11830
11462
  {
11831
- "$ref": "#/components/parameters/page"
11463
+ "$ref": "#/components/parameters/pageQuery"
11832
11464
  },
11833
11465
  {
11834
- "$ref": "#/components/parameters/id"
11466
+ "$ref": "#/components/parameters/idQuery"
11835
11467
  },
11836
11468
  {
11837
11469
  "name": "search[order]",
@@ -11989,13 +11621,7 @@
11989
11621
  "description": "You must be Moderator+ if the set is not public.",
11990
11622
  "parameters": [
11991
11623
  {
11992
- "name": "id",
11993
- "in": "path",
11994
- "required": true,
11995
- "description": "The ID of the post set.",
11996
- "schema": {
11997
- "type": "integer"
11998
- }
11624
+ "$ref": "#/components/parameters/idPath"
11999
11625
  }
12000
11626
  ],
12001
11627
  "responses": {
@@ -12031,13 +11657,7 @@
12031
11657
  "description": "You must be the owner of the set, or Admin+.",
12032
11658
  "parameters": [
12033
11659
  {
12034
- "name": "id",
12035
- "in": "path",
12036
- "required": true,
12037
- "description": "The ID of the post sets.",
12038
- "schema": {
12039
- "type": "integer"
12040
- }
11660
+ "$ref": "#/components/parameters/idPath"
12041
11661
  }
12042
11662
  ],
12043
11663
  "requestBody": {
@@ -12095,13 +11715,7 @@
12095
11715
  "description": "You must be the owner of the set, or Admin+.",
12096
11716
  "parameters": [
12097
11717
  {
12098
- "name": "id",
12099
- "in": "path",
12100
- "required": true,
12101
- "description": "The ID of the post set.",
12102
- "schema": {
12103
- "type": "integer"
12104
- }
11718
+ "$ref": "#/components/parameters/idPath"
12105
11719
  }
12106
11720
  ],
12107
11721
  "responses": {
@@ -12132,13 +11746,7 @@
12132
11746
  "description": "You must be the owner of the set, a maintainer (if public), or Admin+.",
12133
11747
  "parameters": [
12134
11748
  {
12135
- "name": "id",
12136
- "in": "path",
12137
- "required": true,
12138
- "description": "The ID of the post set.",
12139
- "schema": {
12140
- "type": "integer"
12141
- }
11749
+ "$ref": "#/components/parameters/idPath"
12142
11750
  }
12143
11751
  ],
12144
11752
  "requestBody": {
@@ -12196,13 +11804,7 @@
12196
11804
  "description": "You must be the owner of the set, a maintainer (if public), or Admin+.",
12197
11805
  "parameters": [
12198
11806
  {
12199
- "name": "id",
12200
- "in": "path",
12201
- "required": true,
12202
- "description": "The ID of the post set.",
12203
- "schema": {
12204
- "type": "integer"
12205
- }
11807
+ "$ref": "#/components/parameters/idPath"
12206
11808
  }
12207
11809
  ],
12208
11810
  "requestBody": {
@@ -12264,13 +11866,7 @@
12264
11866
  "description": "You must be the owner of the set, a maintainer (if public), or Admin+.",
12265
11867
  "parameters": [
12266
11868
  {
12267
- "name": "id",
12268
- "in": "path",
12269
- "required": true,
12270
- "description": "The ID of the post set.",
12271
- "schema": {
12272
- "type": "integer"
12273
- }
11869
+ "$ref": "#/components/parameters/idPath"
12274
11870
  }
12275
11871
  ],
12276
11872
  "requestBody": {
@@ -12346,8 +11942,14 @@
12346
11942
  "type": "string"
12347
11943
  },
12348
11944
  {
12349
- "type": "number"
11945
+ "type": "integer"
12350
11946
  }
11947
+ ],
11948
+ "example": [
11949
+ [
11950
+ "my_set",
11951
+ 1
11952
+ ]
12351
11953
  ]
12352
11954
  }
12353
11955
  },
@@ -12359,8 +11961,14 @@
12359
11961
  "type": "string"
12360
11962
  },
12361
11963
  {
12362
- "type": "number"
11964
+ "type": "integer"
12363
11965
  }
11966
+ ],
11967
+ "example": [
11968
+ [
11969
+ "my_set",
11970
+ 1
11971
+ ]
12364
11972
  ]
12365
11973
  }
12366
11974
  }
@@ -12387,24 +11995,16 @@
12387
11995
  ],
12388
11996
  "parameters": [
12389
11997
  {
12390
- "$ref": "#/components/parameters/limit"
11998
+ "$ref": "#/components/parameters/limitQuery"
12391
11999
  },
12392
12000
  {
12393
- "$ref": "#/components/parameters/page"
12001
+ "$ref": "#/components/parameters/pageQuery"
12394
12002
  },
12395
12003
  {
12396
- "$ref": "#/components/parameters/id"
12004
+ "$ref": "#/components/parameters/idQuery"
12397
12005
  },
12398
12006
  {
12399
- "name": "search[order]",
12400
- "in": "query",
12401
- "schema": {
12402
- "type": "string",
12403
- "enum": [
12404
- "id_asc",
12405
- "id_desc"
12406
- ]
12407
- }
12007
+ "$ref": "#/components/parameters/orderQuery"
12408
12008
  },
12409
12009
  {
12410
12010
  "name": "search[post_tags_match]",
@@ -12466,24 +12066,16 @@
12466
12066
  ],
12467
12067
  "parameters": [
12468
12068
  {
12469
- "$ref": "#/components/parameters/limit"
12069
+ "$ref": "#/components/parameters/limitQuery"
12470
12070
  },
12471
12071
  {
12472
- "$ref": "#/components/parameters/page"
12072
+ "$ref": "#/components/parameters/pageQuery"
12473
12073
  },
12474
12074
  {
12475
- "$ref": "#/components/parameters/id"
12075
+ "$ref": "#/components/parameters/idQuery"
12476
12076
  },
12477
12077
  {
12478
- "name": "search[order]",
12479
- "in": "query",
12480
- "schema": {
12481
- "type": "string",
12482
- "enum": [
12483
- "id_asc",
12484
- "id_desc"
12485
- ]
12486
- }
12078
+ "$ref": "#/components/parameters/orderQuery"
12487
12079
  },
12488
12080
  {
12489
12081
  "in": "query",
@@ -12548,27 +12140,19 @@
12548
12140
  ],
12549
12141
  "parameters": [
12550
12142
  {
12551
- "$ref": "#/components/parameters/limit"
12143
+ "$ref": "#/components/parameters/limitQuery"
12552
12144
  },
12553
12145
  {
12554
- "$ref": "#/components/parameters/page"
12146
+ "$ref": "#/components/parameters/pageQuery"
12555
12147
  },
12556
12148
  {
12557
- "$ref": "#/components/parameters/id"
12149
+ "$ref": "#/components/parameters/idQuery"
12558
12150
  },
12559
12151
  {
12560
- "$ref": "#/components/parameters/ip_addr"
12152
+ "$ref": "#/components/parameters/ipAddrQuery"
12561
12153
  },
12562
12154
  {
12563
- "name": "search[order]",
12564
- "in": "query",
12565
- "schema": {
12566
- "type": "string",
12567
- "enum": [
12568
- "id_asc",
12569
- "id_desc"
12570
- ]
12571
- }
12155
+ "$ref": "#/components/parameters/orderQuery"
12572
12156
  },
12573
12157
  {
12574
12158
  "in": "query",
@@ -12715,13 +12299,7 @@
12715
12299
  ],
12716
12300
  "parameters": [
12717
12301
  {
12718
- "name": "id",
12719
- "in": "path",
12720
- "required": true,
12721
- "description": "The ID of the post flag.",
12722
- "schema": {
12723
- "type": "integer"
12724
- }
12302
+ "$ref": "#/components/parameters/idPath"
12725
12303
  }
12726
12304
  ],
12727
12305
  "responses": {
@@ -12756,13 +12334,7 @@
12756
12334
  "description": "You must be Janitor+",
12757
12335
  "parameters": [
12758
12336
  {
12759
- "name": "id",
12760
- "in": "path",
12761
- "required": true,
12762
- "description": "The ID of the post flag.",
12763
- "schema": {
12764
- "type": "integer"
12765
- }
12337
+ "$ref": "#/components/parameters/idPath"
12766
12338
  }
12767
12339
  ],
12768
12340
  "responses": {
@@ -12795,13 +12367,13 @@
12795
12367
  "description": "Rejected replacements can only be seen by staff.",
12796
12368
  "parameters": [
12797
12369
  {
12798
- "$ref": "#/components/parameters/limit"
12370
+ "$ref": "#/components/parameters/limitQuery"
12799
12371
  },
12800
12372
  {
12801
- "$ref": "#/components/parameters/page"
12373
+ "$ref": "#/components/parameters/pageQuery"
12802
12374
  },
12803
12375
  {
12804
- "$ref": "#/components/parameters/id"
12376
+ "$ref": "#/components/parameters/idQuery"
12805
12377
  },
12806
12378
  {
12807
12379
  "in": "query",
@@ -13017,13 +12589,7 @@
13017
12589
  ],
13018
12590
  "parameters": [
13019
12591
  {
13020
- "name": "id",
13021
- "in": "path",
13022
- "required": true,
13023
- "description": "The ID of the post replacement.",
13024
- "schema": {
13025
- "type": "integer"
13026
- }
12592
+ "$ref": "#/components/parameters/idPath"
13027
12593
  }
13028
12594
  ],
13029
12595
  "responses": {
@@ -13054,10 +12620,9 @@
13054
12620
  "description": "You must have the \"Approve Posts\" permission.",
13055
12621
  "parameters": [
13056
12622
  {
13057
- "name": "id",
13058
- "in": "path",
12623
+ "$ref": "#/components/parameters/idPath",
13059
12624
  "required": true,
13060
- "description": "The ID of the post replacement.",
12625
+ "description": "The ID of the post flag.",
13061
12626
  "schema": {
13062
12627
  "type": "integer"
13063
12628
  }
@@ -13094,13 +12659,7 @@
13094
12659
  "description": "You must have the \"Approve Posts\" permission.",
13095
12660
  "parameters": [
13096
12661
  {
13097
- "name": "id",
13098
- "in": "path",
13099
- "required": true,
13100
- "description": "The ID of the post replacement.",
13101
- "schema": {
13102
- "type": "integer"
13103
- }
12662
+ "$ref": "#/components/parameters/idPath"
13104
12663
  }
13105
12664
  ],
13106
12665
  "responses": {
@@ -13134,13 +12693,7 @@
13134
12693
  "description": "You must have the \"Approve Posts\" permission.",
13135
12694
  "parameters": [
13136
12695
  {
13137
- "name": "id",
13138
- "in": "path",
13139
- "required": true,
13140
- "description": "The ID of the post replacement.",
13141
- "schema": {
13142
- "type": "integer"
13143
- }
12696
+ "$ref": "#/components/parameters/idPath"
13144
12697
  }
13145
12698
  ],
13146
12699
  "responses": {
@@ -13189,13 +12742,7 @@
13189
12742
  "description": "You must have the \"Approve Posts\" permission.",
13190
12743
  "parameters": [
13191
12744
  {
13192
- "name": "id",
13193
- "in": "path",
13194
- "required": true,
13195
- "description": "The ID of the post replacement.",
13196
- "schema": {
13197
- "type": "integer"
13198
- }
12745
+ "$ref": "#/components/parameters/idPath"
13199
12746
  }
13200
12747
  ],
13201
12748
  "responses": {
@@ -13223,7 +12770,7 @@
13223
12770
  ],
13224
12771
  "parameters": [
13225
12772
  {
13226
- "$ref": "#/components/parameters/limit"
12773
+ "$ref": "#/components/parameters/limitQuery"
13227
12774
  },
13228
12775
  {
13229
12776
  "name": "page",
@@ -13236,7 +12783,7 @@
13236
12783
  }
13237
12784
  },
13238
12785
  {
13239
- "$ref": "#/components/parameters/id"
12786
+ "$ref": "#/components/parameters/idQuery"
13240
12787
  },
13241
12788
  {
13242
12789
  "in": "query",
@@ -13415,13 +12962,7 @@
13415
12962
  "description": "You must be Admin+.",
13416
12963
  "parameters": [
13417
12964
  {
13418
- "name": "id",
13419
- "in": "path",
13420
- "required": true,
13421
- "description": "The ID of the post version.",
13422
- "schema": {
13423
- "type": "integer"
13424
- }
12965
+ "$ref": "#/components/parameters/idPath"
13425
12966
  }
13426
12967
  ],
13427
12968
  "responses": {
@@ -13452,13 +12993,7 @@
13452
12993
  "description": "You must be Admin+.",
13453
12994
  "parameters": [
13454
12995
  {
13455
- "name": "id",
13456
- "in": "path",
13457
- "required": true,
13458
- "description": "The ID of the post version.",
13459
- "schema": {
13460
- "type": "integer"
13461
- }
12996
+ "$ref": "#/components/parameters/idPath"
13462
12997
  }
13463
12998
  ],
13464
12999
  "responses": {
@@ -13488,13 +13023,7 @@
13488
13023
  ],
13489
13024
  "parameters": [
13490
13025
  {
13491
- "name": "id",
13492
- "in": "path",
13493
- "required": true,
13494
- "description": "The ID of the post version.",
13495
- "schema": {
13496
- "type": "integer"
13497
- }
13026
+ "$ref": "#/components/parameters/idPath"
13498
13027
  }
13499
13028
  ],
13500
13029
  "responses": {
@@ -13593,13 +13122,13 @@
13593
13122
  ],
13594
13123
  "parameters": [
13595
13124
  {
13596
- "$ref": "#/components/parameters/limit"
13125
+ "$ref": "#/components/parameters/limitQuery"
13597
13126
  },
13598
13127
  {
13599
- "$ref": "#/components/parameters/page"
13128
+ "$ref": "#/components/parameters/pageQuery"
13600
13129
  },
13601
13130
  {
13602
- "$ref": "#/components/parameters/id"
13131
+ "$ref": "#/components/parameters/idQuery"
13603
13132
  },
13604
13133
  {
13605
13134
  "name": "search[order]",
@@ -13692,13 +13221,7 @@
13692
13221
  ],
13693
13222
  "parameters": [
13694
13223
  {
13695
- "name": "id",
13696
- "in": "path",
13697
- "required": true,
13698
- "description": "The ID or name of the tag.",
13699
- "schema": {
13700
- "type": "integer"
13701
- }
13224
+ "$ref": "#/components/parameters/idPath"
13702
13225
  }
13703
13226
  ],
13704
13227
  "responses": {
@@ -13731,13 +13254,7 @@
13731
13254
  "description": "Must be Admin+ if the tag is locked or post count is >100.",
13732
13255
  "parameters": [
13733
13256
  {
13734
- "name": "id",
13735
- "in": "path",
13736
- "required": true,
13737
- "description": "The ID of the tag.",
13738
- "schema": {
13739
- "type": "integer"
13740
- }
13257
+ "$ref": "#/components/parameters/idPath"
13741
13258
  }
13742
13259
  ],
13743
13260
  "requestBody": {
@@ -13787,13 +13304,7 @@
13787
13304
  "description": "You must have the bd staff user flag.",
13788
13305
  "parameters": [
13789
13306
  {
13790
- "name": "id",
13791
- "in": "path",
13792
- "required": true,
13793
- "description": "The ID of the tag.",
13794
- "schema": {
13795
- "type": "integer"
13796
- }
13307
+ "$ref": "#/components/parameters/idPath"
13797
13308
  }
13798
13309
  ],
13799
13310
  "responses": {
@@ -13821,13 +13332,7 @@
13821
13332
  ],
13822
13333
  "parameters": [
13823
13334
  {
13824
- "name": "id",
13825
- "in": "path",
13826
- "required": true,
13827
- "description": "The ID of the tag.",
13828
- "schema": {
13829
- "type": "integer"
13830
- }
13335
+ "$ref": "#/components/parameters/idPath"
13831
13336
  }
13832
13337
  ],
13833
13338
  "responses": {
@@ -13860,13 +13365,7 @@
13860
13365
  "description": "You must be Janitor+. `commit=Fix` must be set.",
13861
13366
  "parameters": [
13862
13367
  {
13863
- "name": "id",
13864
- "in": "path",
13865
- "required": true,
13866
- "description": "The ID of the tag.",
13867
- "schema": {
13868
- "type": "integer"
13869
- }
13368
+ "$ref": "#/components/parameters/idPath"
13870
13369
  }
13871
13370
  ],
13872
13371
  "requestBody": {
@@ -13962,13 +13461,13 @@
13962
13461
  ],
13963
13462
  "parameters": [
13964
13463
  {
13965
- "$ref": "#/components/parameters/limit"
13464
+ "$ref": "#/components/parameters/limitQuery"
13966
13465
  },
13967
13466
  {
13968
- "$ref": "#/components/parameters/page"
13467
+ "$ref": "#/components/parameters/pageQuery"
13969
13468
  },
13970
13469
  {
13971
- "$ref": "#/components/parameters/id"
13470
+ "$ref": "#/components/parameters/idQuery"
13972
13471
  },
13973
13472
  {
13974
13473
  "name": "search[tag]",
@@ -14018,13 +13517,13 @@
14018
13517
  ],
14019
13518
  "parameters": [
14020
13519
  {
14021
- "$ref": "#/components/parameters/limit"
13520
+ "$ref": "#/components/parameters/limitQuery"
14022
13521
  },
14023
13522
  {
14024
- "$ref": "#/components/parameters/page"
13523
+ "$ref": "#/components/parameters/pageQuery"
14025
13524
  },
14026
13525
  {
14027
- "$ref": "#/components/parameters/id"
13526
+ "$ref": "#/components/parameters/idQuery"
14028
13527
  },
14029
13528
  {
14030
13529
  "name": "search[order]",
@@ -14138,13 +13637,7 @@
14138
13637
  ],
14139
13638
  "parameters": [
14140
13639
  {
14141
- "name": "id",
14142
- "in": "path",
14143
- "required": true,
14144
- "description": "The ID of the tag alias.",
14145
- "schema": {
14146
- "type": "integer"
14147
- }
13640
+ "$ref": "#/components/parameters/idPath"
14148
13641
  }
14149
13642
  ],
14150
13643
  "responses": {
@@ -14177,13 +13670,7 @@
14177
13670
  "description": "You must be Admin+.",
14178
13671
  "parameters": [
14179
13672
  {
14180
- "name": "id",
14181
- "in": "path",
14182
- "required": true,
14183
- "description": "The ID of the tag alias.",
14184
- "schema": {
14185
- "type": "integer"
14186
- }
13673
+ "$ref": "#/components/parameters/idPath"
14187
13674
  }
14188
13675
  ],
14189
13676
  "requestBody": {
@@ -14235,13 +13722,7 @@
14235
13722
  ],
14236
13723
  "parameters": [
14237
13724
  {
14238
- "name": "id",
14239
- "in": "path",
14240
- "required": true,
14241
- "description": "The ID of the tag alias.",
14242
- "schema": {
14243
- "type": "integer"
14244
- }
13725
+ "$ref": "#/components/parameters/idPath"
14245
13726
  }
14246
13727
  ],
14247
13728
  "responses": {
@@ -14272,13 +13753,7 @@
14272
13753
  "description": "You must be Admin+.",
14273
13754
  "parameters": [
14274
13755
  {
14275
- "name": "id",
14276
- "in": "path",
14277
- "required": true,
14278
- "description": "The ID of the tag alias.",
14279
- "schema": {
14280
- "type": "integer"
14281
- }
13756
+ "$ref": "#/components/parameters/idPath"
14282
13757
  }
14283
13758
  ],
14284
13759
  "responses": {
@@ -14361,13 +13836,13 @@
14361
13836
  ],
14362
13837
  "parameters": [
14363
13838
  {
14364
- "$ref": "#/components/parameters/limit"
13839
+ "$ref": "#/components/parameters/limitQuery"
14365
13840
  },
14366
13841
  {
14367
- "$ref": "#/components/parameters/page"
13842
+ "$ref": "#/components/parameters/pageQuery"
14368
13843
  },
14369
13844
  {
14370
- "$ref": "#/components/parameters/id"
13845
+ "$ref": "#/components/parameters/idQuery"
14371
13846
  },
14372
13847
  {
14373
13848
  "name": "search[order]",
@@ -14481,13 +13956,7 @@
14481
13956
  ],
14482
13957
  "parameters": [
14483
13958
  {
14484
- "name": "id",
14485
- "in": "path",
14486
- "required": true,
14487
- "description": "The ID of the tag implication.",
14488
- "schema": {
14489
- "type": "integer"
14490
- }
13959
+ "$ref": "#/components/parameters/idPath"
14491
13960
  }
14492
13961
  ],
14493
13962
  "responses": {
@@ -14520,13 +13989,7 @@
14520
13989
  "description": "You must be Admin+.",
14521
13990
  "parameters": [
14522
13991
  {
14523
- "name": "id",
14524
- "in": "path",
14525
- "required": true,
14526
- "description": "The ID of the tag implication.",
14527
- "schema": {
14528
- "type": "integer"
14529
- }
13992
+ "$ref": "#/components/parameters/idPath"
14530
13993
  }
14531
13994
  ],
14532
13995
  "requestBody": {
@@ -14578,13 +14041,7 @@
14578
14041
  ],
14579
14042
  "parameters": [
14580
14043
  {
14581
- "name": "id",
14582
- "in": "path",
14583
- "required": true,
14584
- "description": "The ID of the tag implication.",
14585
- "schema": {
14586
- "type": "integer"
14587
- }
14044
+ "$ref": "#/components/parameters/idPath"
14588
14045
  }
14589
14046
  ],
14590
14047
  "responses": {
@@ -14615,13 +14072,7 @@
14615
14072
  "description": "You must be Admin+.",
14616
14073
  "parameters": [
14617
14074
  {
14618
- "name": "id",
14619
- "in": "path",
14620
- "required": true,
14621
- "description": "The ID of the tag implication.",
14622
- "schema": {
14623
- "type": "integer"
14624
- }
14075
+ "$ref": "#/components/parameters/idPath"
14625
14076
  }
14626
14077
  ],
14627
14078
  "responses": {
@@ -14752,6 +14203,333 @@
14752
14203
  }
14753
14204
  }
14754
14205
  },
14206
+ "/search_trends.json": {
14207
+ "get": {
14208
+ "summary": "List Search Trends",
14209
+ "operationId": "listSearchTrends",
14210
+ "tags": [
14211
+ "Search Trends"
14212
+ ],
14213
+ "parameters": [
14214
+ {
14215
+ "in": "query",
14216
+ "name": "day",
14217
+ "schema": {
14218
+ "type": "string",
14219
+ "format": "date"
14220
+ }
14221
+ }
14222
+ ],
14223
+ "responses": {
14224
+ "200": {
14225
+ "description": "Success",
14226
+ "content": {
14227
+ "application/json": {
14228
+ "schema": {
14229
+ "type": "array",
14230
+ "items": {
14231
+ "$ref": "#/components/schemas/SearchTrend"
14232
+ }
14233
+ }
14234
+ }
14235
+ }
14236
+ }
14237
+ }
14238
+ }
14239
+ },
14240
+ "/search_trends/rising.json": {
14241
+ "get": {
14242
+ "summary": "List Rising Search Trends",
14243
+ "operationId": "listRisingSearchTrends",
14244
+ "tags": [
14245
+ "Search Trends"
14246
+ ],
14247
+ "responses": {
14248
+ "200": {
14249
+ "description": "Success",
14250
+ "content": {
14251
+ "application/json": {
14252
+ "schema": {
14253
+ "type": "array",
14254
+ "items": {
14255
+ "$ref": "#/components/schemas/RisingSearchTrend"
14256
+ }
14257
+ }
14258
+ }
14259
+ }
14260
+ }
14261
+ }
14262
+ }
14263
+ },
14264
+ "/search_trends/clear_cache.json": {
14265
+ "post": {
14266
+ "summary": "Clear Search Trends Cache",
14267
+ "operationId": "clearSearchTrendsCache",
14268
+ "tags": [
14269
+ "Search Trends"
14270
+ ],
14271
+ "security": [
14272
+ {
14273
+ "basicAuth": []
14274
+ }
14275
+ ],
14276
+ "description": "You must be Admin+.",
14277
+ "responses": {
14278
+ "200": {
14279
+ "$ref": "#/components/responses/MessageSuccess"
14280
+ },
14281
+ "403": {
14282
+ "$ref": "#/components/responses/AccessDenied"
14283
+ }
14284
+ }
14285
+ }
14286
+ },
14287
+ "/search_trends/update_settings.json": {
14288
+ "post": {
14289
+ "summary": "Update Search Trends Settings",
14290
+ "operationId": "updateSearchTrendsSettings",
14291
+ "tags": [
14292
+ "Search Trends"
14293
+ ],
14294
+ "security": [
14295
+ {
14296
+ "basicAuth": []
14297
+ }
14298
+ ],
14299
+ "description": "You must be Admin+.",
14300
+ "requestBody": {
14301
+ "content": {
14302
+ "application/json": {
14303
+ "schema": {
14304
+ "type": "object",
14305
+ "properties": {
14306
+ "trends_enabled": {
14307
+ "type": "boolean"
14308
+ },
14309
+ "trends_min_today": {
14310
+ "type": "integer"
14311
+ },
14312
+ "trends_min_dleta": {
14313
+ "type": "integer"
14314
+ },
14315
+ "trends_min_ratio": {
14316
+ "type": "number",
14317
+ "format": "float"
14318
+ },
14319
+ "trends_ip_limit": {
14320
+ "type": "integer"
14321
+ },
14322
+ "trends_ip_window": {
14323
+ "type": "integer"
14324
+ },
14325
+ "trends_tag_limit": {
14326
+ "type": "integer"
14327
+ },
14328
+ "trends_tag_window": {
14329
+ "type": "integer"
14330
+ }
14331
+ }
14332
+ }
14333
+ }
14334
+ }
14335
+ },
14336
+ "responses": {
14337
+ "200": {
14338
+ "$ref": "#/components/responses/MessageSuccess"
14339
+ },
14340
+ "403": {
14341
+ "$ref": "#/components/responses/AccessDenied"
14342
+ }
14343
+ }
14344
+ }
14345
+ },
14346
+ "/search_trend_blacklists.json": {
14347
+ "get": {
14348
+ "summary": "Search Search Trend Blacklists",
14349
+ "operationId": "searchSearchTrendBlacklists",
14350
+ "tags": [
14351
+ "Search Trend Blacklists"
14352
+ ],
14353
+ "security": [
14354
+ {
14355
+ "basicAuth": []
14356
+ }
14357
+ ],
14358
+ "description": "You must be Admin+.",
14359
+ "parameters": [
14360
+ {
14361
+ "$ref": "#/components/parameters/limitQuery"
14362
+ },
14363
+ {
14364
+ "$ref": "#/components/parameters/pageQuery"
14365
+ },
14366
+ {
14367
+ "$ref": "#/components/parameters/orderQuery"
14368
+ },
14369
+ {
14370
+ "in": "query",
14371
+ "name": "tag",
14372
+ "schema": {
14373
+ "type": "string"
14374
+ }
14375
+ },
14376
+ {
14377
+ "in": "query",
14378
+ "name": "reason",
14379
+ "schema": {
14380
+ "type": "string"
14381
+ }
14382
+ }
14383
+ ],
14384
+ "responses": {
14385
+ "200": {
14386
+ "description": "Success",
14387
+ "content": {
14388
+ "application/json": {
14389
+ "schema": {
14390
+ "type": "array",
14391
+ "items": {
14392
+ "$ref": "#/components/schemas/SearchTrendBlacklist"
14393
+ }
14394
+ }
14395
+ }
14396
+ }
14397
+ },
14398
+ "403": {
14399
+ "$ref": "#/components/responses/AccessDenied"
14400
+ }
14401
+ }
14402
+ },
14403
+ "post": {
14404
+ "summary": "Create Search Trend Blacklist",
14405
+ "operationId": "createSearchTrendBlacklist",
14406
+ "tags": [
14407
+ "Search Trend Blacklists"
14408
+ ],
14409
+ "security": [
14410
+ {
14411
+ "basicAuth": []
14412
+ }
14413
+ ],
14414
+ "description": "You must be Admin+.",
14415
+ "requestBody": {
14416
+ "content": {
14417
+ "application/json": {
14418
+ "schema": {
14419
+ "type": "object",
14420
+ "required": [
14421
+ "tag",
14422
+ "reason"
14423
+ ],
14424
+ "properties": {
14425
+ "tag": {
14426
+ "type": "string"
14427
+ },
14428
+ "reason": {
14429
+ "type": "string"
14430
+ }
14431
+ }
14432
+ }
14433
+ }
14434
+ }
14435
+ },
14436
+ "responses": {
14437
+ "201": {
14438
+ "description": "Success",
14439
+ "content": {
14440
+ "application/json": {
14441
+ "schema": {
14442
+ "$ref": "#/components/schemas/SearchTrendBlacklist"
14443
+ }
14444
+ }
14445
+ }
14446
+ },
14447
+ "403": {
14448
+ "$ref": "#/components/responses/AccessDenied"
14449
+ },
14450
+ "422": {
14451
+ "$ref": "#/components/responses/ExpectedError"
14452
+ }
14453
+ }
14454
+ }
14455
+ },
14456
+ "/search_trend_blacklists/{id}.json": {
14457
+ "delete": {
14458
+ "summary": "Delete Search Trend Blacklist",
14459
+ "operationId": "deleteSearchTrendBlacklist",
14460
+ "tags": [
14461
+ "Search Trend Blacklists"
14462
+ ],
14463
+ "security": [
14464
+ {
14465
+ "basicAuth": []
14466
+ }
14467
+ ],
14468
+ "description": "You must be Admin+.",
14469
+ "parameters": [
14470
+ {
14471
+ "$ref": "#/components/parameters/idPath"
14472
+ }
14473
+ ],
14474
+ "responses": {
14475
+ "204": {
14476
+ "description": "Success"
14477
+ },
14478
+ "403": {
14479
+ "$ref": "#/components/responses/AccessDenied"
14480
+ },
14481
+ "404": {
14482
+ "$ref": "#/components/responses/NotFound"
14483
+ }
14484
+ }
14485
+ }
14486
+ },
14487
+ "/search_trend_blacklists/{id}/purge.json": {
14488
+ "delete": {
14489
+ "summary": "Purge Search Trend Blacklist",
14490
+ "operationId": "purgeSearchTrendBlacklist",
14491
+ "tags": [
14492
+ "Search Trend Blacklists"
14493
+ ],
14494
+ "security": [
14495
+ {
14496
+ "basicAuth": []
14497
+ }
14498
+ ],
14499
+ "description": "You must be Admin+.",
14500
+ "parameters": [
14501
+ {
14502
+ "$ref": "#/components/parameters/idPath"
14503
+ }
14504
+ ],
14505
+ "responses": {
14506
+ "200": {
14507
+ "description": "Success",
14508
+ "content": {
14509
+ "application/json": {
14510
+ "schema": {
14511
+ "type": "object",
14512
+ "required": [
14513
+ "deleted_count"
14514
+ ],
14515
+ "properties": {
14516
+ "deleted_count": {
14517
+ "type": "integer"
14518
+ }
14519
+ }
14520
+ }
14521
+ }
14522
+ }
14523
+ },
14524
+ "403": {
14525
+ "$ref": "#/components/responses/AccessDenied"
14526
+ },
14527
+ "404": {
14528
+ "$ref": "#/components/responses/NotFound"
14529
+ }
14530
+ }
14531
+ }
14532
+ },
14755
14533
  "/session.json": {
14756
14534
  "post": {
14757
14535
  "summary": "Login",
@@ -14825,24 +14603,16 @@
14825
14603
  ],
14826
14604
  "parameters": [
14827
14605
  {
14828
- "$ref": "#/components/parameters/limit"
14606
+ "$ref": "#/components/parameters/limitQuery"
14829
14607
  },
14830
14608
  {
14831
- "$ref": "#/components/parameters/page"
14609
+ "$ref": "#/components/parameters/pageQuery"
14832
14610
  },
14833
14611
  {
14834
- "$ref": "#/components/parameters/id"
14612
+ "$ref": "#/components/parameters/idQuery"
14835
14613
  },
14836
14614
  {
14837
- "name": "search[order]",
14838
- "in": "query",
14839
- "schema": {
14840
- "type": "string",
14841
- "enum": [
14842
- "id_asc",
14843
- "id_desc"
14844
- ]
14845
- }
14615
+ "$ref": "#/components/parameters/orderQuery"
14846
14616
  },
14847
14617
  {
14848
14618
  "name": "search[creator_id]",
@@ -14984,13 +14754,7 @@
14984
14754
  ],
14985
14755
  "parameters": [
14986
14756
  {
14987
- "name": "id",
14988
- "in": "path",
14989
- "description": "The ID of the staff note to get.",
14990
- "required": true,
14991
- "schema": {
14992
- "type": "integer"
14993
- }
14757
+ "$ref": "#/components/parameters/idPath"
14994
14758
  }
14995
14759
  ],
14996
14760
  "responses": {
@@ -15026,13 +14790,7 @@
15026
14790
  "description": "You must be the creator or Admin+.",
15027
14791
  "parameters": [
15028
14792
  {
15029
- "name": "id",
15030
- "in": "path",
15031
- "description": "The ID of the staff note.",
15032
- "required": true,
15033
- "schema": {
15034
- "type": "integer"
15035
- }
14793
+ "$ref": "#/components/parameters/idPath"
15036
14794
  }
15037
14795
  ],
15038
14796
  "requestBody": {
@@ -15087,13 +14845,7 @@
15087
14845
  "description": "You must be the creator or Admin+.\n",
15088
14846
  "parameters": [
15089
14847
  {
15090
- "name": "id",
15091
- "in": "path",
15092
- "required": true,
15093
- "description": "The ID of the staff note.",
15094
- "schema": {
15095
- "type": "integer"
15096
- }
14848
+ "$ref": "#/components/parameters/idPath"
15097
14849
  }
15098
14850
  ],
15099
14851
  "responses": {
@@ -15131,13 +14883,7 @@
15131
14883
  "description": "You must be the creator or Admin+.\n",
15132
14884
  "parameters": [
15133
14885
  {
15134
- "name": "id",
15135
- "in": "path",
15136
- "required": true,
15137
- "description": "The ID of the staff note.",
15138
- "schema": {
15139
- "type": "integer"
15140
- }
14886
+ "$ref": "#/components/parameters/idPath"
15141
14887
  }
15142
14888
  ],
15143
14889
  "responses": {
@@ -15169,16 +14915,16 @@
15169
14915
  ],
15170
14916
  "parameters": [
15171
14917
  {
15172
- "$ref": "#/components/parameters/limit"
14918
+ "$ref": "#/components/parameters/limitQuery"
15173
14919
  },
15174
14920
  {
15175
- "$ref": "#/components/parameters/page"
14921
+ "$ref": "#/components/parameters/pageQuery"
15176
14922
  },
15177
14923
  {
15178
- "$ref": "#/components/parameters/id"
14924
+ "$ref": "#/components/parameters/idQuery"
15179
14925
  },
15180
14926
  {
15181
- "$ref": "#/components/parameters/ip_addr"
14927
+ "$ref": "#/components/parameters/ipAddrQuery"
15182
14928
  },
15183
14929
  {
15184
14930
  "in": "query",
@@ -15397,14 +15143,8 @@
15397
15143
  "Takedowns"
15398
15144
  ],
15399
15145
  "parameters": [
15400
- {
15401
- "name": "id",
15402
- "in": "path",
15403
- "required": true,
15404
- "description": "The ID of the takedown.",
15405
- "schema": {
15406
- "type": "integer"
15407
- }
15146
+ {
15147
+ "$ref": "#/components/parameters/idPath"
15408
15148
  }
15409
15149
  ],
15410
15150
  "responses": {
@@ -15437,13 +15177,7 @@
15437
15177
  "description": "You must have the bd staff user flag.",
15438
15178
  "parameters": [
15439
15179
  {
15440
- "name": "id",
15441
- "in": "path",
15442
- "required": true,
15443
- "description": "The ID of the takedown.",
15444
- "schema": {
15445
- "type": "integer"
15446
- }
15180
+ "$ref": "#/components/parameters/idPath"
15447
15181
  }
15448
15182
  ],
15449
15183
  "requestBody": {
@@ -15502,13 +15236,7 @@
15502
15236
  "description": "You must have the bd staff user flag.",
15503
15237
  "parameters": [
15504
15238
  {
15505
- "name": "id",
15506
- "in": "path",
15507
- "required": true,
15508
- "description": "The ID of the takedown.",
15509
- "schema": {
15510
- "type": "integer"
15511
- }
15239
+ "$ref": "#/components/parameters/idPath"
15512
15240
  }
15513
15241
  ],
15514
15242
  "responses": {
@@ -15539,13 +15267,7 @@
15539
15267
  "description": "You must have the bd staff user flag.",
15540
15268
  "parameters": [
15541
15269
  {
15542
- "name": "id",
15543
- "in": "path",
15544
- "required": true,
15545
- "description": "The ID of the takedown.",
15546
- "schema": {
15547
- "type": "integer"
15548
- }
15270
+ "$ref": "#/components/parameters/idPath"
15549
15271
  }
15550
15272
  ],
15551
15273
  "requestBody": {
@@ -15615,13 +15337,7 @@
15615
15337
  "description": "You must have the bd staff user flag.",
15616
15338
  "parameters": [
15617
15339
  {
15618
- "name": "id",
15619
- "in": "path",
15620
- "required": true,
15621
- "description": "The ID of the takedown.",
15622
- "schema": {
15623
- "type": "integer"
15624
- }
15340
+ "$ref": "#/components/parameters/idPath"
15625
15341
  }
15626
15342
  ],
15627
15343
  "requestBody": {
@@ -15691,13 +15407,7 @@
15691
15407
  "description": "You must have the bd staff user flag.",
15692
15408
  "parameters": [
15693
15409
  {
15694
- "name": "id",
15695
- "in": "path",
15696
- "required": true,
15697
- "description": "The ID of the takedown.",
15698
- "schema": {
15699
- "type": "integer"
15700
- }
15410
+ "$ref": "#/components/parameters/idPath"
15701
15411
  }
15702
15412
  ],
15703
15413
  "requestBody": {
@@ -15760,13 +15470,7 @@
15760
15470
  "description": "You must have the bd staff user flag.",
15761
15471
  "parameters": [
15762
15472
  {
15763
- "name": "id",
15764
- "in": "path",
15765
- "required": true,
15766
- "description": "The ID of the takedown.",
15767
- "schema": {
15768
- "type": "integer"
15769
- }
15473
+ "$ref": "#/components/parameters/idPath"
15770
15474
  }
15771
15475
  ],
15772
15476
  "requestBody": {
@@ -15809,13 +15513,13 @@
15809
15513
  "description": "You must be Janitor+ to see tickets you did not create.",
15810
15514
  "parameters": [
15811
15515
  {
15812
- "$ref": "#/components/parameters/limit"
15516
+ "$ref": "#/components/parameters/limitQuery"
15813
15517
  },
15814
15518
  {
15815
- "$ref": "#/components/parameters/page"
15519
+ "$ref": "#/components/parameters/pageQuery"
15816
15520
  },
15817
15521
  {
15818
- "$ref": "#/components/parameters/id"
15522
+ "$ref": "#/components/parameters/idQuery"
15819
15523
  },
15820
15524
  {
15821
15525
  "in": "query",
@@ -15938,13 +15642,7 @@
15938
15642
  "description": "You must be Janitor+ to see tickets you did not create.",
15939
15643
  "parameters": [
15940
15644
  {
15941
- "name": "id",
15942
- "in": "path",
15943
- "required": true,
15944
- "description": "The ID of the ticket.",
15945
- "schema": {
15946
- "type": "integer"
15947
- }
15645
+ "$ref": "#/components/parameters/idPath"
15948
15646
  }
15949
15647
  ],
15950
15648
  "responses": {
@@ -15980,13 +15678,7 @@
15980
15678
  ],
15981
15679
  "parameters": [
15982
15680
  {
15983
- "name": "id",
15984
- "in": "path",
15985
- "required": true,
15986
- "description": "The ID of the ticket.",
15987
- "schema": {
15988
- "type": "integer"
15989
- }
15681
+ "$ref": "#/components/parameters/idPath"
15990
15682
  }
15991
15683
  ],
15992
15684
  "requestBody": {
@@ -16043,13 +15735,7 @@
16043
15735
  "description": "You must be Moderator+. Errors are quietly swallowed and shown as notices in html.",
16044
15736
  "parameters": [
16045
15737
  {
16046
- "name": "id",
16047
- "in": "path",
16048
- "required": true,
16049
- "description": "The ID of the ticket.",
16050
- "schema": {
16051
- "type": "integer"
16052
- }
15738
+ "$ref": "#/components/parameters/idPath"
16053
15739
  }
16054
15740
  ],
16055
15741
  "security": [
@@ -16087,13 +15773,7 @@
16087
15773
  "description": "You must be Moderator+. Errors are quietly swallowed and shown as notices in html.",
16088
15774
  "parameters": [
16089
15775
  {
16090
- "name": "id",
16091
- "in": "path",
16092
- "required": true,
16093
- "description": "The ID of the ticket.",
16094
- "schema": {
16095
- "type": "integer"
16096
- }
15776
+ "$ref": "#/components/parameters/idPath"
16097
15777
  }
16098
15778
  ],
16099
15779
  "security": [
@@ -16130,24 +15810,16 @@
16130
15810
  ],
16131
15811
  "parameters": [
16132
15812
  {
16133
- "$ref": "#/components/parameters/limit"
15813
+ "$ref": "#/components/parameters/limitQuery"
16134
15814
  },
16135
15815
  {
16136
- "$ref": "#/components/parameters/page"
15816
+ "$ref": "#/components/parameters/pageQuery"
16137
15817
  },
16138
15818
  {
16139
- "$ref": "#/components/parameters/id"
15819
+ "$ref": "#/components/parameters/idQuery"
16140
15820
  },
16141
15821
  {
16142
- "name": "search[order]",
16143
- "in": "query",
16144
- "schema": {
16145
- "type": "string",
16146
- "enum": [
16147
- "id_asc",
16148
- "id_desc"
16149
- ]
16150
- }
15822
+ "$ref": "#/components/parameters/orderQuery"
16151
15823
  },
16152
15824
  {
16153
15825
  "in": "query",
@@ -16369,13 +16041,7 @@
16369
16041
  "description": "You must be Janitor+.",
16370
16042
  "parameters": [
16371
16043
  {
16372
- "name": "id",
16373
- "in": "path",
16374
- "required": true,
16375
- "description": "The ID of the upload.",
16376
- "schema": {
16377
- "type": "integer"
16378
- }
16044
+ "$ref": "#/components/parameters/idPath"
16379
16045
  }
16380
16046
  ],
16381
16047
  "responses": {
@@ -16407,13 +16073,13 @@
16407
16073
  ],
16408
16074
  "parameters": [
16409
16075
  {
16410
- "$ref": "#/components/parameters/limit"
16076
+ "$ref": "#/components/parameters/limitQuery"
16411
16077
  },
16412
16078
  {
16413
- "$ref": "#/components/parameters/page"
16079
+ "$ref": "#/components/parameters/pageQuery"
16414
16080
  },
16415
16081
  {
16416
- "$ref": "#/components/parameters/id"
16082
+ "$ref": "#/components/parameters/idQuery"
16417
16083
  },
16418
16084
  {
16419
16085
  "name": "search[order]",
@@ -16555,13 +16221,7 @@
16555
16221
  ],
16556
16222
  "parameters": [
16557
16223
  {
16558
- "name": "id",
16559
- "in": "path",
16560
- "required": true,
16561
- "description": "The ID of the upload whitelist entry.",
16562
- "schema": {
16563
- "type": "integer"
16564
- }
16224
+ "$ref": "#/components/parameters/idPath"
16565
16225
  }
16566
16226
  ],
16567
16227
  "requestBody": {
@@ -16619,13 +16279,7 @@
16619
16279
  "description": "You must be Admin+.",
16620
16280
  "parameters": [
16621
16281
  {
16622
- "name": "id",
16623
- "in": "path",
16624
- "required": true,
16625
- "description": "The ID of the upload whitelist.",
16626
- "schema": {
16627
- "type": "integer"
16628
- }
16282
+ "$ref": "#/components/parameters/idPath"
16629
16283
  }
16630
16284
  ],
16631
16285
  "responses": {
@@ -16714,16 +16368,16 @@
16714
16368
  ],
16715
16369
  "parameters": [
16716
16370
  {
16717
- "$ref": "#/components/parameters/limit"
16371
+ "$ref": "#/components/parameters/limitQuery"
16718
16372
  },
16719
16373
  {
16720
- "$ref": "#/components/parameters/page"
16374
+ "$ref": "#/components/parameters/pageQuery"
16721
16375
  },
16722
16376
  {
16723
- "$ref": "#/components/parameters/id"
16377
+ "$ref": "#/components/parameters/idQuery"
16724
16378
  },
16725
16379
  {
16726
- "$ref": "#/components/parameters/ip_addr"
16380
+ "$ref": "#/components/parameters/ipAddrQuery"
16727
16381
  },
16728
16382
  {
16729
16383
  "name": "search[order]",
@@ -16889,7 +16543,7 @@
16889
16543
  ],
16890
16544
  "parameters": [
16891
16545
  {
16892
- "$ref": "#/components/parameters/idOrName"
16546
+ "$ref": "#/components/parameters/idOrNamePath"
16893
16547
  }
16894
16548
  ],
16895
16549
  "responses": {
@@ -16909,7 +16563,7 @@
16909
16563
  ],
16910
16564
  "parameters": [
16911
16565
  {
16912
- "$ref": "#/components/parameters/idOrName"
16566
+ "$ref": "#/components/parameters/idOrNamePath"
16913
16567
  }
16914
16568
  ],
16915
16569
  "security": [
@@ -16924,7 +16578,7 @@
16924
16578
  "type": "object",
16925
16579
  "properties": {
16926
16580
  "user[comment_threshold]": {
16927
- "type": "number"
16581
+ "type": "integer"
16928
16582
  },
16929
16583
  "user[default_image_size]": {
16930
16584
  "type": "string",
@@ -17047,7 +16701,7 @@
17047
16701
  ],
17048
16702
  "parameters": [
17049
16703
  {
17050
- "$ref": "#/components/parameters/idOrName"
16704
+ "$ref": "#/components/parameters/idOrNamePath"
17051
16705
  }
17052
16706
  ],
17053
16707
  "responses": {
@@ -17070,7 +16724,7 @@
17070
16724
  "description": "You must be Admin+.",
17071
16725
  "parameters": [
17072
16726
  {
17073
- "$ref": "#/components/parameters/idOrName"
16727
+ "$ref": "#/components/parameters/idOrNamePath"
17074
16728
  }
17075
16729
  ],
17076
16730
  "security": [
@@ -17101,7 +16755,7 @@
17101
16755
  "description": "You must be Janitor+.",
17102
16756
  "parameters": [
17103
16757
  {
17104
- "$ref": "#/components/parameters/idOrName"
16758
+ "$ref": "#/components/parameters/idOrNamePath"
17105
16759
  }
17106
16760
  ],
17107
16761
  "security": [
@@ -17132,7 +16786,7 @@
17132
16786
  "description": "You must be Janitor+.\nThis endpoint will return HTML when disabling uploads (due to a reason being required), this endpoint should only be used for reenabling. Use [Disable User Uploads](#operation-Users-disableUserUploads) to disable uploads.\n",
17133
16787
  "parameters": [
17134
16788
  {
17135
- "$ref": "#/components/parameters/idOrName"
16789
+ "$ref": "#/components/parameters/idOrNamePath"
17136
16790
  }
17137
16791
  ],
17138
16792
  "security": [
@@ -17163,7 +16817,7 @@
17163
16817
  "description": "You must be Janitor+.",
17164
16818
  "parameters": [
17165
16819
  {
17166
- "$ref": "#/components/parameters/idOrName"
16820
+ "$ref": "#/components/parameters/idOrNamePath"
17167
16821
  }
17168
16822
  ],
17169
16823
  "security": [
@@ -17216,10 +16870,10 @@
17216
16870
  "description": "Must have the bd auditor user flag.",
17217
16871
  "parameters": [
17218
16872
  {
17219
- "$ref": "#/components/parameters/limit"
16873
+ "$ref": "#/components/parameters/limitQuery"
17220
16874
  },
17221
16875
  {
17222
- "$ref": "#/components/parameters/page"
16876
+ "$ref": "#/components/parameters/pageQuery"
17223
16877
  },
17224
16878
  {
17225
16879
  "name": "user_id",
@@ -17278,13 +16932,7 @@
17278
16932
  }
17279
16933
  },
17280
16934
  {
17281
- "name": "id",
17282
- "in": "path",
17283
- "required": true,
17284
- "description": "The ID of the DMail.",
17285
- "schema": {
17286
- "type": "integer"
17287
- }
16935
+ "$ref": "#/components/parameters/idPath"
17288
16936
  }
17289
16937
  ],
17290
16938
  "responses": {
@@ -17388,24 +17036,16 @@
17388
17036
  ],
17389
17037
  "parameters": [
17390
17038
  {
17391
- "$ref": "#/components/parameters/limit"
17039
+ "$ref": "#/components/parameters/limitQuery"
17392
17040
  },
17393
17041
  {
17394
- "$ref": "#/components/parameters/page"
17042
+ "$ref": "#/components/parameters/pageQuery"
17395
17043
  },
17396
17044
  {
17397
- "$ref": "#/components/parameters/id"
17045
+ "$ref": "#/components/parameters/idQuery"
17398
17046
  },
17399
17047
  {
17400
- "name": "search[order]",
17401
- "in": "query",
17402
- "schema": {
17403
- "type": "string",
17404
- "enum": [
17405
- "id_asc",
17406
- "id_desc"
17407
- ]
17408
- }
17048
+ "$ref": "#/components/parameters/orderQuery"
17409
17049
  },
17410
17050
  {
17411
17051
  "in": "query",
@@ -17548,13 +17188,7 @@
17548
17188
  "description": "You must be Janitor+ if the feedback is deleted.",
17549
17189
  "parameters": [
17550
17190
  {
17551
- "name": "id",
17552
- "in": "path",
17553
- "required": true,
17554
- "description": "The ID of the feedback.",
17555
- "schema": {
17556
- "type": "integer"
17557
- }
17191
+ "$ref": "#/components/parameters/idPath"
17558
17192
  }
17559
17193
  ],
17560
17194
  "responses": {
@@ -17590,13 +17224,7 @@
17590
17224
  "description": "You must be Moderator+.",
17591
17225
  "parameters": [
17592
17226
  {
17593
- "name": "id",
17594
- "in": "path",
17595
- "required": true,
17596
- "description": "The ID of the feedback.",
17597
- "schema": {
17598
- "type": "integer"
17599
- }
17227
+ "$ref": "#/components/parameters/idPath"
17600
17228
  }
17601
17229
  ],
17602
17230
  "requestBody": {
@@ -17645,13 +17273,7 @@
17645
17273
  "description": "You must be Admin+, or the creator and Moderator+.",
17646
17274
  "parameters": [
17647
17275
  {
17648
- "name": "id",
17649
- "in": "path",
17650
- "required": true,
17651
- "description": "The ID of the feedback.",
17652
- "schema": {
17653
- "type": "integer"
17654
- }
17276
+ "$ref": "#/components/parameters/idPath"
17655
17277
  }
17656
17278
  ],
17657
17279
  "responses": {
@@ -17682,13 +17304,7 @@
17682
17304
  "description": "You must be Moderator+.",
17683
17305
  "parameters": [
17684
17306
  {
17685
- "name": "id",
17686
- "in": "path",
17687
- "required": true,
17688
- "description": "The ID of the feedback.",
17689
- "schema": {
17690
- "type": "integer"
17691
- }
17307
+ "$ref": "#/components/parameters/idPath"
17692
17308
  }
17693
17309
  ],
17694
17310
  "responses": {
@@ -17719,13 +17335,7 @@
17719
17335
  "description": "You must be Moderator+.",
17720
17336
  "parameters": [
17721
17337
  {
17722
- "name": "id",
17723
- "in": "path",
17724
- "required": true,
17725
- "description": "The ID of the feedback.",
17726
- "schema": {
17727
- "type": "integer"
17728
- }
17338
+ "$ref": "#/components/parameters/idPath"
17729
17339
  }
17730
17340
  ],
17731
17341
  "responses": {
@@ -17756,24 +17366,16 @@
17756
17366
  "description": "You must be Moderator+.",
17757
17367
  "parameters": [
17758
17368
  {
17759
- "$ref": "#/components/parameters/limit"
17369
+ "$ref": "#/components/parameters/limitQuery"
17760
17370
  },
17761
17371
  {
17762
- "$ref": "#/components/parameters/page"
17372
+ "$ref": "#/components/parameters/pageQuery"
17763
17373
  },
17764
17374
  {
17765
- "$ref": "#/components/parameters/id"
17375
+ "$ref": "#/components/parameters/idQuery"
17766
17376
  },
17767
17377
  {
17768
- "name": "search[order]",
17769
- "in": "query",
17770
- "schema": {
17771
- "type": "string",
17772
- "enum": [
17773
- "id_asc",
17774
- "id_desc"
17775
- ]
17776
- }
17378
+ "$ref": "#/components/parameters/orderQuery"
17777
17379
  },
17778
17380
  {
17779
17381
  "in": "query",
@@ -17879,13 +17481,7 @@
17879
17481
  "description": "You must be the creator of the request or Moderator+.",
17880
17482
  "parameters": [
17881
17483
  {
17882
- "name": "id",
17883
- "in": "path",
17884
- "required": true,
17885
- "description": "The ID of the name change request.",
17886
- "schema": {
17887
- "type": "integer"
17888
- }
17484
+ "$ref": "#/components/parameters/idPath"
17889
17485
  }
17890
17486
  ],
17891
17487
  "responses": {
@@ -17921,13 +17517,7 @@
17921
17517
  "description": "You must be Moderator+.",
17922
17518
  "parameters": [
17923
17519
  {
17924
- "name": "id",
17925
- "in": "path",
17926
- "required": true,
17927
- "description": "The ID of the name change request.",
17928
- "schema": {
17929
- "type": "integer"
17930
- }
17520
+ "$ref": "#/components/parameters/idPath"
17931
17521
  }
17932
17522
  ],
17933
17523
  "responses": {
@@ -17949,13 +17539,13 @@
17949
17539
  ],
17950
17540
  "parameters": [
17951
17541
  {
17952
- "$ref": "#/components/parameters/limit"
17542
+ "$ref": "#/components/parameters/limitQuery"
17953
17543
  },
17954
17544
  {
17955
- "$ref": "#/components/parameters/page"
17545
+ "$ref": "#/components/parameters/pageQuery"
17956
17546
  },
17957
17547
  {
17958
- "$ref": "#/components/parameters/id"
17548
+ "$ref": "#/components/parameters/idQuery"
17959
17549
  },
17960
17550
  {
17961
17551
  "name": "search[order]",
@@ -18140,10 +17730,17 @@
18140
17730
  "name": "id",
18141
17731
  "in": "path",
18142
17732
  "required": true,
18143
- "description": "The ID or name of the wiki page.",
18144
17733
  "schema": {
18145
- "type": "integer"
18146
- }
17734
+ "oneOf": [
17735
+ {
17736
+ "type": "integer"
17737
+ },
17738
+ {
17739
+ "type": "string"
17740
+ }
17741
+ ]
17742
+ },
17743
+ "description": "An ID that can be either an integer or a name."
18147
17744
  }
18148
17745
  ],
18149
17746
  "responses": {
@@ -18176,8 +17773,7 @@
18176
17773
  "description": "You must be Janitor+ if the wiki page is locked.",
18177
17774
  "parameters": [
18178
17775
  {
18179
- "name": "id",
18180
- "in": "path",
17776
+ "$ref": "#/components/parameters/idPath",
18181
17777
  "required": true,
18182
17778
  "description": "The ID of the wiki page.",
18183
17779
  "schema": {
@@ -18258,13 +17854,7 @@
18258
17854
  "description": "You must be Admin+",
18259
17855
  "parameters": [
18260
17856
  {
18261
- "name": "id",
18262
- "in": "path",
18263
- "required": true,
18264
- "description": "The ID of the wiki page.",
18265
- "schema": {
18266
- "type": "integer"
18267
- }
17857
+ "$ref": "#/components/parameters/idPath"
18268
17858
  }
18269
17859
  ],
18270
17860
  "responses": {
@@ -18294,13 +17884,7 @@
18294
17884
  ],
18295
17885
  "parameters": [
18296
17886
  {
18297
- "name": "id",
18298
- "in": "path",
18299
- "required": true,
18300
- "description": "The ID of the wiki page.",
18301
- "schema": {
18302
- "type": "integer"
18303
- }
17887
+ "$ref": "#/components/parameters/idPath"
18304
17888
  },
18305
17889
  {
18306
17890
  "name": "version_id",
@@ -18337,27 +17921,19 @@
18337
17921
  ],
18338
17922
  "parameters": [
18339
17923
  {
18340
- "$ref": "#/components/parameters/limit"
17924
+ "$ref": "#/components/parameters/limitQuery"
18341
17925
  },
18342
17926
  {
18343
- "$ref": "#/components/parameters/page"
17927
+ "$ref": "#/components/parameters/pageQuery"
18344
17928
  },
18345
17929
  {
18346
- "$ref": "#/components/parameters/id"
17930
+ "$ref": "#/components/parameters/idQuery"
18347
17931
  },
18348
17932
  {
18349
- "$ref": "#/components/parameters/ip_addr"
17933
+ "$ref": "#/components/parameters/ipAddrQuery"
18350
17934
  },
18351
17935
  {
18352
- "name": "search[order]",
18353
- "in": "query",
18354
- "schema": {
18355
- "type": "string",
18356
- "enum": [
18357
- "id_asc",
18358
- "id_desc"
18359
- ]
18360
- }
17936
+ "$ref": "#/components/parameters/orderQuery"
18361
17937
  },
18362
17938
  {
18363
17939
  "in": "query",
@@ -18435,13 +18011,7 @@
18435
18011
  ],
18436
18012
  "parameters": [
18437
18013
  {
18438
- "name": "id",
18439
- "in": "path",
18440
- "required": true,
18441
- "description": "The ID of the wiki page version.",
18442
- "schema": {
18443
- "type": "integer"
18444
- }
18014
+ "$ref": "#/components/parameters/idPath"
18445
18015
  }
18446
18016
  ],
18447
18017
  "responses": {
@@ -18530,13 +18100,7 @@
18530
18100
  "description": "You must be Admin+. If editing an Admin+, you must be Owner+.",
18531
18101
  "parameters": [
18532
18102
  {
18533
- "name": "id",
18534
- "in": "path",
18535
- "required": true,
18536
- "description": "The ID of the user.",
18537
- "schema": {
18538
- "type": "integer"
18539
- }
18103
+ "$ref": "#/components/parameters/idPath"
18540
18104
  }
18541
18105
  ],
18542
18106
  "requestBody": {
@@ -18563,7 +18127,7 @@
18563
18127
  "type": "string"
18564
18128
  },
18565
18129
  "user[base_upload_limit]": {
18566
- "type": "number"
18130
+ "type": "integer"
18567
18131
  },
18568
18132
  "user[enable_privacy_mode]": {
18569
18133
  "type": "boolean"
@@ -18623,13 +18187,7 @@
18623
18187
  "description": "You must have the bd staff user flag. Cannot be used on staff.",
18624
18188
  "parameters": [
18625
18189
  {
18626
- "name": "id",
18627
- "in": "path",
18628
- "required": true,
18629
- "description": "The ID of the user.",
18630
- "schema": {
18631
- "type": "integer"
18632
- }
18190
+ "$ref": "#/components/parameters/idPath"
18633
18191
  }
18634
18192
  ],
18635
18193
  "responses": {
@@ -18657,13 +18215,7 @@
18657
18215
  "description": "You must have the \"Approve Posts\" permission. `commit=Delete` must be set.",
18658
18216
  "parameters": [
18659
18217
  {
18660
- "name": "id",
18661
- "in": "path",
18662
- "required": true,
18663
- "description": "The ID of the post.",
18664
- "schema": {
18665
- "type": "integer"
18666
- }
18218
+ "$ref": "#/components/parameters/idPath"
18667
18219
  }
18668
18220
  ],
18669
18221
  "requestBody": {
@@ -18731,13 +18283,7 @@
18731
18283
  "description": "You must have the \"Approve Posts\" permission.",
18732
18284
  "parameters": [
18733
18285
  {
18734
- "name": "id",
18735
- "in": "path",
18736
- "required": true,
18737
- "description": "The ID of the post.",
18738
- "schema": {
18739
- "type": "integer"
18740
- }
18286
+ "$ref": "#/components/parameters/idPath"
18741
18287
  }
18742
18288
  ],
18743
18289
  "responses": {
@@ -18786,13 +18332,7 @@
18786
18332
  "description": "You must be Janitor+.",
18787
18333
  "parameters": [
18788
18334
  {
18789
- "name": "id",
18790
- "in": "path",
18791
- "required": true,
18792
- "description": "The ID of the post.",
18793
- "schema": {
18794
- "type": "integer"
18795
- }
18335
+ "$ref": "#/components/parameters/idPath"
18796
18336
  }
18797
18337
  ],
18798
18338
  "responses": {
@@ -18841,13 +18381,7 @@
18841
18381
  "description": "You must be Janitor+.",
18842
18382
  "parameters": [
18843
18383
  {
18844
- "name": "id",
18845
- "in": "path",
18846
- "required": true,
18847
- "description": "The ID of the post.",
18848
- "schema": {
18849
- "type": "integer"
18850
- }
18384
+ "$ref": "#/components/parameters/idPath"
18851
18385
  }
18852
18386
  ],
18853
18387
  "responses": {
@@ -18881,13 +18415,7 @@
18881
18415
  "description": "You must have the \"Approve Posts\" permission and be Admin+.",
18882
18416
  "parameters": [
18883
18417
  {
18884
- "name": "id",
18885
- "in": "path",
18886
- "required": true,
18887
- "description": "The ID of the post.",
18888
- "schema": {
18889
- "type": "integer"
18890
- }
18418
+ "$ref": "#/components/parameters/idPath"
18891
18419
  }
18892
18420
  ],
18893
18421
  "requestBody": {
@@ -18950,13 +18478,7 @@
18950
18478
  "description": "You must have the \"Approve Posts\" permission. `commit=Submit`` must be set.",
18951
18479
  "parameters": [
18952
18480
  {
18953
- "name": "id",
18954
- "in": "path",
18955
- "required": true,
18956
- "description": "The ID of the post.",
18957
- "schema": {
18958
- "type": "integer"
18959
- }
18481
+ "$ref": "#/components/parameters/idPath"
18960
18482
  }
18961
18483
  ],
18962
18484
  "requestBody": {
@@ -19008,13 +18530,7 @@
19008
18530
  "description": "You must be Janitor+.",
19009
18531
  "parameters": [
19010
18532
  {
19011
- "name": "id",
19012
- "in": "path",
19013
- "required": true,
19014
- "description": "The ID of the post.",
19015
- "schema": {
19016
- "type": "integer"
19017
- }
18533
+ "$ref": "#/components/parameters/idPath"
19018
18534
  }
19019
18535
  ],
19020
18536
  "responses": {
@@ -19147,13 +18663,13 @@
19147
18663
  "description": "You must have the \"Approve Posts\" permission.",
19148
18664
  "parameters": [
19149
18665
  {
19150
- "$ref": "#/components/parameters/limit"
18666
+ "$ref": "#/components/parameters/limitQuery"
19151
18667
  },
19152
18668
  {
19153
- "$ref": "#/components/parameters/page"
18669
+ "$ref": "#/components/parameters/pageQuery"
19154
18670
  },
19155
18671
  {
19156
- "$ref": "#/components/parameters/id"
18672
+ "$ref": "#/components/parameters/idQuery"
19157
18673
  },
19158
18674
  {
19159
18675
  "name": "search[order]",