From b61c5765c9ada8b0f02ae81c4356e00aff65f8b0 Mon Sep 17 00:00:00 2001 From: Guido Leenders Date: Tue, 17 Nov 2020 08:29:21 +0100 Subject: [PATCH] Numerous fixes to make Swagger parseable and comply with actual data with standard swagger parser of Invantive SQL. --- openapi.json | 3410 ++++++++++++++++++++++++-------------------------- 1 file changed, 1625 insertions(+), 1785 deletions(-) diff --git a/openapi.json b/openapi.json index 149f5b2..91917a3 100644 --- a/openapi.json +++ b/openapi.json @@ -17,14 +17,14 @@ "/categories.json": { "get": { "summary": "Get a list of categories", - "description": "The Categories endpoint returns a list of all the categories for\nyour discourse site that you have access to.\n", + "description": "The Categories endpoint returns a list of all the categories for your discourse site that you have access to.", "parameters": [], "tags": [ "Categories" ], "responses": { "200": { - "description": "A category_list object that contains an array of categories\n", + "description": "A category_list object that contains an array of categories", "content": { "application/json": { "schema": { @@ -288,7 +288,7 @@ }, "/c/{id}.json": { "get": { - "description": "Get a list of topics in the specified category\n", + "description": "Get a list of topics in the specified category", "tags": [ "Categories" ], @@ -468,7 +468,7 @@ }, "/categories/{id}": { "put": { - "description": "Update a single category\n", + "description": "Update a single category", "tags": [ "Categories" ], @@ -578,8 +578,8 @@ }, "available_groups": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -643,7 +643,7 @@ }, "/posts.json": { "get": { - "description": "Get a list of the latest posts across topics\n", + "description": "Get a list of the latest posts across topics", "tags": [ "Posts" ], @@ -782,7 +782,6 @@ "items": { "required": [ "id", - "hidden", "can_act" ], "properties": { @@ -845,7 +844,7 @@ } }, "post": { - "description": "Create a new topic, a new post, or a private message\n", + "description": "Create a new topic, a new post, or a private message", "tags": [ "Posts", "Topics" @@ -861,7 +860,7 @@ "properties": { "title": { "type": "string", - "description": "required if creating a new topic or new private message\n" + "description": "required if creating a new topic or new private message" }, "topic_id": { "type": "integer", @@ -872,16 +871,16 @@ }, "category": { "type": "integer", - "description": "optional if creating a new topic,\nignored if creating a new post\n" + "description": "optional if creating a new topic, ignored if creating a new post" }, "target_recipients": { "type": "string", - "description": "required for private message, comma separated\n", + "description": "required for private message, comma separated", "example": "discourse1,discourse2" }, "archetype": { "type": "string", - "description": "required for private message\n", + "description": "required for private message", "example": "private_message", "enum": [ "private_message" @@ -889,7 +888,7 @@ }, "created_at": { "type": "string", - "description": "pick a date other than the default current time\n", + "description": "pick a date other than the default current time", "example": "2017-01-31" } } @@ -1074,7 +1073,7 @@ }, "/posts/{id}.json": { "get": { - "description": "Get a single post\n", + "description": "Get a single post", "tags": [ "Posts" ], @@ -1196,8 +1195,8 @@ }, "actions_summary": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -1246,7 +1245,7 @@ } }, "put": { - "description": "Update a single post\n", + "description": "Update a single post", "tags": [ "Posts" ], @@ -1498,7 +1497,7 @@ }, "/posts/{id}/locked": { "put": { - "description": "Lock a post from being edited\n", + "description": "Lock a post from being edited", "tags": [ "Posts" ], @@ -1521,7 +1520,7 @@ "locked": { "type": "boolean", "example": true, - "description": "True or False\n" + "description": "True or False" } } } @@ -1537,7 +1536,7 @@ }, "/post_actions": { "post": { - "description": "Like a post and other actions\n", + "description": "Like a post and other actions", "tags": [ "Posts" ], @@ -1574,7 +1573,7 @@ }, "/post_actions/{id}": { "delete": { - "description": "Un-like a post\n", + "description": "Un-like a post", "tags": [ "Posts" ], @@ -1611,7 +1610,7 @@ }, "/t/{id}/posts.json": { "get": { - "description": "Get specific posts in a topic. Used for infinite scrolling or pagination.\n", + "description": "Get specific posts in a topic. Used for infinite scrolling or pagination.", "tags": [ "Topics" ], @@ -1653,7 +1652,7 @@ }, "/t/{id}.json": { "get": { - "description": "Get a single topic\n", + "description": "Get a single topic", "tags": [ "Topics" ], @@ -1788,8 +1787,8 @@ }, "actions_summary": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -1885,8 +1884,8 @@ }, "stream": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -1899,14 +1898,14 @@ }, "timeline_lookup": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "properties": { "0": { "type": "array", "uniqueItems": true, - "minItems": null, + "minItems": 0, "items": { "type": "object" } @@ -2108,7 +2107,6 @@ "bumped_at", "unseen", "pinned", - "excerpt", "visible", "closed", "archived", @@ -2171,8 +2169,7 @@ "type": "object" }, "excerpt": { - "type": "string", - "minLength": 1 + "type": "string" }, "visible": { "type": "boolean" @@ -2311,7 +2308,7 @@ } }, "delete": { - "description": "Remove a single topic\n", + "description": "Remove a single topic", "tags": [ "Topics" ], @@ -2324,14 +2321,14 @@ ], "responses": { "200": { - "description": "delete topic response is empty, just a status code\n" + "description": "delete topic response is empty, just a status code" } } } }, "/t/{slug}/{id}.json": { "put": { - "description": "Update a single topic\n", + "description": "Update a single topic", "tags": [ "Topics" ], @@ -2415,7 +2412,7 @@ }, "/t/{id}/invite": { "post": { - "description": "Invite user to topic\n", + "description": "Invite user to topic", "tags": [ "Invites", "Topics" @@ -2484,7 +2481,7 @@ }, "/t/{id}/bookmark": { "put": { - "description": "Bookmark a topic\n", + "description": "Bookmark a topic", "tags": [ "Topics" ], @@ -2504,7 +2501,7 @@ }, "/t/{id}/status": { "put": { - "description": "Update a topic's status\n", + "description": "Update a topic's status", "tags": [ "Topics" ], @@ -2528,7 +2525,7 @@ "status": { "type": "string", "example": "pinned", - "description": "A lowercase string. Valid values shown above.\n", + "description": "A lowercase string. Valid values shown above.", "enum": [ "closed", "pinned", @@ -2540,12 +2537,12 @@ "enabled": { "type": "boolean", "example": true, - "description": "This would be true or false\n" + "description": "This would be true or false" }, "until": { "type": "string", "example": "2018-12-31", - "description": "Only required for pinned and pinned_globally.\n" + "description": "Only required for pinned and pinned_globally." } } } @@ -2577,7 +2574,17 @@ }, "/topics/private-messages/{username}.json": { "get": { - "description": "Get a list of private messages for a user\n", + "description": "Get a list of private messages for a user", + "parameters": [ + { + "name": "username", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], "tags": [ "Private Messages" ], @@ -2814,7 +2821,17 @@ }, "/topics/private-messages-sent/{username}.json": { "get": { - "description": "Get a list of private messages sent\n", + "description": "Get a list of private messages sent", + "parameters": [ + { + "name": "username", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], "tags": [ "Private Messages" ], @@ -3076,7 +3093,7 @@ }, "/notifications.json": { "get": { - "description": "Get notifications for the specified user\n", + "description": "Get notifications for the specified user", "tags": [ "Notifications" ], @@ -3195,7 +3212,7 @@ }, "/notifications/mark-read.json": { "put": { - "description": "Mark notifications as read\n", + "description": "Mark notifications as read", "tags": [ "Notifications" ], @@ -3207,7 +3224,7 @@ "properties": { "id": { "type": "integer", - "description": "(optional) Leave off to mark all notifications as read\n" + "description": "(optional) Leave off to mark all notifications as read" } } } @@ -3236,7 +3253,7 @@ }, "/invites": { "post": { - "description": "Invite a user by email to join your forum\n", + "description": "Invite a user by email to join your forum", "tags": [ "Invites" ], @@ -3284,7 +3301,7 @@ }, "/invites/link": { "post": { - "description": "Generate an invite link but don't send an email\n", + "description": "Generate an invite link but don't send an email", "tags": [ "Invites" ], @@ -3328,13 +3345,13 @@ }, "/tag_groups.json": { "get": { - "description": "Get a list of tag groups\n", + "description": "Get a list of tag groups", "tags": [ "Tags" ], "responses": { "200": { - "description": "List of tag groups response\n", + "description": "List of tag groups response", "content": { "application/json": { "schema": { @@ -3374,7 +3391,7 @@ } }, "post": { - "description": "Create a new tag group\n", + "description": "Create a new tag group", "tags": [ "Tags" ], @@ -3403,7 +3420,7 @@ }, "responses": { "200": { - "description": "Create tab group response\n", + "description": "Create tab group response", "content": { "application/json": { "schema": { @@ -3456,7 +3473,7 @@ }, "/tag_groups/{id}.json": { "get": { - "description": "Get a single tag group\n", + "description": "Get a single tag group", "tags": [ "Tags" ], @@ -3469,7 +3486,7 @@ ], "responses": { "200": { - "description": "Tag group response\n", + "description": "Tag group response", "content": { "application/json": { "schema": { @@ -3513,7 +3530,7 @@ } }, "put": { - "description": "Update an existing tag group\n", + "description": "Update an existing tag group", "tags": [ "Tags" ], @@ -3549,7 +3566,7 @@ }, "responses": { "200": { - "description": "Create tab group response\n", + "description": "Create tab group response", "content": { "application/json": { "schema": { @@ -3599,7 +3616,7 @@ }, "/users/{username}.json": { "get": { - "description": "Get a single user by username\n", + "description": "Get a single user by username", "tags": [ "Users" ], @@ -3621,8 +3638,8 @@ "properties": { "user_badges": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -3798,8 +3815,8 @@ }, "featured_user_badge_ids": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -3813,7 +3830,6 @@ "username", "avatar_template", "last_posted_at", - "last_seen_at", "created_at", "can_edit", "can_edit_username", @@ -3842,260 +3858,11 @@ }, "/u/by-external/{external_id}.json": { "get": { - "description": "Get user by 'Discourse SSO' external ID\n", - "tags": [ - "Users" - ], - "parameters": [ - { - "name": "external_id", - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "description": "get user response", - "content": { - "application/json": { - "schema": { - "description": "", - "type": "object", - "properties": { - "user_badges": { - "type": "array", - "uniqueItems": null, - "minItems": null, - "items": { - "type": "object" - } - }, - "user": { - "type": "object", - "properties": { - "id": { - "type": "number" - }, - "username": { - "type": "string", - "minLength": 1 - }, - "avatar_template": { - "type": "string", - "minLength": 1 - }, - "name": { - "type": "object" - }, - "last_posted_at": { - "type": "string", - "minLength": 1 - }, - "last_seen_at": { - "type": "string", - "minLength": 1 - }, - "created_at": { - "type": "string", - "minLength": 1 - }, - "website_name": { - "type": "object" - }, - "can_edit": { - "type": "boolean" - }, - "can_edit_username": { - "type": "boolean" - }, - "can_edit_email": { - "type": "boolean" - }, - "can_edit_name": { - "type": "boolean" - }, - "can_send_private_messages": { - "type": "boolean" - }, - "can_send_private_message_to_user": { - "type": "boolean" - }, - "trust_level": { - "type": "number" - }, - "moderator": { - "type": "boolean" - }, - "admin": { - "type": "boolean" - }, - "title": { - "type": "object" - }, - "uploaded_avatar_id": { - "type": "object" - }, - "badge_count": { - "type": "number" - }, - "custom_fields": { - "type": "object" - }, - "pending_count": { - "type": "number" - }, - "profile_view_count": { - "type": "number" - }, - "primary_group_name": { - "type": "object" - }, - "primary_group_flair_url": { - "type": "object" - }, - "primary_group_flair_bg_color": { - "type": "object" - }, - "primary_group_flair_color": { - "type": "object" - }, - "invited_by": { - "type": "object" - }, - "groups": { - "type": "array", - "uniqueItems": true, - "minItems": 1, - "items": { - "required": [ - "id", - "automatic", - "name", - "user_count", - "alias_level", - "visible", - "automatic_membership_retroactive", - "primary_group", - "has_messages", - "is_member", - "mentionable" - ], - "properties": { - "id": { - "type": "number" - }, - "automatic": { - "type": "boolean" - }, - "name": { - "type": "string", - "minLength": 1 - }, - "user_count": { - "type": "number" - }, - "alias_level": { - "type": "number" - }, - "visible": { - "type": "boolean" - }, - "automatic_membership_email_domains": { - "type": "object" - }, - "automatic_membership_retroactive": { - "type": "boolean" - }, - "primary_group": { - "type": "boolean" - }, - "title": { - "type": "object" - }, - "grant_trust_level": { - "type": "object" - }, - "notification_level": { - "type": "object" - }, - "has_messages": { - "type": "boolean" - }, - "is_member": { - "type": "boolean" - }, - "mentionable": { - "type": "boolean" - }, - "flair_url": { - "type": "object" - }, - "flair_bg_color": { - "type": "object" - }, - "flair_color": { - "type": "object" - } - } - } - }, - "featured_user_badge_ids": { - "type": "array", - "uniqueItems": null, - "minItems": null, - "items": { - "type": "object" - } - }, - "card_badge": { - "type": "object" - } - }, - "required": [ - "id", - "username", - "avatar_template", - "last_posted_at", - "last_seen_at", - "created_at", - "can_edit", - "can_edit_username", - "can_edit_email", - "can_edit_name", - "can_send_private_messages", - "can_send_private_message_to_user", - "trust_level", - "moderator", - "admin", - "badge_count", - "custom_fields", - "pending_count", - "profile_view_count", - "groups", - "featured_user_badge_ids" - ] - } - } - } - } - } - } - } - } - }, - "/u/by-external/{provider}/{external_id}.json": { - "get": { - "description": "Get user by identity provider external ID\n", + "description": "Get a single user by SSO external ID", "tags": [ "Users" ], "parameters": [ - { - "name": "provider", - "in": "path", - "required": true, - "description": "Authentication provider name. Can be found in the provider's callback URL: `/auth/{provider}/callback`\n" - }, { "name": "external_id", "in": "path", @@ -4113,8 +3880,8 @@ "properties": { "user_badges": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -4290,8 +4057,8 @@ }, "featured_user_badge_ids": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -4334,7 +4101,7 @@ }, "/uploads.json": { "post": { - "description": "Upload a file like an image or an avatar\n", + "description": "Upload a file like an image or an avatar", "tags": [ "Upload" ], @@ -4350,7 +4117,7 @@ "type": { "type": "string", "example": "composer", - "description": "a lowercase string with numbers but no spaces. Set to 'avatar' if uploading an avatar\n", + "description": "a lowercase string with numbers but no spaces. Set to 'avatar' if uploading an avatar", "enum": [ "avatar", "profile_background", @@ -4380,7 +4147,7 @@ }, "responses": { "200": { - "description": "if async will return '{success: true}'\n", + "description": "if async will return '{success: true}'", "content": { "application/json": { "schema": { @@ -4432,7 +4199,7 @@ }, "/users/{username}/preferences/avatar/pick": { "put": { - "description": "Update avatar\n", + "description": "Update avatar", "tags": [ "Users" ], @@ -4461,7 +4228,7 @@ }, "responses": { "200": { - "description": "update avatar response\n", + "description": "update avatar response", "content": { "application/json": { "schema": { @@ -4481,7 +4248,7 @@ }, "/users/{username}/preferences/email": { "put": { - "description": "Update email\n", + "description": "Update email", "tags": [ "Users" ], @@ -4512,7 +4279,7 @@ }, "/users": { "post": { - "description": "Creates a new user\n", + "description": "Creates a new user", "tags": [ "Users" ], @@ -4584,9 +4351,9 @@ } } }, - "/directory_items.json?period={period}&order={order}": { + "/directory_items.json?period={period}": { "get": { - "description": "Get a public list of users\n", + "description": "Get a public list of users", "tags": [ "Users" ], @@ -4610,7 +4377,7 @@ { "name": "order", "in": "query", - "required": true, + "required": false, "schema": { "type": "string", "enum": [ @@ -4643,7 +4410,7 @@ ], "responses": { "200": { - "description": "public list of users response\n", + "description": "public list of users response", "content": { "application/json": { "schema": { @@ -4739,20 +4506,52 @@ }, "/tags": { "get": { - "description": "Get a list of tags\n", + "description": "Get a list of tags", "tags": [ "Tags" ], "responses": { "200": { - "description": "tag list response\n" + "description": "tag list response", + "content": { + "application/json": { + "schema": { + "description": "", + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "properties": { + "id": { + "type": "string" + }, + "text": { + "type": "string" + }, + "count": { + "type": "number" + }, + "pm_count": { + "type": "number" + }, + "target_tag": { + "type": "string" + } + } + } + } + } + } + } + } } } } }, - "/tag/{tag}": { + "/tags/{tag}": { "get": { - "description": "Get a specific tag\n", + "description": "Get a specific tag", "tags": [ "Tags" ], @@ -4768,14 +4567,14 @@ ], "responses": { "200": { - "description": "tag response\n" + "description": "tag response" } } } }, "/search/query": { "get": { - "description": "Search for something\n", + "description": "Search for something", "tags": [ "Search" ], @@ -4983,8 +4782,8 @@ }, "posters": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -4994,16 +4793,16 @@ }, "users": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } }, "categories": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -5022,24 +4821,24 @@ }, "post_ids": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } }, "user_ids": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } }, "category_ids": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -5061,13 +4860,13 @@ }, "/admin/email.json": { "get": { - "description": "Show email settings\n", + "description": "Show email settings", "tags": [ "Admin Emails" ], "responses": { "200": { - "description": "email settings response\n", + "description": "email settings response", "content": { "application/json": { "schema": { @@ -5103,13 +4902,13 @@ }, "/admin/customize/email_templates.json": { "get": { - "description": "Show list of email templates\n", + "description": "Show list of email templates", "tags": [ "Admin Emails" ], "responses": { "200": { - "description": "show email templates response\n", + "description": "show email templates response", "content": { "application/json": { "schema": { @@ -5148,7 +4947,7 @@ }, "/admin/users/{id}/suspend": { "put": { - "description": "Suspend a user\n", + "description": "Suspend a user", "tags": [ "Admin" ], @@ -5190,7 +4989,7 @@ }, "/admin/users/{id}/unsuspend": { "put": { - "description": "Unsuspend a user\n", + "description": "Unsuspend a user", "tags": [ "Admin" ], @@ -5210,7 +5009,7 @@ }, "/admin/users/{id}/silence": { "put": { - "description": "Silence a user\n", + "description": "Silence a user", "tags": [ "Admin" ], @@ -5300,7 +5099,7 @@ }, "/admin/users/{id}/unsilence": { "put": { - "description": "Unsilence a user\n", + "description": "Unsilence a user", "tags": [ "Admin" ], @@ -5346,7 +5145,7 @@ }, "/admin/users/{id}/activate": { "put": { - "description": "Activate a user\n", + "description": "Activate a user", "tags": [ "Admin" ], @@ -5378,7 +5177,7 @@ }, "/admin/users/{id}/anonymize": { "put": { - "description": "Anonymize a user's account by changing their username and email address to random values. This is non-reversable\n", + "description": "Anonymize a user's account by changing their username and email address to random values. This is non-reversable.", "tags": [ "Admin" ], @@ -5413,7 +5212,7 @@ }, "/admin/api/keys": { "post": { - "description": "Generate an api_key for a user\n", + "description": "Generate an api_key for a user.", "tags": [ "Admin" ], @@ -5502,7 +5301,7 @@ }, "/admin/users/{id}/groups": { "post": { - "description": "Assign a group to a user\n", + "description": "Assign a group to a user.", "tags": [ "Admin" ], @@ -5539,7 +5338,7 @@ }, "/admin/users/{id}/groups/{group_id}": { "delete": { - "description": "Remove a group assigned to a user\n", + "description": "Remove a group assigned to a user.", "tags": [ "Admin" ], @@ -5557,14 +5356,14 @@ ], "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/users/{id}.json": { "get": { - "description": "Get a specific user by id. Returns more info than the public user route.\n", + "description": "Get a specific user by id. Returns more info than the public user route.", "tags": [ "Admin", "Users" @@ -5578,7 +5377,7 @@ ], "responses": { "200": { - "description": "Successful get response\n", + "description": "Successful get response", "content": { "application/json": { "schema": { @@ -5914,7 +5713,7 @@ } }, "delete": { - "description": "Delete a user\n", + "description": "Delete a user.", "tags": [ "Users" ], @@ -5953,7 +5752,7 @@ }, "responses": { "200": { - "description": "Successful delete response\n", + "description": "Successful delete response", "content": { "application/json": { "schema": { @@ -5969,7 +5768,7 @@ } }, "403": { - "description": "Could not delete user response\n", + "description": "Could not delete user response", "content": { "application/json": { "schema": { @@ -5981,7 +5780,7 @@ }, "message": { "type": "string", - "example": "You either don't have permission to delete this user or they have existing posts\n" + "example": "You either don't have permission to delete this user or they have existing posts." } } } @@ -5993,7 +5792,7 @@ }, "/admin/users/list/{flag}.json": { "get": { - "description": "Returns a list of users\n", + "description": "Returns a list of users", "tags": [ "Users" ], @@ -6041,7 +5840,7 @@ "required": false, "schema": { "type": "boolean", - "description": "optional. defaults to descending.\n" + "description": "Optional, defaults to descending." } }, { @@ -6177,7 +5976,7 @@ }, "/groups.json": { "get": { - "description": "Get some groups\n", + "description": "Get some groups.", "tags": [ "Groups" ], @@ -6187,102 +5986,107 @@ "content": { "application/json": { "schema": { - "type": "array", "description": "", - "minItems": 1, - "uniqueItems": true, - "items": { - "type": "object", - "required": [ - "id", - "automatic", - "name", - "user_count", - "automatic_membership_retroactive", - "primary_group" - ], - "properties": { - "id": { - "type": "number" - }, - "automatic": { - "type": "boolean" - }, - "name": { - "type": "string", - "minLength": 1 - }, - "display_name": { - "type": "string" - }, - "user_count": { - "type": "number" - }, - "mentionable_level": { - "type": "number" - }, - "messageable_level": { - "type": "number" - }, - "visibility_level": { - "type": "number" - }, - "automatic_membership_email_domains": { - "type": "object" - }, - "automatic_membership_retroactive": { - "type": "boolean" - }, - "primary_group": { - "type": "boolean" - }, - "title": { - "type": "object" - }, - "grant_trust_level": { - "type": "object" - }, - "incoming_email": { - "type": "object" - }, - "has_messages": { - "type": "boolean" - }, - "flair_url": { - "type": "object" - }, - "flair_bg_color": { - "type": "object" - }, - "flair_color": { - "type": "object" - }, - "bio_raw": { - "type": "object" - }, - "bio_cooked": { - "type": "object" - }, - "public_admission": { - "type": "boolean" - }, - "public_exit": { - "type": "boolean" - }, - "allow_membership_requests": { - "type": "boolean" - }, - "full_name": { - "type": "string" - }, - "default_notification_level": { - "type": "number" - }, - "membership_request_template": { - "type": "object" - }, - "is_group_user": { - "type": "boolean" + "type": "object", + "properties": { + "groups": { + "type": "array", + "description": "", + "minItems": 1, + "uniqueItems": true, + "items": { + "type": "object", + "required": [ + "id", + "automatic", + "name", + "user_count", + "primary_group" + ], + "properties": { + "id": { + "type": "number" + }, + "automatic": { + "type": "boolean" + }, + "name": { + "type": "string", + "minLength": 1 + }, + "display_name": { + "type": "string" + }, + "user_count": { + "type": "number" + }, + "mentionable_level": { + "type": "number" + }, + "messageable_level": { + "type": "number" + }, + "visibility_level": { + "type": "number" + }, + "automatic_membership_email_domains": { + "type": "object" + }, + "automatic_membership_retroactive": { + "type": "boolean" + }, + "primary_group": { + "type": "boolean" + }, + "title": { + "type": "object" + }, + "grant_trust_level": { + "type": "object" + }, + "incoming_email": { + "type": "object" + }, + "has_messages": { + "type": "boolean" + }, + "flair_url": { + "type": "object" + }, + "flair_bg_color": { + "type": "object" + }, + "flair_color": { + "type": "object" + }, + "bio_raw": { + "type": "object" + }, + "bio_cooked": { + "type": "object" + }, + "public_admission": { + "type": "boolean" + }, + "public_exit": { + "type": "boolean" + }, + "allow_membership_requests": { + "type": "boolean" + }, + "full_name": { + "type": "string" + }, + "default_notification_level": { + "type": "number" + }, + "membership_request_template": { + "type": "object" + }, + "is_group_user": { + "type": "boolean" + } + } } } } @@ -6295,7 +6099,17 @@ }, "/groups/{name}.json": { "get": { - "description": "Get a specific group\n", + "description": "Get a specific group.", + "parameters": [ + { + "name": "name", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], "tags": [ "Groups" ], @@ -6315,7 +6129,6 @@ "automatic", "name", "user_count", - "automatic_membership_retroactive", "primary_group" ], "properties": { @@ -6430,7 +6243,7 @@ }, "/groups/{id}.json": { "put": { - "description": "Update a group\n", + "description": "Update a group.", "tags": [ "Groups" ], @@ -6470,7 +6283,7 @@ }, "/admin/groups": { "post": { - "description": "Create a group\n", + "description": "Create a group.", "tags": [ "Admin", "Groups" @@ -6587,7 +6400,7 @@ }, "/admin/groups/{group_id}.json": { "delete": { - "description": "Delete a group\n", + "description": "Delete a group.", "tags": [ "Admin", "Groups" @@ -6613,7 +6426,17 @@ }, "/groups/{group_name}/members.json": { "get": { - "description": "Get some group members\n", + "description": "Get some group members.", + "parameters": [ + { + "name": "group_name", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], "tags": [ "Admin", "Groups" @@ -6655,8 +6478,8 @@ }, "owners": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -6691,7 +6514,7 @@ "/groups/{group_id}/members.json": { "put": { "summary": "Add user(s) to a group", - "description": "Add user(s) to a group (comma separated)\n", + "description": "Add user(s) to a group (comma separated).", "tags": [ "Admin", "Groups" @@ -6716,7 +6539,7 @@ }, "responses": { "200": { - "description": "add user to group response\n", + "description": "Add user to group response.", "content": { "application/json": { "schema": { @@ -6738,7 +6561,7 @@ }, "delete": { "summary": "Remove user(s) from a group", - "description": "You may use one of the following request body params to specify the user(s) to remove.\n", + "description": "You may use one of the following request body params to specify the user(s) to remove.", "tags": [ "Admin", "Groups" @@ -6798,7 +6621,7 @@ }, "/latest.json": { "get": { - "description": "Get the latest topics\n", + "description": "Get the latest topics", "tags": [ "Topics" ], @@ -6896,7 +6719,6 @@ "bumped_at", "unseen", "pinned", - "excerpt", "visible", "closed", "archived", @@ -6962,8 +6784,7 @@ "type": "object" }, "excerpt": { - "type": "string", - "minLength": 1 + "type": "string" }, "visible": { "type": "boolean" @@ -7050,7 +6871,7 @@ }, "/top.json": { "get": { - "description": "Get the top topics\n", + "description": "Get the top topics", "tags": [ "Topics" ], @@ -7129,16 +6950,10 @@ "bumped", "bumped_at", "unseen", - "last_read_post_number", - "unread", - "new_posts", "pinned", "visible", "closed", "archived", - "notification_level", - "bookmarked", - "liked", "views", "like_count", "has_summary", @@ -7255,7 +7070,6 @@ "minItems": 1, "items": { "required": [ - "extras", "description", "user_id" ], @@ -7297,7 +7111,7 @@ }, "/top/{flag}.json": { "get": { - "description": "Get the top topics filtered by specified flag\n", + "description": "Get the top topics filtered by specified flag", "tags": [ "Topics" ], @@ -7328,7 +7142,7 @@ }, "/session/forgot_password": { "post": { - "description": "Send password reset email\n", + "description": "Send password reset email", "tags": [ "Password Reset" ], @@ -7351,7 +7165,7 @@ }, "responses": { "200": { - "description": "send password reset email response\n", + "description": "send password reset email response", "content": { "application/json": { "schema": { @@ -7373,7 +7187,7 @@ }, "/users/password-reset/{token}": { "put": { - "description": "Create a new password\n", + "description": "Create a new password", "tags": [ "Password Reset" ], @@ -7400,14 +7214,14 @@ }, "responses": { "200": { - "description": "password has been reset response\n" + "description": "password has been reset response" } } } }, "/admin/site_settings.json": { "get": { - "description": "Show site settings\n", + "description": "Show site settings", "tags": [ "Admin" ], @@ -7428,12 +7242,8 @@ "required": [ "setting", "description", - "default", "type", - "value", - "category", - "preview", - "translate_names" + "category" ], "properties": { "setting": { @@ -7490,8 +7300,8 @@ }, "choices": { "type": "array", - "uniqueItems": null, - "minItems": null, + "uniqueItems": false, + "minItems": 0, "items": { "type": "object" } @@ -7517,7 +7327,7 @@ }, "/admin/site_settings/title": { "put": { - "description": "Update the site title\n", + "description": "Update the site title.", "tags": [ "Site Settings Required" ], @@ -7540,14 +7350,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/site_description": { "put": { - "description": "Update the site description\n", + "description": "Update the site description", "tags": [ "Site Settings Required" ], @@ -7570,14 +7380,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/contact_email": { "put": { - "description": "Update the contact email\n", + "description": "Update the contact email", "tags": [ "Site Settings Required" ], @@ -7600,10 +7410,10 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" }, "422": { - "description": "Invalid email address\n", + "description": "Invalid email address", "content": { "application/json": { "schema": { @@ -7625,7 +7435,7 @@ }, "/admin/site_settings/contact_url": { "put": { - "description": "Update the contact url\n", + "description": "Update the contact url", "tags": [ "Site Settings Required" ], @@ -7648,14 +7458,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/notification_email": { "put": { - "description": "Update the notification email\n", + "description": "Update the notification email", "tags": [ "Site Settings Required" ], @@ -7678,14 +7488,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/site_contact_username": { "put": { - "description": "Update the site contact username\n", + "description": "Update the site contact username", "tags": [ "Site Settings Required" ], @@ -7708,14 +7518,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/logo_url": { "put": { - "description": "Update logo url\n", + "description": "Update logo url", "tags": [ "Site Settings Required" ], @@ -7738,14 +7548,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/logo_small_url": { "put": { - "description": "Update the small logo url\n", + "description": "Update the small logo url", "tags": [ "Site Settings Required" ], @@ -7768,14 +7578,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_logo_url": { "put": { - "description": "Update the digest logo url\n", + "description": "Update the digest logo url", "tags": [ "Site Settings Required" ], @@ -7798,14 +7608,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/mobile_logo_url": { "put": { - "description": "Update the mobile logo url\n", + "description": "Update the mobile logo url", "tags": [ "Site Settings Required" ], @@ -7828,14 +7638,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/favicon_url": { "put": { - "description": "Update the favicon url\n", + "description": "Update the favicon url", "tags": [ "Site Settings Required" ], @@ -7858,14 +7668,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/apple_touch_icon_url": { "put": { - "description": "Update the apple touch icon url\n", + "description": "Update the apple touch icon url", "tags": [ "Site Settings Required" ], @@ -7888,14 +7698,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_opengraph_image_url": { "put": { - "description": "Update the default opengraph image url\n", + "description": "Update the default opengraph image url.", "tags": [ "Site Settings Required" ], @@ -7918,14 +7728,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/twitter_summary_large_image_url": { "put": { - "description": "Update the twitter summary large image url\n", + "description": "Update the twitter summary large image url", "tags": [ "Site Settings Required" ], @@ -7948,14 +7758,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/exclude_rel_nofollow_domains": { "put": { - "description": "Update the exclude rel nofollow domains\n", + "description": "Update the exclude rel nofollow domains", "tags": [ "Site Settings Required" ], @@ -7969,7 +7779,7 @@ ], "properties": { "exclude_rel_nofollow_domains": { - "description": "pipe delimited\n", + "description": "pipe delimited", "type": "string" } } @@ -7979,14 +7789,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/company_short_name": { "put": { - "description": "Update the company short name\n", + "description": "Update the company short name", "tags": [ "Site Settings Required" ], @@ -8009,14 +7819,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/company_full_name": { "put": { - "description": "Update the company full name\n", + "description": "Update the company full name", "tags": [ "Site Settings Required" ], @@ -8039,14 +7849,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/company_domain": { "put": { - "description": "Update the company domain\n", + "description": "Update the company domain", "tags": [ "Site Settings Required" ], @@ -8069,14 +7879,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_locale": { "put": { - "description": "Update the default locale\n", + "description": "Update the default locale", "tags": [ "Site Settings Basic Setup" ], @@ -8099,14 +7909,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_user_locale": { "put": { - "description": "Update allow user locale\n", + "description": "Update allow user locale", "tags": [ "Site Settings Basic Setup" ], @@ -8129,14 +7939,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/set_locale_from_accept_language_header": { "put": { - "description": "Update set locale from accept language header\n", + "description": "Update set locale from accept language header", "tags": [ "Site Settings Basic Setup" ], @@ -8159,14 +7969,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/categories_topics": { "put": { - "description": "Update the number of topics to show\n", + "description": "Update the number of topics to show", "tags": [ "Site Settings Basic Setup" ], @@ -8189,14 +7999,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suggested_topics": { "put": { - "description": "Update the number of suggested topics\n", + "description": "Update the number of suggested topics.", "tags": [ "Site Settings Basic Setup" ], @@ -8219,14 +8029,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/limit_suggested_to_category": { "put": { - "description": "Update show topics from the current category\n", + "description": "Update show topics from the current category", "tags": [ "Site Settings Basic Setup" ], @@ -8249,14 +8059,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suggested_topics_max_days_old": { "put": { - "description": "Update suggested topics max days old\n", + "description": "Update suggested topics max days old", "tags": [ "Site Settings Basic Setup" ], @@ -8279,14 +8089,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/track_external_right_clicks": { "put": { - "description": "Update track external right clicks\n", + "description": "Update track external right clicks", "tags": [ "Site Settings Basic Setup" ], @@ -8309,14 +8119,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/ga_universal_tracking_code": { "put": { - "description": "Update Google Universal Analytics tracking code\n", + "description": "Update Google Universal Analytics tracking code", "tags": [ "Site Settings Basic Setup" ], @@ -8339,14 +8149,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/ga_universal_domain_name": { "put": { - "description": "Update Google Universal Analytics domain name\n", + "description": "Update Google Universal Analytics domain name", "tags": [ "Site Settings Basic Setup" ], @@ -8369,14 +8179,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/ga_tracking_code": { "put": { - "description": "Update the OBSOLETE ga tracking code\n", + "description": "Update the OBSOLETE ga tracking code", "tags": [ "Site Settings Basic Setup" ], @@ -8399,14 +8209,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/ga_domain_name": { "put": { - "description": "Update the OBSOLETE ga domain name\n", + "description": "Update the OBSOLETE ga domain name", "tags": [ "Site Settings Basic Setup" ], @@ -8429,14 +8239,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/gtm_container_id": { "put": { - "description": "Update Google Tag Manager container id\n", + "description": "Update Google Tag Manager container id", "tags": [ "Site Settings Basic Setup" ], @@ -8459,14 +8269,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/top_menu": { "put": { - "description": "Update the homepage navigation\n", + "description": "Update the homepage navigation", "tags": [ "Site Settings Basic Setup" ], @@ -8501,14 +8311,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_menu": { "put": { - "description": "Update the post menu items\n", + "description": "Update the post menu items", "tags": [ "Site Settings Basic Setup" ], @@ -8544,14 +8354,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_menu_hidden_items": { "put": { - "description": "Update the post menu hidden items\n", + "description": "Update the post menu hidden items", "tags": [ "Site Settings Basic Setup" ], @@ -8586,14 +8396,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/desktop_category_page_style": { "put": { - "description": "Update the visual style for the /categories page\n", + "description": "Update the visual style for the /categories page", "tags": [ "Site Settings Basic Setup" ], @@ -8621,14 +8431,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/category_colors": { "put": { - "description": "Update a list of hexadecimal color values\n", + "description": "Update a list of hexadecimal color values", "tags": [ "Site Settings Basic Setup" ], @@ -8653,14 +8463,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/category_style": { "put": { - "description": "Update the category style\n", + "description": "Update the category style", "tags": [ "Site Settings Basic Setup" ], @@ -8688,14 +8498,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_mobile_theme": { "put": { - "description": "Update enable mobile theme\n", + "description": "Update enable mobile theme", "tags": [ "Site Settings Basic Setup" ], @@ -8718,14 +8528,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/relative_date_duration": { "put": { - "description": "Update relative date duration\n", + "description": "Update relative date duration", "tags": [ "Site Settings Basic Setup" ], @@ -8748,14 +8558,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/fixed_category_positions": { "put": { - "description": "Update fixed category positions\n", + "description": "Update fixed category positions", "tags": [ "Site Settings Basic Setup" ], @@ -8778,14 +8588,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/fixed_category_positions_on_create": { "put": { - "description": "Update fixed category positions on create\n", + "description": "Update fixed category positions on create", "tags": [ "Site Settings Basic Setup" ], @@ -8808,14 +8618,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_subcategory_list": { "put": { - "description": "Update show subcategory list\n", + "description": "Update show subcategory list", "tags": [ "Site Settings Basic Setup" ], @@ -8838,14 +8648,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_badges": { "put": { - "description": "Update enable the badge system\n", + "description": "Update enable the badge system", "tags": [ "Site Settings Basic Setup" ], @@ -8868,14 +8678,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_whispers": { "put": { - "description": "Update enable whispers\n", + "description": "Update enable whispers", "tags": [ "Site Settings Basic Setup" ], @@ -8898,14 +8708,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/invite_only": { "put": { - "description": "Update invite only\n", + "description": "Update invite only", "tags": [ "Site Settings Login" ], @@ -8928,14 +8738,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/login_required": { "put": { - "description": "Update login required\n", + "description": "Update login required", "tags": [ "Site Settings Login" ], @@ -8958,14 +8768,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/must_approve_users": { "put": { - "description": "Update must approve users\n", + "description": "Update must approve users", "tags": [ "Site Settings Login" ], @@ -8988,14 +8798,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_local_logins": { "put": { - "description": "Update enable_local_logins\n", + "description": "Update enable_local_logins", "tags": [ "Site Settings Login" ], @@ -9018,14 +8828,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_new_registrations": { "put": { - "description": "Update allow new registrations\n", + "description": "Update allow new registrations", "tags": [ "Site Settings Login" ], @@ -9048,14 +8858,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_signup_cta": { "put": { - "description": "Update enable signup cta\n", + "description": "Update enable signup cta", "tags": [ "Site Settings Login" ], @@ -9078,14 +8888,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_google_oauth2_logins": { "put": { - "description": "Update enable Google Oauth2 authentication\n", + "description": "Update enable Google Oauth2 authentication", "tags": [ "Site Settings Login" ], @@ -9108,14 +8918,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/google_oath2_client_id": { "put": { - "description": "Update google oauth2 client id\n", + "description": "Update google oauth2 client id", "tags": [ "Site Settings Login" ], @@ -9138,14 +8948,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/google_oath2_client_secret": { "put": { - "description": "Update google oauth2 client secret\n", + "description": "Update google oauth2 client secret", "tags": [ "Site Settings Login" ], @@ -9168,14 +8978,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_yahoo_logins": { "put": { - "description": "Update enable yahoo logins\n", + "description": "Update enable yahoo logins", "tags": [ "Site Settings Login" ], @@ -9198,14 +9008,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_twitter_logins": { "put": { - "description": "Enable twitter logins\n", + "description": "Enable twitter logins", "tags": [ "Site Settings Login" ], @@ -9228,14 +9038,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/twitter_consumer_key": { "put": { - "description": "twitter consumer key\n", + "description": "twitter consumer key", "tags": [ "Site Settings Login" ], @@ -9258,14 +9068,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/twitter_consumer_secret": { "put": { - "description": "twitter consumer secret\n", + "description": "twitter consumer secret", "tags": [ "Site Settings Login" ], @@ -9288,14 +9098,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_instagram_logins": { "put": { - "description": "enable instagram logins\n", + "description": "enable instagram logins", "tags": [ "Site Settings Login" ], @@ -9318,14 +9128,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/instagram_consumer_key": { "put": { - "description": "instagram consumer key\n", + "description": "instagram consumer key", "tags": [ "Site Settings Login" ], @@ -9348,14 +9158,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/instagram_consumer_secret": { "put": { - "description": "instagram consumer secret\n", + "description": "instagram consumer secret", "tags": [ "Site Settings Login" ], @@ -9378,14 +9188,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_facebook_logins": { "put": { - "description": "enable facebook logins\n", + "description": "enable facebook logins", "tags": [ "Site Settings Login" ], @@ -9408,14 +9218,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/facebook_app_id": { "put": { - "description": "facebook app id\n", + "description": "facebook app id", "tags": [ "Site Settings Login" ], @@ -9438,14 +9248,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/facebook_app_secret": { "put": { - "description": "facebook app secret\n", + "description": "facebook app secret", "tags": [ "Site Settings Login" ], @@ -9468,14 +9278,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/facebook_request_extra_profile_details": { "put": { - "description": "facebook request extra profile details\n", + "description": "facebook request extra profile details", "tags": [ "Site Settings Login" ], @@ -9498,14 +9308,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_github_logins": { "put": { - "description": "enable github logins\n", + "description": "enable github logins", "tags": [ "Site Settings Login" ], @@ -9528,14 +9338,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/github_client_id": { "put": { - "description": "github client id\n", + "description": "github client id", "tags": [ "Site Settings Login" ], @@ -9558,14 +9368,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/github_client_secret": { "put": { - "description": "github client secret\n", + "description": "github client secret", "tags": [ "Site Settings Login" ], @@ -9588,14 +9398,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_sso": { "put": { - "description": "enable sso\n", + "description": "enable sso", "tags": [ "Site Settings Login" ], @@ -9618,14 +9428,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_allows_all_return_paths": { "put": { - "description": "sso allows all return paths\n", + "description": "sso allows all return paths", "tags": [ "Site Settings Login" ], @@ -9648,14 +9458,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_sso_provider": { "put": { - "description": "enable sso provider\n", + "description": "enable sso provider", "tags": [ "Site Settings Login" ], @@ -9678,14 +9488,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/verbose_sso_logging": { "put": { - "description": "verbose sso logging\n", + "description": "verbose sso logging", "tags": [ "Site Settings Login" ], @@ -9708,14 +9518,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_url": { "put": { - "description": "sso url\n", + "description": "sso url", "tags": [ "Site Settings Login" ], @@ -9738,14 +9548,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_secret": { "put": { - "description": "sso secret\n", + "description": "sso secret", "tags": [ "Site Settings Login" ], @@ -9768,14 +9578,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_overrides_bio": { "put": { - "description": "sso overrides bio\n", + "description": "sso overrides bio", "tags": [ "Site Settings Login" ], @@ -9798,14 +9608,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_overrides_email": { "put": { - "description": "sso overrides email\n", + "description": "sso overrides email", "tags": [ "Site Settings Login" ], @@ -9828,14 +9638,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_overrides_username": { "put": { - "description": "sso overrides username\n", + "description": "sso overrides username", "tags": [ "Site Settings Login" ], @@ -9858,14 +9668,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_overrides_name": { "put": { - "description": "sso overrides name\n", + "description": "sso overrides name", "tags": [ "Site Settings Login" ], @@ -9888,14 +9698,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_overrides_avatar": { "put": { - "description": "sso overrides avatar\n", + "description": "sso overrides avatar", "tags": [ "Site Settings Login" ], @@ -9918,14 +9728,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sso_not_approved_url": { "put": { - "description": "sso not approved url\n", + "description": "sso not approved url", "tags": [ "Site Settings Login" ], @@ -9948,14 +9758,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_domains_blacklist": { "put": { - "description": "email domains blacklist\n", + "description": "email domains blacklist", "tags": [ "Site Settings Login" ], @@ -9969,7 +9779,7 @@ ], "properties": { "email_domains_blacklist": { - "description": "pipe delimited\n", + "description": "pipe delimited", "type": "string" } } @@ -9979,14 +9789,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_domains_whitelist": { "put": { - "description": "email domains whitelist\n", + "description": "email domains whitelist", "tags": [ "Site Settings Login" ], @@ -10000,7 +9810,7 @@ ], "properties": { "email_domains_whitelist": { - "description": "pipe delimited\n", + "description": "pipe delimited", "type": "string" } } @@ -10010,14 +9820,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/forgot_password_strict": { "put": { - "description": "forgot password strict\n", + "description": "forgot password strict", "tags": [ "Site Settings Login" ], @@ -10040,14 +9850,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/log_out_strict": { "put": { - "description": "log out strict\n", + "description": "log out strict", "tags": [ "Site Settings Login" ], @@ -10070,14 +9880,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pending_users_reminder_delay": { "put": { - "description": "pending users reminder delay\n", + "description": "pending users reminder delay", "tags": [ "Site Settings Login" ], @@ -10100,14 +9910,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/maximum_session_age": { "put": { - "description": "maximum session age\n", + "description": "maximum session age", "tags": [ "Site Settings Login" ], @@ -10130,14 +9940,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_username_length": { "put": { - "description": "min username length\n", + "description": "min username length", "tags": [ "Site Settings Users" ], @@ -10160,14 +9970,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_username_length": { "put": { - "description": "max username length\n", + "description": "max username length", "tags": [ "Site Settings Users" ], @@ -10190,14 +10000,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/reserved_usernames": { "put": { - "description": "reserved usernames\n", + "description": "reserved usernames", "tags": [ "Site Settings Users" ], @@ -10211,7 +10021,7 @@ ], "properties": { "reserved_usernames": { - "description": "pipe delimited\n", + "description": "pipe delimited", "type": "string" } } @@ -10221,14 +10031,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_password_length": { "put": { - "description": "min password length\n", + "description": "min password length", "tags": [ "Site Settings Users" ], @@ -10251,14 +10061,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_admin_password_length": { "put": { - "description": "min admin password length\n", + "description": "min admin password length", "tags": [ "Site Settings Users" ], @@ -10281,14 +10091,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/block_common_passwords": { "put": { - "description": "block common passwords\n", + "description": "block common passwords", "tags": [ "Site Settings Users" ], @@ -10311,14 +10121,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/username_change_period": { "put": { - "description": "username change period\n", + "description": "username change period", "tags": [ "Site Settings Users" ], @@ -10341,14 +10151,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_editable": { "put": { - "description": "email editable\n", + "description": "email editable", "tags": [ "Site Settings Users" ], @@ -10371,14 +10181,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/logout_redirect": { "put": { - "description": "logout redirect\n", + "description": "logout redirect", "tags": [ "Site Settings Users" ], @@ -10401,14 +10211,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/full_name_required": { "put": { - "description": "full name required\n", + "description": "full name required", "tags": [ "Site Settings Users" ], @@ -10431,14 +10241,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_names": { "put": { - "description": "enable names\n", + "description": "enable names", "tags": [ "Site Settings Users" ], @@ -10461,14 +10271,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/invite_expiry_days": { "put": { - "description": "invite expiry days\n", + "description": "invite expiry days", "tags": [ "Site Settings Users" ], @@ -10491,14 +10301,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/invite_passthrough_hours": { "put": { - "description": "invite passthrough hours\n", + "description": "invite passthrough hours", "tags": [ "Site Settings Users" ], @@ -10521,14 +10331,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/invites_per_page": { "put": { - "description": "invites per page\n", + "description": "invites per page", "tags": [ "Site Settings Users" ], @@ -10551,14 +10361,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_user_max_post_age": { "put": { - "description": "delete user max post age\n", + "description": "delete user max post age", "tags": [ "Site Settings Users" ], @@ -10581,14 +10391,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_all_posts_max": { "put": { - "description": "delete all posts max\n", + "description": "delete all posts max", "tags": [ "Site Settings Users" ], @@ -10611,14 +10421,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/redirect_users_to_top_page": { "put": { - "description": "redirect users to top page\n", + "description": "redirect users to top page", "tags": [ "Site Settings Users" ], @@ -10641,14 +10451,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_email_on_profile": { "put": { - "description": "show email on profile\n", + "description": "show email on profile", "tags": [ "Site Settings Users" ], @@ -10671,14 +10481,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/prioritize_username_in_ux": { "put": { - "description": "prioritize username in ux\n", + "description": "prioritize username in ux", "tags": [ "Site Settings Users" ], @@ -10701,14 +10511,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_token_valid_hours": { "put": { - "description": "email token valid hours\n", + "description": "email token valid hours", "tags": [ "Site Settings Users" ], @@ -10731,14 +10541,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/purge_unactivated_users_grace_period_days": { "put": { - "description": "purge unactivated users grace period days\n", + "description": "purge unactivated users grace period days", "tags": [ "Site Settings Users" ], @@ -10761,14 +10571,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/public_user_custom_fields": { "put": { - "description": "public user custom fields\n", + "description": "public user custom fields", "tags": [ "Site Settings Users" ], @@ -10791,14 +10601,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/staff_users_custom_fields": { "put": { - "description": "staff user custom fields\n", + "description": "staff user custom fields", "tags": [ "Site Settings Users" ], @@ -10821,14 +10631,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_user_directory": { "put": { - "description": "enable user directory\n", + "description": "enable user directory", "tags": [ "Site Settings Users" ], @@ -10851,14 +10661,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_anonymous_posting": { "put": { - "description": "allow anonymous posting\n", + "description": "allow anonymous posting", "tags": [ "Site Settings Users" ], @@ -10881,14 +10691,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/anonymous_posting_min_trust_level": { "put": { - "description": "anonymous posting min trust level\n", + "description": "anonymous posting min trust level", "tags": [ "Site Settings Users" ], @@ -10911,14 +10721,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/anonymous_account_duration_minutes": { "put": { - "description": "anonymous account duration minutes\n", + "description": "anonymous account duration minutes", "tags": [ "Site Settings Users" ], @@ -10941,14 +10751,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/hide_user_profiles_from_public": { "put": { - "description": "hide user profiles from public\n", + "description": "hide user profiles from public", "tags": [ "Site Settings Users" ], @@ -10971,14 +10781,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_post_length": { "put": { - "description": "min post length\n", + "description": "min post length", "tags": [ "Site Settings Posting" ], @@ -11001,14 +10811,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_first_post_length": { "put": { - "description": "min first post length\n", + "description": "min first post length", "tags": [ "Site Settings Posting" ], @@ -11031,14 +10841,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_private_message_post_length": { "put": { - "description": "min private message post length\n", + "description": "min private message post length", "tags": [ "Site Settings Posting" ], @@ -11061,14 +10871,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_post_length": { "put": { - "description": "max post length\n", + "description": "max post length", "tags": [ "Site Settings Posting" ], @@ -11091,14 +10901,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_featured_link_enabled": { "put": { - "description": "topic featured link enabled\n", + "description": "topic featured link enabled", "tags": [ "Site Settings Posting" ], @@ -11121,14 +10931,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/body_min_entropy": { "put": { - "description": "body min entropy\n", + "description": "body min entropy", "tags": [ "Site Settings Posting" ], @@ -11151,14 +10961,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_topic_title_length": { "put": { - "description": "min topic title length\n", + "description": "min topic title length", "tags": [ "Site Settings Posting" ], @@ -11181,14 +10991,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_topic_title_length": { "put": { - "description": "max topic title length\n", + "description": "max topic title length", "tags": [ "Site Settings Posting" ], @@ -11211,14 +11021,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/title_min_entropy": { "put": { - "description": "title min entropy\n", + "description": "title min entropy", "tags": [ "Site Settings Posting" ], @@ -11241,14 +11051,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_uppercase_posts": { "put": { - "description": "allow_uppercase_posts\n", + "description": "allow_uppercase_posts", "tags": [ "Site Settings Posting" ], @@ -11271,14 +11081,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/title_prettify": { "put": { - "description": "title_prettify\n", + "description": "title_prettify", "tags": [ "Site Settings Posting" ], @@ -11301,14 +11111,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/title_fancy_entities": { "put": { - "description": "title fancy entities\n", + "description": "title fancy entities", "tags": [ "Site Settings Posting" ], @@ -11331,14 +11141,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_private_message_title_length": { "put": { - "description": "min private message title length\n", + "description": "min private message title length", "tags": [ "Site Settings Posting" ], @@ -11361,14 +11171,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_uncategorized_topics": { "put": { - "description": "allow uncategorized topics\n", + "description": "allow uncategorized topics", "tags": [ "Site Settings Posting" ], @@ -11391,14 +11201,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_duplicate_topic_titles": { "put": { - "description": "allow duplicate topic titles\n", + "description": "allow duplicate topic titles", "tags": [ "Site Settings Posting" ], @@ -11421,14 +11231,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_title_similar_length": { "put": { - "description": "min_title_similar_length\n", + "description": "min_title_similar_length", "tags": [ "Site Settings Posting" ], @@ -11451,14 +11261,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_body_title_length": { "put": { - "description": "min body title length\n", + "description": "min body title length", "tags": [ "Site Settings Posting" ], @@ -11481,14 +11291,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_private_messages": { "put": { - "description": "enable private messages\n", + "description": "enable private messages", "tags": [ "Site Settings Posting" ], @@ -11511,14 +11321,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/editing_grace_period": { "put": { - "description": "editing grace period\n", + "description": "editing grace period", "tags": [ "Site Settings Posting" ], @@ -11541,14 +11351,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_edit_time_limit": { "put": { - "description": "post edit time limit\n", + "description": "post edit time limit", "tags": [ "Site Settings Posting" ], @@ -11571,14 +11381,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/edit_history_visible_to_public": { "put": { - "description": "edit history visible to public\n", + "description": "edit history visible to public", "tags": [ "Site Settings Posting" ], @@ -11601,14 +11411,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_removed_posts_after": { "put": { - "description": "delete removed posts after\n", + "description": "delete removed posts after", "tags": [ "Site Settings Posting" ], @@ -11631,14 +11441,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/traditional_markdown_linebreaks": { "put": { - "description": "traditional markdown linebreaks\n", + "description": "traditional markdown linebreaks", "tags": [ "Site Settings Posting" ], @@ -11661,14 +11471,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_html_tables": { "put": { - "description": "allow html tables\n", + "description": "allow html tables", "tags": [ "Site Settings Posting" ], @@ -11691,14 +11501,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suppress_reply_directly_below": { "put": { - "description": "suppress reply directly below\n", + "description": "suppress reply directly below", "tags": [ "Site Settings Posting" ], @@ -11721,14 +11531,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suppress_reply_directly_above": { "put": { - "description": "suppress reply directly above\n", + "description": "suppress reply directly above", "tags": [ "Site Settings Posting" ], @@ -11751,14 +11561,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suppress_reply_when_quoting": { "put": { - "description": "suppress reply when quoting\n", + "description": "suppress reply when quoting", "tags": [ "Site Settings Posting" ], @@ -11781,14 +11591,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_reply_history": { "put": { - "description": "max reply history\n", + "description": "max reply history", "tags": [ "Site Settings Posting" ], @@ -11811,14 +11621,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_undo_action_window_mins": { "put": { - "description": "post undo action window mins\n", + "description": "post undo action window mins", "tags": [ "Site Settings Posting" ], @@ -11841,14 +11651,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_mentions_per_post": { "put": { - "description": "max mentions per post\n", + "description": "max mentions per post", "tags": [ "Site Settings Posting" ], @@ -11871,14 +11681,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_users_notified_per_group_mention": { "put": { - "description": "max users notified per group mention\n", + "description": "max users notified per group mention", "tags": [ "Site Settings Posting" ], @@ -11901,14 +11711,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_max_replies_per_topic": { "put": { - "description": "newuser max replies per topic\n", + "description": "newuser max replies per topic", "tags": [ "Site Settings Posting" ], @@ -11931,14 +11741,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_max_mentions_per_post": { "put": { - "description": "newuser max mentions per post\n", + "description": "newuser max mentions per post", "tags": [ "Site Settings Posting" ], @@ -11961,14 +11771,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/title_max_word_length": { "put": { - "description": "title max word length\n", + "description": "title max word length", "tags": [ "Site Settings Posting" ], @@ -11991,14 +11801,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_max_links": { "put": { - "description": "newuser max links\n", + "description": "newuser max links", "tags": [ "Site Settings Posting" ], @@ -12021,14 +11831,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_max_images": { "put": { - "description": "newuser max images\n", + "description": "newuser max images", "tags": [ "Site Settings Posting" ], @@ -12051,14 +11861,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_max_attachments": { "put": { - "description": "newuser max attachments\n", + "description": "newuser max attachments", "tags": [ "Site Settings Posting" ], @@ -12081,14 +11891,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_excerpt_maxlength": { "put": { - "description": "post excerpt maxlength\n", + "description": "post excerpt maxlength", "tags": [ "Site Settings Posting" ], @@ -12111,14 +11921,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_pinned_excerpt_mobile": { "put": { - "description": "show pinned excerpt mobile\n", + "description": "show pinned excerpt mobile", "tags": [ "Site Settings Posting" ], @@ -12141,14 +11951,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_pinned_excerpt_desktop": { "put": { - "description": "show pinned excerpt desktop\n", + "description": "show pinned excerpt desktop", "tags": [ "Site Settings Posting" ], @@ -12171,14 +11981,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/display_name_on_posts": { "put": { - "description": "display name on posts\n", + "description": "display name on posts", "tags": [ "Site Settings Posting" ], @@ -12201,14 +12011,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_time_gap_days": { "put": { - "description": "show time gap days\n", + "description": "show time gap days", "tags": [ "Site Settings Posting" ], @@ -12231,14 +12041,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/short_progress_text_threshold": { "put": { - "description": "short progress text threshold\n", + "description": "short progress text threshold", "tags": [ "Site Settings Posting" ], @@ -12261,14 +12071,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_code_lang": { "put": { - "description": "default code lang\n", + "description": "default code lang", "tags": [ "Site Settings Posting" ], @@ -12291,14 +12101,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/warn_reviving_old_topic_age": { "put": { - "description": "warn reviving old topic age\n", + "description": "warn reviving old topic age", "tags": [ "Site Settings Posting" ], @@ -12321,14 +12131,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/autohighlight_all_code": { "put": { - "description": "autohighlight all code\n", + "description": "autohighlight all code", "tags": [ "Site Settings Posting" ], @@ -12351,14 +12161,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/highlighted_languages": { "put": { - "description": "highlighted languages\n", + "description": "highlighted languages", "tags": [ "Site Settings Posting" ], @@ -12381,14 +12191,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_old_hidden_posts": { "put": { - "description": "delete old hidden posts\n", + "description": "delete old hidden posts", "tags": [ "Site Settings Posting" ], @@ -12411,14 +12221,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/censored_words": { "put": { - "description": "censored words\n", + "description": "censored words", "tags": [ "Site Settings Posting" ], @@ -12441,14 +12251,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/censored_pattern": { "put": { - "description": "censored pattern\n", + "description": "censored pattern", "tags": [ "Site Settings Posting" ], @@ -12471,14 +12281,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_emoji": { "put": { - "description": "enable emoji\n", + "description": "enable emoji", "tags": [ "Site Settings Posting" ], @@ -12501,14 +12311,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/emoji_set": { "put": { - "description": "emoji set\n", + "description": "emoji set", "tags": [ "Site Settings Posting" ], @@ -12538,14 +12348,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enforce_square_emoji": { "put": { - "description": "enforce square emoji\n", + "description": "enforce square emoji", "tags": [ "Site Settings Posting" ], @@ -12568,14 +12378,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/approve_post_count": { "put": { - "description": "approve post count\n", + "description": "approve post count", "tags": [ "Site Settings Posting" ], @@ -12598,14 +12408,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/approve_unless_trust_level": { "put": { - "description": "approve unless trust level\n", + "description": "approve unless trust level", "tags": [ "Site Settings Posting" ], @@ -12635,14 +12445,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/approve_new_topics_unless_trust_level": { "put": { - "description": "approve new topics unless trust level\n", + "description": "approve new topics unless trust level", "tags": [ "Site Settings Posting" ], @@ -12672,14 +12482,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/notify_about_queued_posts_after": { "put": { - "description": "notify about queued posts after\n", + "description": "notify about queued posts after", "tags": [ "Site Settings Posting" ], @@ -12702,14 +12512,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_close_messages_post_count": { "put": { - "description": "auto close messages post count\n", + "description": "auto close messages post count", "tags": [ "Site Settings Posting" ], @@ -12732,14 +12542,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_close_topics_post_count": { "put": { - "description": "auto close topics post count\n", + "description": "auto close topics post count", "tags": [ "Site Settings Posting" ], @@ -12762,14 +12572,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/code_formatting_style": { "put": { - "description": "code formatting style\n", + "description": "code formatting style", "tags": [ "Site Settings Posting" ], @@ -12796,14 +12606,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/embed_truncate": { "put": { - "description": "embed truncate\n", + "description": "embed truncate", "tags": [ "Site Settings Posting" ], @@ -12826,14 +12636,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allowed_href_schemes": { "put": { - "description": "allowed href schemes\n", + "description": "allowed href schemes", "tags": [ "Site Settings Posting" ], @@ -12856,14 +12666,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_time_window_mins": { "put": { - "description": "email time window mins\n", + "description": "email time window mins", "tags": [ "Site Settings Email" ], @@ -12886,14 +12696,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/private_email_time_window_seconds": { "put": { - "description": "private email time window seconds\n", + "description": "private email time window seconds", "tags": [ "Site Settings Email" ], @@ -12916,14 +12726,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_min_excerpt_length": { "put": { - "description": "digest min excerpt length\n", + "description": "digest min excerpt length", "tags": [ "Site Settings Email" ], @@ -12946,14 +12756,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_topics": { "put": { - "description": "digest topics\n", + "description": "digest topics", "tags": [ "Site Settings Email" ], @@ -12977,14 +12787,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_posts": { "put": { - "description": "digest posts\n", + "description": "digest posts", "tags": [ "Site Settings Email" ], @@ -13008,14 +12818,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_other_topics": { "put": { - "description": "digest other topics\n", + "description": "digest other topics", "tags": [ "Site Settings Email" ], @@ -13039,14 +12849,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_digest_email_after_days": { "put": { - "description": "delete digest email after days\n", + "description": "delete digest email after days", "tags": [ "Site Settings Email" ], @@ -13070,14 +12880,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/digest_suppress_categories": { "put": { - "description": "digest suppress categories\n", + "description": "digest suppress categories", "tags": [ "Site Settings Email" ], @@ -13102,14 +12912,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_digest_emails": { "put": { - "description": "disable digest emails\n", + "description": "disable digest emails", "tags": [ "Site Settings Email" ], @@ -13133,14 +12943,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_accent_bg_color": { "put": { - "description": "email accent bg color\n", + "description": "email accent bg color", "tags": [ "Site Settings Email" ], @@ -13156,7 +12966,7 @@ "email_accent_bg_color": { "type": "string", "example": "#2F70AD", - "description": "Enter a color name ('red') or hex value ('#FF000').\n" + "description": "Enter a color name ('red') or hex value ('#FF000')." } } } @@ -13165,14 +12975,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_accent_fg_color": { "put": { - "description": "email accent fg color\n", + "description": "email accent fg color", "tags": [ "Site Settings Email" ], @@ -13188,7 +12998,7 @@ "email_accent_fg_color": { "type": "string", "example": "#FFFFFF", - "description": "Enter a color name ('white') or hex value ('#FFFFFF').\n" + "description": "Enter a color name ('white') or hex value ('#FFFFFF')." } } } @@ -13197,14 +13007,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_link_color": { "put": { - "description": "email link color\n", + "description": "email link color", "tags": [ "Site Settings Email" ], @@ -13220,7 +13030,7 @@ "email_link_color": { "type": "string", "example": "#006699", - "description": "Enter a color name ('blue') or hex value ('#0000FF').\n" + "description": "Enter a color name ('blue') or hex value ('#0000FF')." } } } @@ -13229,14 +13039,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_topic_featured_link_in_digest": { "put": { - "description": "show topic featured link in digest\n", + "description": "show topic featured link in digest", "tags": [ "Site Settings Email" ], @@ -13260,14 +13070,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_custom_headers": { "put": { - "description": "email custom headers\n", + "description": "email custom headers", "tags": [ "Site Settings Email" ], @@ -13292,14 +13102,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_subject": { "put": { - "description": "email subject\n", + "description": "email subject", "tags": [ "Site Settings Email" ], @@ -13324,14 +13134,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/reply_by_email_enabled": { "put": { - "description": "reply by email enabled\n", + "description": "reply by email enabled", "tags": [ "Site Settings Email" ], @@ -13356,14 +13166,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/reply_by_email_address": { "put": { - "description": "reply by email address\n", + "description": "reply by email address", "tags": [ "Site Settings Email" ], @@ -13388,14 +13198,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/alternative_reply_by_email_addresses": { "put": { - "description": "alternative reply by email addresses\n", + "description": "alternative reply by email addresses", "tags": [ "Site Settings Email" ], @@ -13420,14 +13230,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/manual_polling_enabled": { "put": { - "description": "manual polling enabled\n", + "description": "manual polling enabled", "tags": [ "Site Settings Email" ], @@ -13451,14 +13261,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_enabled": { "put": { - "description": "pop3 polling enabled\n", + "description": "pop3 polling enabled", "tags": [ "Site Settings Email" ], @@ -13483,14 +13293,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_ssl": { "put": { - "description": "pop3 polling ssl\n", + "description": "pop3 polling ssl", "tags": [ "Site Settings Email" ], @@ -13515,14 +13325,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_openssl_verify": { "put": { - "description": "pop3 polling openssl verify\n", + "description": "pop3 polling openssl verify", "tags": [ "Site Settings Email" ], @@ -13547,14 +13357,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_period_mins": { "put": { - "description": "pop3 polling period mins\n", + "description": "pop3 polling period mins", "tags": [ "Site Settings Email" ], @@ -13570,7 +13380,7 @@ "pop3_polling_period_mins": { "type": "integer", "example": 5, - "description": "\"The period in minutes between checking the POP3 account for email. NOTE: requires restart.\"\n" + "description": "\"The period in minutes between checking the POP3 account for email. NOTE: requires restart.\"" } } } @@ -13579,14 +13389,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_host": { "put": { - "description": "pop3 polling host\n", + "description": "pop3 polling host", "tags": [ "Site Settings Email" ], @@ -13610,14 +13420,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_port": { "put": { - "description": "pop3 polling port\n", + "description": "pop3 polling port", "tags": [ "Site Settings Email" ], @@ -13642,14 +13452,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_username": { "put": { - "description": "pop3 polling username\n", + "description": "pop3 polling username", "tags": [ "Site Settings Email" ], @@ -13673,14 +13483,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/pop3_polling_password": { "put": { - "description": "pop3 polling password\n", + "description": "pop3 polling password", "tags": [ "Site Settings Email" ], @@ -13704,14 +13514,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/log_mail_processing_failures": { "put": { - "description": "log mail processing failures\n", + "description": "log mail processing failures", "tags": [ "Site Settings Email" ], @@ -13735,14 +13545,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/incoming_email_prefer_html": { "put": { - "description": "incoming email prefer html\n", + "description": "incoming email prefer html", "tags": [ "Site Settings Email" ], @@ -13757,7 +13567,7 @@ "properties": { "incoming_email_prefer_html": { "type": "boolean", - "description": "Use the HTML instead of the text for incoming email. May cause unexpected formatting issues!\n" + "description": "Use the HTML instead of the text for incoming email. May cause unexpected formatting issues!" } } } @@ -13766,14 +13576,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_in": { "put": { - "description": "email in\n", + "description": "email in", "tags": [ "Site Settings Email" ], @@ -13788,7 +13598,7 @@ "properties": { "email_in": { "type": "boolean", - "description": "'Allow users to post new topics via email (requires pop3 polling). Configure the addresses in the \"Settings\" tab of each category.'\n" + "description": "'Allow users to post new topics via email (requires pop3 polling). Configure the addresses in the \"Settings\" tab of each category.'" } } } @@ -13797,14 +13607,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_in_min_trust": { "put": { - "description": "email in min trust\n", + "description": "email in min trust", "tags": [ "Site Settings Email" ], @@ -13826,7 +13636,7 @@ 3, 4 ], - "description": "The minimum trust level a user needs to have to be allowed to post new topics via email.\n", + "description": "The minimum trust level a user needs to have to be allowed to post new topics via email.", "example": 2 } } @@ -13836,14 +13646,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_prefix": { "put": { - "description": "email prefix\n", + "description": "email prefix", "tags": [ "Site Settings Email" ], @@ -13858,7 +13668,7 @@ "properties": { "email_prefix": { "type": "string", - "description": "\"The [label] used in the subject of emails. It will default to 'title' if not set.\"\n" + "description": "\"The [label] used in the subject of emails. It will default to 'title' if not set.\"" } } } @@ -13867,14 +13677,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/email_site_title": { "put": { - "description": "email site title\n", + "description": "email site title", "tags": [ "Site Settings Email" ], @@ -13889,7 +13699,7 @@ "properties": { "email_site_title": { "type": "string", - "description": "The title of the site used as the sender of emails from the site. Default to 'title' if not set. If your 'title' contains characters that are not allowed in email sender strings, use this setting.\n" + "description": "The title of the site used as the sender of emails from the site. Default to 'title' if not set. If your 'title' contains characters that are not allowed in email sender strings, use this setting." } } } @@ -13898,14 +13708,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_emails": { "put": { - "description": "disable emails\n", + "description": "disable emails", "tags": [ "Site Settings Email" ], @@ -13926,7 +13736,7 @@ "non-staff" ], "example": "yes", - "description": "Prevent Discourse from sending any kind of emails\n" + "description": "Prevent Discourse from sending any kind of emails" } } } @@ -13935,14 +13745,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/strip_images_from_short_emails": { "put": { - "description": "strip images from short emails\n", + "description": "strip images from short emails", "tags": [ "Site Settings Email" ], @@ -13967,14 +13777,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/short_email_length": { "put": { - "description": "short email length\n", + "description": "short email length", "tags": [ "Site Settings Email" ], @@ -13999,14 +13809,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/display_name_on_email_from": { "put": { - "description": "display name on email from\n", + "description": "display name on email from", "tags": [ "Site Settings Email" ], @@ -14022,7 +13832,7 @@ "display_name_on_email_from": { "type": "boolean", "example": true, - "description": "Display full names on email from fields\n" + "description": "Display full names on email from fields" } } } @@ -14031,14 +13841,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/unsubscribe_via_email": { "put": { - "description": "unsubscribe via email\n", + "description": "unsubscribe via email", "tags": [ "Site Settings Email" ], @@ -14054,7 +13864,7 @@ "unsubscribe_via_email": { "type": "boolean", "example": true, - "description": "Allow users to unsubscribe from emails by sending an email with 'unsubscribe' in the subject or body\n" + "description": "Allow users to unsubscribe from emails by sending an email with 'unsubscribe' in the subject or body" } } } @@ -14063,14 +13873,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/unsubscribe_via_email_footer": { "put": { - "description": "unsubscribe via email footer\n", + "description": "unsubscribe via email footer", "tags": [ "Site Settings Email" ], @@ -14095,14 +13905,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_email_logs_after_days": { "put": { - "description": "delete email logs after days\n", + "description": "delete email logs after days", "tags": [ "Site Settings Email" ], @@ -14118,7 +13928,7 @@ "delete_email_logs_after_days": { "type": "integer", "example": 365, - "description": "Delete email logs after (N) days. 0 to keep indefinitely\n" + "description": "Delete email logs after (N) days. 0 to keep indefinitely" } } } @@ -14127,14 +13937,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_emails_per_day_per_user": { "put": { - "description": "max emails per day per user\n", + "description": "max emails per day per user", "tags": [ "Site Settings Email" ], @@ -14159,14 +13969,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_staged_users": { "put": { - "description": "enable staged users\n", + "description": "enable staged users", "tags": [ "Site Settings Email" ], @@ -14191,14 +14001,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/maximum_staged_users_per_email": { "put": { - "description": "maximum staged users per email\n", + "description": "maximum staged users per email", "tags": [ "Site Settings Email" ], @@ -14223,14 +14033,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_generated_whitelist": { "put": { - "description": "auto generated whitelist\n", + "description": "auto generated whitelist", "tags": [ "Site Settings Email" ], @@ -14255,14 +14065,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/block_auto_generated_emails": { "put": { - "description": "block auto generated emails\n", + "description": "block auto generated emails", "tags": [ "Site Settings Email" ], @@ -14287,14 +14097,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/ignore_by_title": { "put": { - "description": "ignore by title\n", + "description": "ignore by title", "tags": [ "Site Settings Email" ], @@ -14319,14 +14129,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/mailgun_api_key": { "put": { - "description": "mailgun api key\n", + "description": "mailgun api key", "tags": [ "Site Settings Email" ], @@ -14351,14 +14161,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/bounce_score_threshold": { "put": { - "description": "bounce score threshold\n", + "description": "bounce score threshold", "tags": [ "Site Settings Email" ], @@ -14383,14 +14193,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/bounce_score_threshold_deactivate": { "put": { - "description": "bounce score threshold deactive\n", + "description": "bounce score threshold deactive", "tags": [ "Site Settings Email" ], @@ -14415,14 +14225,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/soft_bounce_score": { "put": { - "description": "soft bounce score\n", + "description": "soft bounce score", "tags": [ "Site Settings Email" ], @@ -14447,14 +14257,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/hard_bounce_score": { "put": { - "description": "hard bounce score\n", + "description": "hard bounce score", "tags": [ "Site Settings Email" ], @@ -14479,14 +14289,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/reset_bounce_score_after_days": { "put": { - "description": "reset bounce score after days\n", + "description": "reset bounce score after days", "tags": [ "Site Settings Email" ], @@ -14511,14 +14321,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/attachment_content_type_blacklist": { "put": { - "description": "attachment content type blacklist\n", + "description": "attachment content type blacklist", "tags": [ "Site Settings Email" ], @@ -14543,14 +14353,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/attachment_filename_blacklist": { "put": { - "description": "attachment filename blacklist\n", + "description": "attachment filename blacklist", "tags": [ "Site Settings Email" ], @@ -14575,14 +14385,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_forwarded_emails": { "put": { - "description": "enable forwarded emails\n", + "description": "enable forwarded emails", "tags": [ "Site Settings Email" ], @@ -14607,14 +14417,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/always_show_trimmed_content": { "put": { - "description": "always show trimmed content\n", + "description": "always show trimmed content", "tags": [ "Site Settings Email" ], @@ -14639,14 +14449,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_image_size_kb": { "put": { - "description": "max image size kb\n", + "description": "max image size kb", "tags": [ "Site Settings Files" ], @@ -14671,14 +14481,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_attachment_size_kb": { "put": { - "description": "max attachment size kb\n", + "description": "max attachment size kb", "tags": [ "Site Settings Files" ], @@ -14703,14 +14513,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_image_megapixels": { "put": { - "description": "max image megapixels\n", + "description": "max image megapixels", "tags": [ "Site Settings Files" ], @@ -14735,14 +14545,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/authorized_extensions": { "put": { - "description": "authorized extensions\n", + "description": "authorized extensions", "tags": [ "Site Settings Files" ], @@ -14767,14 +14577,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/crawl_images": { "put": { - "description": "crawl images\n", + "description": "crawl images", "tags": [ "Site Settings Files" ], @@ -14799,14 +14609,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_image_width": { "put": { - "description": "max image width\n", + "description": "max image width", "tags": [ "Site Settings Files" ], @@ -14831,14 +14641,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_image_height": { "put": { - "description": "max image height\n", + "description": "max image height", "tags": [ "Site Settings Files" ], @@ -14863,14 +14673,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/download_remote_images_to_local": { "put": { - "description": "download remote images to local\n", + "description": "download remote images to local", "tags": [ "Site Settings Files" ], @@ -14895,14 +14705,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/download_remote_images_threshold": { "put": { - "description": "download remote images threshold\n", + "description": "download remote images threshold", "tags": [ "Site Settings Files" ], @@ -14918,7 +14728,7 @@ "download_remote_images_threshold": { "type": "integer", "example": 10, - "description": "Minimum disk space necessary to download remote images locally (in percent)\n" + "description": "Minimum disk space necessary to download remote images locally (in percent)" } } } @@ -14927,14 +14737,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/download_remote_images_max_days_old": { "put": { - "description": "download remote images max days old\n", + "description": "download remote images max days old", "tags": [ "Site Settings Files" ], @@ -14950,7 +14760,7 @@ "download_remote_images_max_days_old": { "type": "integer", "example": 30, - "description": "Don't download remote images for posts that are more than n days old.\n" + "description": "Don't download remote images for posts that are more than n days old." } } } @@ -14959,14 +14769,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disabled_image_download_domains": { "put": { - "description": "disabled image download domains\n", + "description": "disabled image download domains", "tags": [ "Site Settings Files" ], @@ -14991,14 +14801,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/create_thumbnails": { "put": { - "description": "create thumbnails\n", + "description": "create thumbnails", "tags": [ "Site Settings Files" ], @@ -15014,7 +14824,7 @@ "create_thumbnails": { "type": "boolean", "example": true, - "description": "\"Create thumbnails and lightbox images that are too large to fit in a post\"\n" + "description": "\"Create thumbnails and lightbox images that are too large to fit in a post\"" } } } @@ -15023,14 +14833,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/clean_up_uploads": { "put": { - "description": "clean up uploads\n", + "description": "clean up uploads", "tags": [ "Site Settings Files" ], @@ -15046,7 +14856,7 @@ "clean_up_uploads": { "type": "boolean", "example": true, - "description": "\"Remove orphan unreferenced uploads to prevent illegal hosting. WARNING: you may want to back up of your /uploads directory before enabling this setting.\"\n" + "description": "\"Remove orphan unreferenced uploads to prevent illegal hosting. WARNING: you may want to back up of your /uploads directory before enabling this setting.\"" } } } @@ -15055,14 +14865,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/clean_orphan_uploads_grace_period_hours": { "put": { - "description": "clean orphan uploads grace period hours\n", + "description": "clean orphan uploads grace period hours", "tags": [ "Site Settings Files" ], @@ -15078,7 +14888,7 @@ "clean_orphan_uploads_grace_period_hours": { "type": "integer", "example": 48, - "description": "\"Grace period (in hours) before an orphan upload is removed.\"\n" + "description": "\"Grace period (in hours) before an orphan upload is removed.\"" } } } @@ -15087,14 +14897,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/purge_deleted_uploads_grace_period_days": { "put": { - "description": "purge deleted uploads grace period days\n", + "description": "purge deleted uploads grace period days", "tags": [ "Site Settings Files" ], @@ -15110,7 +14920,7 @@ "purge_deleted_uploads_grace_period_days": { "type": "integer", "example": 30, - "description": "\"Grace period (in days) before a deleted upload is erased.\"\n" + "description": "\"Grace period (in days) before a deleted upload is erased.\"" } } } @@ -15119,14 +14929,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/prevent_anons_from_downloading_files": { "put": { - "description": "prevent anons from downloading files\n", + "description": "prevent anons from downloading files", "tags": [ "Site Settings Files" ], @@ -15142,7 +14952,7 @@ "prevent_anons_from_downloading_files": { "type": "boolean", "example": false, - "description": "\"Prevent anonymous users from downloading attachments. WARNING: this will prevent any non-image site assets posted as attachments from working.\"\n" + "description": "\"Prevent anonymous users from downloading attachments. WARNING: this will prevent any non-image site assets posted as attachments from working.\"" } } } @@ -15151,14 +14961,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_s3_uploads": { "put": { - "description": "enable s3 uploads\n", + "description": "enable s3 uploads", "tags": [ "Site Settings Files" ], @@ -15174,7 +14984,7 @@ "enable_s3_uploads": { "type": "boolean", "example": false, - "description": "\"Place uploads on Amazon S3 storage. IMPORTANT: requires valid S3 credentials (both access key id & secret access key).\"\n" + "description": "\"Place uploads on Amazon S3 storage. IMPORTANT: requires valid S3 credentials (both access key id & secret access key).\"" } } } @@ -15183,14 +14993,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_use_iam_profile": { "put": { - "description": "s3 use iam profile\n", + "description": "s3 use iam profile", "tags": [ "Site Settings Files" ], @@ -15206,7 +15016,7 @@ "s3_use_iam_profile": { "type": "boolean", "example": false, - "description": "'Use AWS EC2 IAM role to retrieve keys. NOTE: enabling will override \"s3 access key id\" and \"s3 secret access key\" settings.'\n" + "description": "'Use AWS EC2 IAM role to retrieve keys. NOTE: enabling will override \"s3 access key id\" and \"s3 secret access key\" settings.'" } } } @@ -15215,14 +15025,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_access_key_id": { "put": { - "description": "s3 access key id\n", + "description": "s3 access key id", "tags": [ "Site Settings Files" ], @@ -15238,7 +15048,7 @@ "s3_access_key_id": { "type": "string", "example": "", - "description": "\"The Amazon S3 access key id that will be used to upload images.\"\n" + "description": "\"The Amazon S3 access key id that will be used to upload images.\"" } } } @@ -15247,14 +15057,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_secret_access_key": { "put": { - "description": "s3 secret access key\n", + "description": "s3 secret access key", "tags": [ "Site Settings Files" ], @@ -15270,7 +15080,7 @@ "s3_secret_access_key": { "type": "string", "example": "", - "description": "\"The Amazon S3 secret access key that will be used to upload images.\"\n" + "description": "\"The Amazon S3 secret access key that will be used to upload images.\"" } } } @@ -15279,14 +15089,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_region": { "put": { - "description": "s3 region\n", + "description": "s3 region", "tags": [ "Site Settings Files" ], @@ -15317,7 +15127,7 @@ "us-west-2" ], "example": "us-west-2", - "description": "\"The Amazon S3 region name that will be used to upload images.\"\n" + "description": "\"The Amazon S3 region name that will be used to upload images.\"" } } } @@ -15326,14 +15136,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_upload_bucket": { "put": { - "description": "s3 upload bucket\n", + "description": "s3 upload bucket", "tags": [ "Site Settings Files" ], @@ -15349,7 +15159,7 @@ "s3_upload_bucket": { "type": "string", "example": "", - "description": "\"The Amazon S3 bucket name that files will be uploaded into. WARNING: must be lowercase, no periods, no underscores.\"\n" + "description": "\"The Amazon S3 bucket name that files will be uploaded into. WARNING: must be lowercase, no periods, no underscores.\"" } } } @@ -15358,14 +15168,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_cdn_url": { "put": { - "description": "s3 cdn url\n", + "description": "s3 cdn url", "tags": [ "Site Settings Files" ], @@ -15381,7 +15191,7 @@ "s3_cdn_url": { "type": "string", "example": "", - "description": "\"The CDN URL to use for all s3 assets (for example: https://cdn.somewhere.com). WARNING: after changing this setting you must rebake all old posts.\"\n" + "description": "\"The CDN URL to use for all s3 assets (for example: https://cdn.somewhere.com). WARNING: after changing this setting you must rebake all old posts.\"" } } } @@ -15390,14 +15200,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_profile_backgrounds": { "put": { - "description": "allow profile backgrounds\n", + "description": "allow profile backgrounds", "tags": [ "Site Settings Files" ], @@ -15413,7 +15223,7 @@ "allow_profile_backgrounds": { "type": "boolean", "example": true, - "description": "\"Allow users to upload profile backgrounds.\"\n" + "description": "\"Allow users to upload profile backgrounds.\"" } } } @@ -15422,14 +15232,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/automatically_download_gravatars": { "put": { - "description": "automatically download gravatars\n", + "description": "automatically download gravatars", "tags": [ "Site Settings Files" ], @@ -15445,7 +15255,7 @@ "automatically_download_gravatars": { "type": "boolean", "example": true, - "description": "\"Download Gravatars for users upon account creation or email change.\"\n" + "description": "\"Download Gravatars for users upon account creation or email change.\"" } } } @@ -15454,14 +15264,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_uploaded_avatars": { "put": { - "description": "allow uploaded avatars\n", + "description": "allow uploaded avatars", "tags": [ "Site Settings Files" ], @@ -15477,7 +15287,7 @@ "allow_uploaded_avatars": { "type": "boolean", "example": true, - "description": "\"Allow users to upload custom profile pictures.\"\n" + "description": "\"Allow users to upload custom profile pictures.\"" } } } @@ -15486,14 +15296,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_animated_avatars": { "put": { - "description": "allow animated avatars\n", + "description": "allow animated avatars", "tags": [ "Site Settings Files" ], @@ -15509,7 +15319,7 @@ "allow_animated_avatars": { "type": "boolean", "example": false, - "description": "\"Allow users to use animated gif profile pictures. WARNING: run the avatars:refresh rake task after changing this setting.\"\n" + "description": "\"Allow users to use animated gif profile pictures. WARNING: run the avatars:refresh rake task after changing this setting.\"" } } } @@ -15518,14 +15328,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_animated_thumbnails": { "put": { - "description": "allow animated thumbnails\n", + "description": "allow animated thumbnails", "tags": [ "Site Settings Files" ], @@ -15541,7 +15351,7 @@ "allow_animated_thumbnails": { "type": "boolean", "example": true, - "description": "\"Generate animated thumbnails of animated gifs.\"\n" + "description": "\"Generate animated thumbnails of animated gifs.\"" } } } @@ -15550,14 +15360,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_avatars": { "put": { - "description": "default avatars\n", + "description": "default avatars", "tags": [ "Site Settings Files" ], @@ -15573,7 +15383,7 @@ "default_avatars": { "type": "string", "example": "", - "description": "\"URLs to avatars that will be used by default for new users until they change them.\"\n" + "description": "\"URLs to avatars that will be used by default for new users until they change them.\"" } } } @@ -15582,14 +15392,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/avatar_sizes": { "put": { - "description": "avatar sizes\n", + "description": "avatar sizes", "tags": [ "Site Settings Files" ], @@ -15605,7 +15415,7 @@ "avatar_sizes": { "type": "string", "example": "20|25|32|45|60|120", - "description": "\"List of automatically generated avatar sizes.\"\n" + "description": "\"List of automatically generated avatar sizes.\"" } } } @@ -15614,14 +15424,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/external_system_avatars_enabled": { "put": { - "description": "external system avatars enabled\n", + "description": "external system avatars enabled", "tags": [ "Site Settings Files" ], @@ -15637,7 +15447,7 @@ "external_system_avatars_enabled": { "type": "boolean", "example": true, - "description": "\"Use external system avatars service.\"\n" + "description": "\"Use external system avatars service.\"" } } } @@ -15646,14 +15456,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/external_system_avatars_url": { "put": { - "description": "external system avatars url\n", + "description": "external system avatars url", "tags": [ "Site Settings Files" ], @@ -15669,7 +15479,7 @@ "external_system_avatars_url": { "type": "string", "example": "/letter_avatar_proxy/v2/letter/{first_letter}/{color}/{size}.png", - "description": "\"URL of the external system avatars service. Allowed substitutions are {username} {first_letter} {color} {size}\"\n" + "description": "\"URL of the external system avatars service. Allowed substitutions are {username} {first_letter} {color} {size}\"" } } } @@ -15678,14 +15488,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_all_attachments_for_group_messages": { "put": { - "description": "allow all attachments for group messages\n", + "description": "allow all attachments for group messages", "tags": [ "Site Settings Files" ], @@ -15701,7 +15511,7 @@ "allow_all_attachments_for_group_messages": { "type": "boolean", "example": false, - "description": "\"Allow all email attachments for group messages.\"\n" + "description": "\"Allow all email attachments for group messages.\"" } } } @@ -15710,14 +15520,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/convert_pasted_images_to_hq_jpg": { "put": { - "description": "convert pasted images to hq jpg\n", + "description": "convert pasted images to hq jpg", "tags": [ "Site Settings Files" ], @@ -15733,7 +15543,7 @@ "convert_pasted_images_to_hq_jpg": { "type": "boolean", "example": true, - "description": "\"Convert pasted images to high-quality JPG files.\"\n" + "description": "\"Convert pasted images to high-quality JPG files.\"" } } } @@ -15742,14 +15552,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/convert_pasted_images_quality": { "put": { - "description": "convert pasted images quality\n", + "description": "convert pasted images quality", "tags": [ "Site Settings Files" ], @@ -15765,7 +15575,7 @@ "convert_pasted_images_quality": { "type": "integer", "example": 95, - "description": "\"Quality of the converted JPG file (1 is lowest quality, 100 is best quality).\"\n" + "description": "\"Quality of the converted JPG file (1 is lowest quality, 100 is best quality).\"" } } } @@ -15774,14 +15584,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_trust_level": { "put": { - "description": "default trust level\n", + "description": "default trust level", "tags": [ "Site Settings Trust Levels" ], @@ -15804,7 +15614,7 @@ 3, 4 ], - "description": "\"Default trust level (0-4) for all new users. WARNING! Changing this will put you at serious risk for spam.\"\n" + "description": "\"Default trust level (0-4) for all new users. WARNING! Changing this will put you at serious risk for spam.\"" } } } @@ -15813,14 +15623,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_invitee_trust_level": { "put": { - "description": "default invitee trust level\n", + "description": "default invitee trust level", "tags": [ "Site Settings Trust Levels" ], @@ -15843,7 +15653,7 @@ 3, 4 ], - "description": "\"Default trust level (0-4) for invited users.\"\n" + "description": "\"Default trust level (0-4) for invited users.\"" } } } @@ -15852,14 +15662,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_create_topic": { "put": { - "description": "min trust to create topic\n", + "description": "min trust to create topic", "tags": [ "Site Settings Trust Levels" ], @@ -15882,7 +15692,7 @@ 3, 4 ], - "description": "\"The minimum trust level required to create a new topic\"\n" + "description": "\"The minimum trust level required to create a new topic\"" } } } @@ -15891,14 +15701,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_edit_wiki_post": { "put": { - "description": "min trust to edit wiki post\n", + "description": "min trust to edit wiki post", "tags": [ "Site Settings Trust Levels" ], @@ -15921,7 +15731,7 @@ 3, 4 ], - "description": "\"The minimum trust level required to edit post marked as wiki.\"\n" + "description": "\"The minimum trust level required to edit post marked as wiki.\"" } } } @@ -15930,14 +15740,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_edit_post": { "put": { - "description": "min trust to edit post\n", + "description": "min trust to edit post", "tags": [ "Site Settings Trust Levels" ], @@ -15960,7 +15770,7 @@ 3, 4 ], - "description": "\"The minimum trust level required to edit posts.\"\n" + "description": "\"The minimum trust level required to edit posts.\"" } } } @@ -15969,14 +15779,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_allow_self_wiki": { "put": { - "description": "min trust to allow self wiki\n", + "description": "min trust to allow self wiki", "tags": [ "Site Settings Trust Levels" ], @@ -15999,7 +15809,7 @@ 3, 4 ], - "description": "\"The minimum trust level required to make user's own post wiki.\"\n" + "description": "\"The minimum trust level required to make user's own post wiki.\"" } } } @@ -16008,14 +15818,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_send_messages": { "put": { - "description": "min trust to send messages\n", + "description": "min trust to send messages", "tags": [ "Site Settings Trust Levels" ], @@ -16038,7 +15848,7 @@ 3, 4 ], - "description": "\"The minimum trust level required to create new private messages.\"\n" + "description": "\"The minimum trust level required to create new private messages.\"" } } } @@ -16047,14 +15857,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl1_requires_topics_entered": { "put": { - "description": "tl1 requires topics entered\n", + "description": "tl1 requires topics entered", "tags": [ "Site Settings Trust Levels" ], @@ -16070,7 +15880,7 @@ "tl1_requires_topics_entered": { "type": "integer", "example": 5, - "description": "\"How many topics a new user must enter before promotion to trust level 1.\"\n" + "description": "\"How many topics a new user must enter before promotion to trust level 1.\"" } } } @@ -16079,14 +15889,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl1_requires_read_posts": { "put": { - "description": "tl1 requires read posts\n", + "description": "tl1 requires read posts", "tags": [ "Site Settings Trust Levels" ], @@ -16102,7 +15912,7 @@ "tl1_requires_read_posts": { "type": "integer", "example": 30, - "description": "\"How many posts a new user must read before promotion to trust level 1.\"\n" + "description": "\"How many posts a new user must read before promotion to trust level 1.\"" } } } @@ -16111,14 +15921,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl1_requires_time_spent_mins": { "put": { - "description": "tl1 requires time spent mins\n", + "description": "tl1 requires time spent mins", "tags": [ "Site Settings Trust Levels" ], @@ -16134,7 +15944,7 @@ "tl1_requires_time_spent_mins": { "type": "integer", "example": 10, - "description": "\"How many minutes a new user must read posts before promotion to trust level 1.\"\n" + "description": "\"How many minutes a new user must read posts before promotion to trust level 1.\"" } } } @@ -16143,14 +15953,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_topics_entered": { "put": { - "description": "tl2 requires topics entered\n", + "description": "tl2 requires topics entered", "tags": [ "Site Settings Trust Levels" ], @@ -16166,7 +15976,7 @@ "tl2_requires_topics_entered": { "type": "integer", "example": 20, - "description": "\"How many topics a user must enter before promotion to trust level 2.\"\n" + "description": "\"How many topics a user must enter before promotion to trust level 2.\"" } } } @@ -16175,14 +15985,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_read_posts": { "put": { - "description": "tl2 requires read posts\n", + "description": "tl2 requires read posts", "tags": [ "Site Settings Trust Levels" ], @@ -16198,7 +16008,7 @@ "tl2_requires_read_posts": { "type": "integer", "example": 100, - "description": "\"How many posts a user must read before promotion to trust level 2.\"\n" + "description": "\"How many posts a user must read before promotion to trust level 2.\"" } } } @@ -16207,14 +16017,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_time_spent_mins": { "put": { - "description": "tl2 requires time spent mins\n", + "description": "tl2 requires time spent mins", "tags": [ "Site Settings Trust Levels" ], @@ -16230,7 +16040,7 @@ "tl2_requires_time_spent_mins": { "type": "integer", "example": 60, - "description": "\"How many minutes a user must read posts before promotion to trust level 2.\"\n" + "description": "\"How many minutes a user must read posts before promotion to trust level 2.\"" } } } @@ -16239,14 +16049,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_days_visited": { "put": { - "description": "tl2 requires days visited\n", + "description": "tl2 requires days visited", "tags": [ "Site Settings Trust Levels" ], @@ -16262,7 +16072,7 @@ "tl2_requires_days_visited": { "type": "integer", "example": 15, - "description": "\"How many days a user must visit the site before promotion to trust level 2.\"\n" + "description": "\"How many days a user must visit the site before promotion to trust level 2.\"" } } } @@ -16271,14 +16081,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_likes_received": { "put": { - "description": "tl2 requires likes received\n", + "description": "tl2 requires likes received", "tags": [ "Site Settings Trust Levels" ], @@ -16294,7 +16104,7 @@ "tl2_requires_likes_received": { "type": "integer", "example": 1, - "description": "\"How many likes a user must receive before promotion to trust level 2.\"\n" + "description": "\"How many likes a user must receive before promotion to trust level 2.\"" } } } @@ -16303,14 +16113,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_likes_given": { "put": { - "description": "tl2 requires likes given\n", + "description": "tl2 requires likes given", "tags": [ "Site Settings Trust Levels" ], @@ -16326,7 +16136,7 @@ "tl2_requires_likes_given": { "type": "integer", "example": 1, - "description": "\"How many likes a user must cast before promotion to trust level 2.\"\n" + "description": "\"How many likes a user must cast before promotion to trust level 2.\"" } } } @@ -16335,14 +16145,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_requires_topic_reply_count": { "put": { - "description": "tl2 requires topic reply count\n", + "description": "tl2 requires topic reply count", "tags": [ "Site Settings Trust Levels" ], @@ -16358,7 +16168,7 @@ "tl2_requires_topic_reply_count": { "type": "integer", "example": 3, - "description": "\"How many topics user must reply to before promotion to trust level 2.\"\n" + "description": "\"How many topics user must reply to before promotion to trust level 2.\"" } } } @@ -16367,14 +16177,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_time_period": { "put": { - "description": "tl2 time period\n", + "description": "tl2 time period", "tags": [ "Site Settings Trust Levels" ], @@ -16390,7 +16200,7 @@ "tl3_time_period": { "type": "integer", "example": 100, - "description": "\"Trust Level 3 requirements time period (in days)\"\n" + "description": "\"Trust Level 3 requirements time period (in days)\"" } } } @@ -16399,14 +16209,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_days_visited": { "put": { - "description": "tl3 requires days visited\n", + "description": "tl3 requires days visited", "tags": [ "Site Settings Trust Levels" ], @@ -16422,7 +16232,7 @@ "tl3_requires_days_visited": { "type": "integer", "example": 50, - "description": "\"Minimum number of days that a user needs to have visited the site in the last (tl3 time period) days to qualify for promotion to trust level 3. Set higher than tl3 time period to disable promotions to tl3. (0 or higher)\"\n" + "description": "\"Minimum number of days that a user needs to have visited the site in the last (tl3 time period) days to qualify for promotion to trust level 3. Set higher than tl3 time period to disable promotions to tl3. (0 or higher)\"" } } } @@ -16431,14 +16241,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_topics_replied_to": { "put": { - "description": "tl3 requires topics replied to\n", + "description": "tl3 requires topics replied to", "tags": [ "Site Settings Trust Levels" ], @@ -16454,7 +16264,7 @@ "tl3_requires_topics_replied_to": { "type": "integer", "example": 10, - "description": "\"Minimum number of topics a user needs to have replied to in the last (tl3 time period) days to qualify for promotion to trust level 3. (0 or higher)\"\n" + "description": "\"Minimum number of topics a user needs to have replied to in the last (tl3 time period) days to qualify for promotion to trust level 3. (0 or higher)\"" } } } @@ -16463,14 +16273,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_topics_viewed": { "put": { - "description": "tl3 requires topics viewed\n", + "description": "tl3 requires topics viewed", "tags": [ "Site Settings Trust Levels" ], @@ -16486,7 +16296,7 @@ "tl3_requires_topics_viewed": { "type": "integer", "example": 25, - "description": "\"The percentage of topics created in the last (tl3 time period) days that a user needs to have viewed to qualify for promotion to trust level 3. (0 to 100)\"\n" + "description": "\"The percentage of topics created in the last (tl3 time period) days that a user needs to have viewed to qualify for promotion to trust level 3. (0 to 100)\"" } } } @@ -16495,14 +16305,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_topics_viewed_cap": { "put": { - "description": "tl3 requires topics viewed cap\n", + "description": "tl3 requires topics viewed cap", "tags": [ "Site Settings Trust Levels" ], @@ -16518,7 +16328,7 @@ "tl3_requires_topics_viewed_cap": { "type": "integer", "example": 500, - "description": "\"The maximum required number of topics viewed in the last (tl3 time period) days.\"\n" + "description": "\"The maximum required number of topics viewed in the last (tl3 time period) days.\"" } } } @@ -16527,14 +16337,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_posts_read": { "put": { - "description": "tl3 requires posts read\n", + "description": "tl3 requires posts read", "tags": [ "Site Settings Trust Levels" ], @@ -16550,7 +16360,7 @@ "tl3_requires_posts_read": { "type": "integer", "example": 25, - "description": "\"The percentage of posts created in the last (tl3 time period) days that a user needs to have viewed to qualify for promotion to trust level 3. (0 to 100)\"\n" + "description": "\"The percentage of posts created in the last (tl3 time period) days that a user needs to have viewed to qualify for promotion to trust level 3. (0 to 100)\"" } } } @@ -16559,14 +16369,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_posts_read_cap": { "put": { - "description": "tl3 requires posts read cap\n", + "description": "tl3 requires posts read cap", "tags": [ "Site Settings Trust Levels" ], @@ -16582,7 +16392,7 @@ "tl3_requires_posts_read_cap": { "type": "integer", "example": 20000, - "description": "\"The maximum required number of posts read in the last (tl3 time period) days.\"\n" + "description": "\"The maximum required number of posts read in the last (tl3 time period) days.\"" } } } @@ -16591,14 +16401,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_topics_viewed_all_time": { "put": { - "description": "tl3 requires topics viewed all time\n", + "description": "tl3 requires topics viewed all time", "tags": [ "Site Settings Trust Levels" ], @@ -16614,7 +16424,7 @@ "tl3_requires_viewed_all_time": { "type": "integer", "example": 200, - "description": "\"The minimum total number of topics a user must have viewed to qualify for trust level 3.\"\n" + "description": "\"The minimum total number of topics a user must have viewed to qualify for trust level 3.\"" } } } @@ -16623,14 +16433,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_posts_read_all_time": { "put": { - "description": "tl3 requires posts read all time\n", + "description": "tl3 requires posts read all time", "tags": [ "Site Settings Trust Levels" ], @@ -16646,7 +16456,7 @@ "tl3_requires_posts_read_all_time": { "type": "integer", "example": 500, - "description": "\"The minimum total number of posts a user must have read to qualify for trust level 3.\"\n" + "description": "\"The minimum total number of posts a user must have read to qualify for trust level 3.\"" } } } @@ -16655,14 +16465,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_max_flagged": { "put": { - "description": "tl3 requires max flagged\n", + "description": "tl3 requires max flagged", "tags": [ "Site Settings Trust Levels" ], @@ -16678,7 +16488,7 @@ "tl3_requires_max_flagged": { "type": "integer", "example": 5, - "description": "\"User must not have had more than x posts flagged by x different users in the last (tl3 time period) days to qualify for promotion to trust level 3, where x is this setting's value. (0 or higher)\"\n" + "description": "\"User must not have had more than x posts flagged by x different users in the last (tl3 time period) days to qualify for promotion to trust level 3, where x is this setting's value. (0 or higher)\"" } } } @@ -16687,14 +16497,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_promotion_min_duration": { "put": { - "description": "tl3 promotion min duration\n", + "description": "tl3 promotion min duration", "tags": [ "Site Settings Trust Levels" ], @@ -16710,7 +16520,7 @@ "tl3_promotion_min_duration": { "type": "integer", "example": 14, - "description": "\"The minimum number of days that a promotion to trust level 3 lasts before a user can be demoted back to trust level 2.\"\n" + "description": "\"The minimum number of days that a promotion to trust level 3 lasts before a user can be demoted back to trust level 2.\"" } } } @@ -16719,14 +16529,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_likes_given": { "put": { - "description": "tl3 requires likes given\n", + "description": "tl3 requires likes given", "tags": [ "Site Settings Trust Levels" ], @@ -16742,7 +16552,7 @@ "tl3_requires_likes_given": { "type": "integer", "example": 30, - "description": "\"The minimum number of likes that must be given in the last (tl3 time period) days to qualify for promotion to trust level 3.\"\n" + "description": "\"The minimum number of likes that must be given in the last (tl3 time period) days to qualify for promotion to trust level 3.\"" } } } @@ -16751,14 +16561,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_requires_likes_received": { "put": { - "description": "tl3 requires likes received\n", + "description": "tl3 requires likes received", "tags": [ "Site Settings Trust Levels" ], @@ -16774,7 +16584,7 @@ "tl3_requires_likes_received": { "type": "integer", "example": 20, - "description": "\"The minimum number of likes that must be received in the last (tl3 time period) days to qualify for promotion to trust level 3.\"\n" + "description": "\"The minimum number of likes that must be received in the last (tl3 time period) days to qualify for promotion to trust level 3.\"" } } } @@ -16783,14 +16593,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_links_no_follow": { "put": { - "description": "tl3 links no follow\n", + "description": "tl3 links no follow", "tags": [ "Site Settings Trust Levels" ], @@ -16806,7 +16616,7 @@ "tl3_links_no_follow": { "type": "boolean", "example": false, - "description": "\"Do not remove rel=nofollow from links posted by trust level 3 users.\"\n" + "description": "\"Do not remove rel=nofollow from links posted by trust level 3 users.\"" } } } @@ -16815,14 +16625,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/force_https": { "put": { - "description": "force https\n", + "description": "force https", "tags": [ "Site Settings Security" ], @@ -16838,7 +16648,7 @@ "force_https": { "type": "boolean", "example": false, - "description": "\"Force your site to use HTTPS only. WARNING: do NOT enable this until you verify HTTPS is fully set up and working absolutely everywhere! Did you check your CDN, all social logins, and any external logos / dependencies to make sure they are all HTTPS compatible, too?\"\n" + "description": "\"Force your site to use HTTPS only. WARNING: do NOT enable this until you verify HTTPS is fully set up and working absolutely everywhere! Did you check your CDN, all social logins, and any external logos / dependencies to make sure they are all HTTPS compatible, too?\"" } } } @@ -16847,14 +16657,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_escaped_fragments": { "put": { - "description": "enable escaped fragments\n", + "description": "enable escaped fragments", "tags": [ "Site Settings Security" ], @@ -16870,7 +16680,7 @@ "enable_escaped_fragments": { "type": "boolean", "example": true, - "description": "\"Fall back to Google's Ajax-Crawling API if no webcrawler is detected. See https://developers.google.com/webmasters/ajax-crawling/docs/learn-more\"\n" + "description": "\"Fall back to Google's Ajax-Crawling API if no webcrawler is detected. See https://developers.google.com/webmasters/ajax-crawling/docs/learn-more\"" } } } @@ -16879,14 +16689,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_index_in_robots_txt": { "put": { - "description": "allow index in robots txt\n", + "description": "allow index in robots txt", "tags": [ "Site Settings Security" ], @@ -16902,7 +16712,7 @@ "allow_index_in_robots_txt": { "type": "boolean", "example": true, - "description": "\"Specify in robots.txt that this site is allowed to be indexed by web search engines.\"\n" + "description": "\"Specify in robots.txt that this site is allowed to be indexed by web search engines.\"" } } } @@ -16911,14 +16721,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_noscript_support": { "put": { - "description": "enable noscript support\n", + "description": "enable noscript support", "tags": [ "Site Settings Security" ], @@ -16934,7 +16744,7 @@ "enable_noscript_support": { "type": "boolean", "example": true, - "description": "\"Enable standard webcrawler search engine support via the noscript tag\"\n" + "description": "\"Enable standard webcrawler search engine support via the noscript tag\"" } } } @@ -16943,14 +16753,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_moderators_to_create_categories": { "put": { - "description": "allow moderators to create categories\n", + "description": "allow moderators to create categories", "tags": [ "Site Settings Security" ], @@ -16966,7 +16776,7 @@ "allow_moderators_to_create_categories": { "type": "boolean", "example": false, - "description": "\"Allow moderators to create new categories\"\n" + "description": "\"Allow moderators to create new categories\"" } } } @@ -16975,14 +16785,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/cors_origins": { "put": { - "description": "cors origins\n", + "description": "cors origins", "tags": [ "Site Settings Security" ], @@ -16998,7 +16808,7 @@ "cors_origins": { "type": "string", "example": "", - "description": "\"Allowed origins for cross-origin requests (CORS). Each origin must include http:// or https://. The DISCOURSE_ENABLE_CORS env variable must be set to true to enable CORS.\"\n" + "description": "\"Allowed origins for cross-origin requests (CORS). Each origin must include http:// or https://. The DISCOURSE_ENABLE_CORS env variable must be set to true to enable CORS.\"" } } } @@ -17007,14 +16817,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/use_admin_ip_whitelist": { "put": { - "description": "use admin ip whitelist\n", + "description": "use admin ip whitelist", "tags": [ "Site Settings Security" ], @@ -17030,7 +16840,7 @@ "use_admin_ip_whitelist": { "type": "boolean", "example": false, - "description": "\"Admins can only log in if they are at an IP address defined in the Screened IPs list (Admin > Logs > Screened Ips).\"\n" + "description": "\"Admins can only log in if they are at an IP address defined in the Screened IPs list (Admin > Logs > Screened Ips).\"" } } } @@ -17039,14 +16849,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_flash_video_onebox": { "put": { - "description": "enable flash video onebox\n", + "description": "enable flash video onebox", "tags": [ "Site Settings Onebox" ], @@ -17062,7 +16872,7 @@ "enable_flash_video_onebox": { "type": "boolean", "example": false, - "description": "\"Enable embedding of swf and flv (Adobe Flash) links in oneboxes. WARNING: may introduce security risks.\"\n" + "description": "\"Enable embedding of swf and flv (Adobe Flash) links in oneboxes. WARNING: may introduce security risks.\"" } } } @@ -17071,14 +16881,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/post_onebox_maxlength": { "put": { - "description": "post onebox maxlength\n", + "description": "post onebox maxlength", "tags": [ "Site Settings Onebox" ], @@ -17094,7 +16904,7 @@ "post_onebox_maxlength": { "type": "integer", "example": 500, - "description": "\"Maximum length of a oneboxed Discourse post in characters.\"\n" + "description": "\"Maximum length of a oneboxed Discourse post in characters.\"" } } } @@ -17103,14 +16913,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/onebox_domains_blacklist": { "put": { - "description": "onebox domains blacklist\n", + "description": "onebox domains blacklist", "tags": [ "Site Settings Onebox" ], @@ -17126,7 +16936,7 @@ "onebox_domains_blacklist": { "type": "string", "example": "", - "description": "\"A list of domains that will never be oneboxed.\"\n" + "description": "\"A list of domains that will never be oneboxed.\"" } } } @@ -17135,14 +16945,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_oneboxes_per_post": { "put": { - "description": "max oneboxes per post\n", + "description": "max oneboxes per post", "tags": [ "Site Settings Onebox" ], @@ -17158,7 +16968,7 @@ "max_oneboxes_per_post": { "type": "integer", "example": 50, - "description": "\"Enable embedding of swf and flv (Adobe Flash) links in oneboxes. WARNING: may introduce security risks.\"\n" + "description": "\"Enable embedding of swf and flv (Adobe Flash) links in oneboxes. WARNING: may introduce security risks.\"" } } } @@ -17167,14 +16977,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/add_rel_nofollow_to_user_content": { "put": { - "description": "add rel nofollow to user content\n", + "description": "add rel nofollow to user content", "tags": [ "Site Settings Spam" ], @@ -17190,7 +17000,7 @@ "add_rel_nofollow_to_user_content": { "type": "boolean", "example": true, - "description": "'Add rel nofollow to all submitted user content, except for internal links (including parent domains). If you change this, you must rebake all posts with: \"rake posts:rebake\"'\n" + "description": "'Add rel nofollow to all submitted user content, except for internal links (including parent domains). If you change this, you must rebake all posts with: \"rake posts:rebake\"'" } } } @@ -17199,14 +17009,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/flags_required_to_hide_post": { "put": { - "description": "flags required to hide post\n", + "description": "flags required to hide post", "tags": [ "Site Settings Spam" ], @@ -17222,7 +17032,7 @@ "flags_required_to_hide_post": { "type": "integer", "example": 3, - "description": "\"Number of flags that cause a post to be automatically hidden and message sent to the user (0 for never)\"\n" + "description": "\"Number of flags that cause a post to be automatically hidden and message sent to the user (0 for never)\"" } } } @@ -17231,14 +17041,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/cooldown_minutes_after_hiding_posts": { "put": { - "description": "cooldown minutes after hiding posts\n", + "description": "cooldown minutes after hiding posts", "tags": [ "Site Settings Spam" ], @@ -17254,7 +17064,7 @@ "cooldown_minutes_after_hiding_posts": { "type": "integer", "example": 10, - "description": "\"Number of minutes a user must wait before they can edit a post hidden via community flagging\"\n" + "description": "\"Number of minutes a user must wait before they can edit a post hidden via community flagging\"" } } } @@ -17263,14 +17073,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_spam_flags_to_block_new_user": { "put": { - "description": "num spam flags to block new user\n", + "description": "num spam flags to block new user", "tags": [ "Site Settings Spam" ], @@ -17286,7 +17096,7 @@ "num_spam_flags_to_block_new_user": { "type": "integer", "example": 3, - "description": "\"If a new user's posts get this many spam flags from num_users_to_block_new_user different users, hide all their posts and prevent future posting. 0 to disable.\"\n" + "description": "\"If a new user's posts get this many spam flags from num_users_to_block_new_user different users, hide all their posts and prevent future posting. 0 to disable.\"" } } } @@ -17295,14 +17105,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_users_to_block_new_user": { "put": { - "description": "num users to block new user\n", + "description": "num users to block new user", "tags": [ "Site Settings Spam" ], @@ -17318,7 +17128,7 @@ "num_users_to_block_new_user": { "type": "integer", "example": 3, - "description": "\"If a new user's posts get num_spam_flags_to_block_new_user spam flags from this many different users, hide all their posts and prevent future posting. 0 to disable.\"\n" + "description": "\"If a new user's posts get num_spam_flags_to_block_new_user spam flags from this many different users, hide all their posts and prevent future posting. 0 to disable.\"" } } } @@ -17327,14 +17137,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_tl3_flags_to_block_new_user": { "put": { - "description": "num tl3 flags to block new user\n", + "description": "num tl3 flags to block new user", "tags": [ "Site Settings Spam" ], @@ -17350,7 +17160,7 @@ "num_tl3_flags_to_block_new_user": { "type": "integer", "example": 4, - "description": "\"If a new user's posts get this many flags from num_tl3_users_to_block_new_user different trust level 3 users, hide all their posts and prevent future posting. 0 to disable.\"\n" + "description": "\"If a new user's posts get this many flags from num_tl3_users_to_block_new_user different trust level 3 users, hide all their posts and prevent future posting. 0 to disable.\"" } } } @@ -17359,14 +17169,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_tl3_users_to_block_new_user": { "put": { - "description": "num tl3 users to block new user\n", + "description": "num tl3 users to block new user", "tags": [ "Site Settings Spam" ], @@ -17382,7 +17192,7 @@ "num_tl3_users_to_block_new_user": { "type": "integer", "example": 2, - "description": "\"If a new user's posts get num_tl3_flags_to_block_new_user flags from this many different trust level 3 users, hide all their posts and prevent future posting. 0 to disable.\"\n" + "description": "\"If a new user's posts get num_tl3_flags_to_block_new_user flags from this many different trust level 3 users, hide all their posts and prevent future posting. 0 to disable.\"" } } } @@ -17391,14 +17201,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/notify_mods_when_user_blocked": { "put": { - "description": "notify mods when user blocked\n", + "description": "notify mods when user blocked", "tags": [ "Site Settings Spam" ], @@ -17414,7 +17224,7 @@ "notify_mods_when_user_blocked": { "type": "boolean", "example": false, - "description": "\"If a user is automatically blocked, send a message to all moderators.\"\n" + "description": "\"If a user is automatically blocked, send a message to all moderators.\"" } } } @@ -17423,14 +17233,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/flag_sockpuppets": { "put": { - "description": "flag sockpuppets\n", + "description": "flag sockpuppets", "tags": [ "Site Settings Spam" ], @@ -17446,7 +17256,7 @@ "flag_sockpuppets": { "type": "boolean", "example": false, - "description": "\"If a new user replies to a topic from the same IP address as the new user who started the topic, flag both of their posts as potential spam.\"\n" + "description": "\"If a new user replies to a topic from the same IP address as the new user who started the topic, flag both of their posts as potential spam.\"" } } } @@ -17455,14 +17265,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/newuser_spam_host_threshold": { "put": { - "description": "newuser spam host threshold\n", + "description": "newuser spam host threshold", "tags": [ "Site Settings Spam" ], @@ -17478,7 +17288,7 @@ "newuser_spam_host_threshold": { "type": "integer", "example": 3, - "description": "\"How many times a new user can post a link to the same host within their `newuser_spam_host_threshold` posts before being considered spam.\"\n" + "description": "\"How many times a new user can post a link to the same host within their `newuser_spam_host_threshold` posts before being considered spam.\"" } } } @@ -17487,14 +17297,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/white_listed_spam_host_domains": { "put": { - "description": "white listed spam host domains\n", + "description": "white listed spam host domains", "tags": [ "Site Settings Spam" ], @@ -17510,7 +17320,7 @@ "white_listed_spam_host_domains": { "type": "string", "example": "", - "description": "\"A list of domains excluded from spam host testing. New users will never be restricted from creating posts with links to these domains.\"\n" + "description": "\"A list of domains excluded from spam host testing. New users will never be restricted from creating posts with links to these domains.\"" } } } @@ -17519,14 +17329,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/levenshtein_distance_spammer_emails": { "put": { - "description": "levenshtein distance spammer emails\n", + "description": "levenshtein distance spammer emails", "tags": [ "Site Settings Spam" ], @@ -17542,7 +17352,7 @@ "levenshtein_distance_spammer_emails": { "type": "integer", "example": 2, - "description": "\"When matching spammer emails, number of characters difference that will still allow a fuzzy match.\"\n" + "description": "\"When matching spammer emails, number of characters difference that will still allow a fuzzy match.\"" } } } @@ -17551,14 +17361,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_new_accounts_per_registration_ip": { "put": { - "description": "max new accounts per registration ip\n", + "description": "max new accounts per registration ip", "tags": [ "Site Settings Spam" ], @@ -17574,7 +17384,7 @@ "max_new_accounts_per_registration_ip": { "type": "integer", "example": 3, - "description": "\"If there are already (n) trust level 0 accounts from this IP (and none is a staff member or at TL2 or higher), stop accepting new signups from that IP.\"\n" + "description": "\"If there are already (n) trust level 0 accounts from this IP (and none is a staff member or at TL2 or higher), stop accepting new signups from that IP.\"" } } } @@ -17583,14 +17393,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_ban_entries_for_roll_up": { "put": { - "description": "min ban entries for roll up\n", + "description": "min ban entries for roll up", "tags": [ "Site Settings Spam" ], @@ -17606,7 +17416,7 @@ "min_ban_entries_for_roll_up": { "type": "integer", "example": 5, - "description": "\"When clicking the Roll up button, will create a new subnet ban entry if there are at least (N) entries.\"\n" + "description": "\"When clicking the Roll up button, will create a new subnet ban entry if there are at least (N) entries.\"" } } } @@ -17615,14 +17425,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_age_unmatched_emails": { "put": { - "description": "max age unmatched emails\n", + "description": "max age unmatched emails", "tags": [ "Site Settings Spam" ], @@ -17638,7 +17448,7 @@ "max_age_unmatched_emails": { "type": "integer", "example": 365, - "description": "\"Delete unmatched screened email entries after (N) days.\"\n" + "description": "\"Delete unmatched screened email entries after (N) days.\"" } } } @@ -17647,14 +17457,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_age_unmatched_ips": { "put": { - "description": "max age unmatched ips\n", + "description": "max age unmatched ips", "tags": [ "Site Settings Spam" ], @@ -17670,7 +17480,7 @@ "max_age_unmatched_ips": { "type": "integer", "example": 365, - "description": "\"Delete unmatched screened IP entries after (N) days.\"\n" + "description": "\"Delete unmatched screened IP entries after (N) days.\"" } } } @@ -17679,14 +17489,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_flaggers_to_close_topic": { "put": { - "description": "num flaggers to close topic\n", + "description": "num flaggers to close topic", "tags": [ "Site Settings Spam" ], @@ -17702,7 +17512,7 @@ "num_flaggers_to_close_topic": { "type": "integer", "example": 5, - "description": "\"Minimum number of unique flaggers that is required to automatically pause a topic for intervention\"\n" + "description": "\"Minimum number of unique flaggers that is required to automatically pause a topic for intervention\"" } } } @@ -17711,14 +17521,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/num_flags_to_close_topic": { "put": { - "description": "num flags to close topic\n", + "description": "num flags to close topic", "tags": [ "Site Settings Spam" ], @@ -17734,7 +17544,7 @@ "num_flags_to_close_topic": { "type": "integer", "example": 12, - "description": "\"Minimum number of active flags that is required to automatically pause a topic for intervention\"\n" + "description": "\"Minimum number of active flags that is required to automatically pause a topic for intervention\"" } } } @@ -17743,14 +17553,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_respond_to_flag_actions": { "put": { - "description": "auto respond to flag actions\n", + "description": "auto respond to flag actions", "tags": [ "Site Settings Spam" ], @@ -17766,7 +17576,7 @@ "auto_respond_to_flag_actions": { "type": "boolean", "example": true, - "description": "\"Enable automatic reply when disposing a flag.\"\n" + "description": "\"Enable automatic reply when disposing a flag.\"" } } } @@ -17775,14 +17585,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_first_post_typing_time": { "put": { - "description": "min first post typing time\n", + "description": "min first post typing time", "tags": [ "Site Settings Spam" ], @@ -17798,7 +17608,7 @@ "min_first_post_typing_time": { "type": "integer", "example": 3000, - "description": "\"Minimum amount of time in milliseconds a user must type during first post, if threshold is not met post will automatically enter the needs approval queue. Set to 0 to disable (not recommended)\"\n" + "description": "\"Minimum amount of time in milliseconds a user must type during first post, if threshold is not met post will automatically enter the needs approval queue. Set to 0 to disable (not recommended)\"" } } } @@ -17807,14 +17617,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_block_fast_typers_on_first_post": { "put": { - "description": "auto block fast typers on first post\n", + "description": "auto block fast typers on first post", "tags": [ "Site Settings Spam" ], @@ -17830,7 +17640,7 @@ "auto_block_fast_typers_on_first_post": { "type": "boolean", "example": true, - "description": "\"Automatically block users that do not meet min_first_post_typing_time\"\n" + "description": "\"Automatically block users that do not meet min_first_post_typing_time\"" } } } @@ -17839,14 +17649,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_block_fast_typers_max_trust_level": { "put": { - "description": "auto block fast typers max trust level\n", + "description": "auto block fast typers max trust level", "tags": [ "Site Settings Spam" ], @@ -17862,7 +17672,7 @@ "auto_block_fast_typers_max_trust_level": { "type": "integer", "example": 0, - "description": "\"Maximum trust level to auto block fast typers\"\n" + "description": "\"Maximum trust level to auto block fast typers\"" } } } @@ -17871,14 +17681,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/auto_block_first_post_regex": { "put": { - "description": "auto block first post regex\n", + "description": "auto block first post regex", "tags": [ "Site Settings Spam" ], @@ -17894,7 +17704,7 @@ "auto_block_first_post_regex": { "type": "string", "example": "", - "description": "\"Case insensitive regex that if passed will cause first post by user to be blocked and sent to approval queue. Example: raging|a[bc]a , will cause all posts containing raging or aba or aca to be blocked on first. Only applies to first post.\"\n" + "description": "\"Case insensitive regex that if passed will cause first post by user to be blocked and sent to approval queue. Example: raging|a[bc]a , will cause all posts containing raging or aba or aca to be blocked on first. Only applies to first post.\"" } } } @@ -17903,14 +17713,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/unique_posts_min": { "put": { - "description": "unique posts mins\n", + "description": "unique posts mins", "tags": [ "Site Settings Rate Limits" ], @@ -17926,7 +17736,7 @@ "unique_posts_min": { "type": "integer", "example": 5, - "description": "\"How many minutes before a user can make a post with the same content again\"\n" + "description": "\"How many minutes before a user can make a post with the same content again\"" } } } @@ -17935,14 +17745,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/rate_limit_create_topic": { "put": { - "description": "rate limit create topic\n", + "description": "rate limit create topic", "tags": [ "Site Settings Rate Limits" ], @@ -17958,7 +17768,7 @@ "rate_limit_create_topic": { "type": "integer", "example": 16, - "description": "\"After creating a topic, users must wait (n) seconds before creating another topic.\"\n" + "description": "\"After creating a topic, users must wait (n) seconds before creating another topic.\"" } } } @@ -17967,14 +17777,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/rate_limit_create_post": { "put": { - "description": "rate limit create post\n", + "description": "rate limit create post", "tags": [ "Site Settings Rate Limits" ], @@ -17990,7 +17800,7 @@ "rate_limit_create_post": { "type": "integer", "example": 5, - "description": "\"After posting, users must wait (n) seconds before creating another post.\"\n" + "description": "\"After posting, users must wait (n) seconds before creating another post.\"" } } } @@ -17999,14 +17809,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/rate_limit_new_user_create_topic": { "put": { - "description": "rate limit new user create topic\n", + "description": "rate limit new user create topic", "tags": [ "Site Settings Rate Limits" ], @@ -18022,7 +17832,7 @@ "rate_limit_new_user_create_topic": { "type": "integer", "example": 120, - "description": "\"After creating a topic, new users must wait (n) seconds before creating another topic.\"\n" + "description": "\"After creating a topic, new users must wait (n) seconds before creating another topic.\"" } } } @@ -18031,14 +17841,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/rate_limit_new_user_create_post": { "put": { - "description": "rate limit new user create post\n", + "description": "rate limit new user create post", "tags": [ "Site Settings Rate Limits" ], @@ -18054,7 +17864,7 @@ "rate_limit_new_user_create_post": { "type": "integer", "example": 30, - "description": "\"After posting, new users must wait (n) seconds before creating another post.\"\n" + "description": "\"After posting, new users must wait (n) seconds before creating another post.\"" } } } @@ -18063,14 +17873,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_topics_per_day": { "put": { - "description": "max topics per day\n", + "description": "max topics per day", "tags": [ "Site Settings Rate Limits" ], @@ -18086,7 +17896,7 @@ "max_topics_per_day": { "type": "integer", "example": 20, - "description": "\"Maximum number of topics a user can create per day.\"\n" + "description": "\"Maximum number of topics a user can create per day.\"" } } } @@ -18095,14 +17905,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_private_messages_per_day": { "put": { - "description": "max private messages per day\n", + "description": "max private messages per day", "tags": [ "Site Settings Rate Limits" ], @@ -18118,7 +17928,7 @@ "max_private_messages_per_day": { "type": "integer", "example": 20, - "description": "\"Maximum number of messages users can create per day.\"\n" + "description": "\"Maximum number of messages users can create per day.\"" } } } @@ -18127,14 +17937,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_likes_per_day": { "put": { - "description": "max likes per day\n", + "description": "max likes per day", "tags": [ "Site Settings Rate Limits" ], @@ -18150,7 +17960,7 @@ "max_likes_per_day": { "type": "integer", "example": 50, - "description": "\"Maximum number of likes per user per day.\"\n" + "description": "\"Maximum number of likes per user per day.\"" } } } @@ -18159,14 +17969,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_bookmarks_per_day": { "put": { - "description": "max bookmarks per day\n", + "description": "max bookmarks per day", "tags": [ "Site Settings Rate Limits" ], @@ -18182,7 +17992,7 @@ "max_bookmarks_per_day": { "type": "integer", "example": 20, - "description": "\"Maximum number of bookmarks per user per day.\"\n" + "description": "\"Maximum number of bookmarks per user per day.\"" } } } @@ -18191,14 +18001,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_flags_per_day": { "put": { - "description": "max flags per day\n", + "description": "max flags per day", "tags": [ "Site Settings Rate Limits" ], @@ -18214,7 +18024,7 @@ "max_flags_per_day": { "type": "integer", "example": 20, - "description": "\"Maximum number of flags per user per day.\"\n" + "description": "\"Maximum number of flags per user per day.\"" } } } @@ -18223,14 +18033,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_edits_per_day": { "put": { - "description": "max edits per day\n", + "description": "max edits per day", "tags": [ "Site Settings Rate Limits" ], @@ -18246,7 +18056,7 @@ "max_edits_per_day": { "type": "integer", "example": 30, - "description": "\"Maximum number of edits per user per day.\"\n" + "description": "\"Maximum number of edits per user per day.\"" } } } @@ -18255,14 +18065,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_invites_per_day": { "put": { - "description": "max invites per day\n", + "description": "max invites per day", "tags": [ "Site Settings Rate Limits" ], @@ -18278,7 +18088,7 @@ "max_invites_per_day": { "type": "integer", "example": 10, - "description": "\"Maximum number of invites a user can send per day.\"\n" + "description": "\"Maximum number of invites a user can send per day.\"" } } } @@ -18287,14 +18097,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_topic_invitations_per_day": { "put": { - "description": "max topic invitations per day\n", + "description": "max topic invitations per day", "tags": [ "Site Settings Rate Limits" ], @@ -18310,7 +18120,7 @@ "max_topic_invitations_per_day": { "type": "integer", "example": 30, - "description": "\"Maximum number of topic invitations a user can send per day.\"\n" + "description": "\"Maximum number of topic invitations a user can send per day.\"" } } } @@ -18319,14 +18129,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_topics_in_first_day": { "put": { - "description": "max topics in first day\n", + "description": "max topics in first day", "tags": [ "Site Settings Rate Limits" ], @@ -18342,7 +18152,7 @@ "max_topics_in_first_day": { "type": "integer", "example": 3, - "description": "\"The maximum number of topics a user is allowed to create in the 24 hour period after creating their first post\"\n" + "description": "\"The maximum number of topics a user is allowed to create in the 24 hour period after creating their first post\"" } } } @@ -18351,14 +18161,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_replies_in_first_day": { "put": { - "description": "max replies in first day\n", + "description": "max replies in first day", "tags": [ "Site Settings Rate Limits" ], @@ -18374,7 +18184,7 @@ "max_replies_in_first_day": { "type": "integer", "example": 10, - "description": "\"The maximum number of replies a user is allowed to create in the 24 hour period after creating their first post\"\n" + "description": "\"The maximum number of replies a user is allowed to create in the 24 hour period after creating their first post\"" } } } @@ -18383,14 +18193,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl2_additional_likes_per_day_multiplier": { "put": { - "description": "tl2 additional likes per day multiplier\n", + "description": "tl2 additional likes per day multiplier", "tags": [ "Site Settings Rate Limits" ], @@ -18406,7 +18216,7 @@ "tl2_additional_likes_per_day_multiplier": { "type": "number", "example": 1.5, - "description": "\"Increase limit of likes per day for tl2 (member) by multiplying with this number\"\n" + "description": "\"Increase limit of likes per day for tl2 (member) by multiplying with this number\"" } } } @@ -18415,14 +18225,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl3_additional_likes_per_day_multiplier": { "put": { - "description": "tl3 additional likes per day multiplier\n", + "description": "tl3 additional likes per day multiplier", "tags": [ "Site Settings Rate Limits" ], @@ -18438,7 +18248,7 @@ "tl3_additional_likes_per_day_multiplier": { "type": "number", "example": 2, - "description": "\"Increase limit of likes per day for tl3 (regular) by multiplying with this number\"\n" + "description": "\"Increase limit of likes per day for tl3 (regular) by multiplying with this number\"" } } } @@ -18447,14 +18257,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tl4_additional_likes_per_day_multiplier": { "put": { - "description": "tl4 additional likes per day multiplier\n", + "description": "tl4 additional likes per day multiplier", "tags": [ "Site Settings Rate Limits" ], @@ -18470,7 +18280,7 @@ "tl4_additional_likes_per_day_multiplier": { "type": "number", "example": 3, - "description": "\"Increase limit of likes per day for tl4 (leader) by multiplying with this number\"\n" + "description": "\"Increase limit of likes per day for tl4 (leader) by multiplying with this number\"" } } } @@ -18479,14 +18289,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/alert_admins_if_errors_per_minute": { "put": { - "description": "alert admins if errors per minute\n", + "description": "alert admins if errors per minute", "tags": [ "Site Settings Rate Limits" ], @@ -18502,7 +18312,7 @@ "alert_admins_if_errors_per_minute": { "type": "integer", "example": 0, - "description": "\"Number of errors per minute in order to trigger an admin alert. A value of 0 disables this feature. NOTE: requires restart.\"\n" + "description": "\"Number of errors per minute in order to trigger an admin alert. A value of 0 disables this feature. NOTE: requires restart.\"" } } } @@ -18511,14 +18321,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/alert_admins_if_errors_per_hour": { "put": { - "description": "alert admins if errors per hour\n", + "description": "alert admins if errors per hour", "tags": [ "Site Settings Rate Limits" ], @@ -18534,7 +18344,7 @@ "alert_admins_if_errors_per_hour": { "type": "integer", "example": 0, - "description": "\"Number of errors per hour in order to trigger an admin alert. A value of 0 disables this feature. NOTE: requires restart.\"\n" + "description": "\"Number of errors per hour in order to trigger an admin alert. A value of 0 disables this feature. NOTE: requires restart.\"" } } } @@ -18543,14 +18353,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_prints_per_hour_per_user": { "put": { - "description": "max prints per hour per user\n", + "description": "max prints per hour per user", "tags": [ "Site Settings Rate Limits" ], @@ -18566,7 +18376,7 @@ "max_prints_per_hour_per_user": { "type": "integer", "example": 5, - "description": "\"Maximum number of /print page impressions (set to 0 to disable)\"\n" + "description": "\"Maximum number of /print page impressions (set to 0 to disable)\"" } } } @@ -18575,14 +18385,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/force_hostname": { "put": { - "description": "force hostname\n", + "description": "force hostname", "tags": [ "Site Settings Developer" ], @@ -18598,7 +18408,7 @@ "force_hostname": { "type": "string", "example": "", - "description": "\"DEVELOPER ONLY! WARNING! Specify a hostname in the URL. Leave blank for default.\"\n" + "description": "\"DEVELOPER ONLY! WARNING! Specify a hostname in the URL. Leave blank for default.\"" } } } @@ -18607,14 +18417,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/port": { "put": { - "description": "port\n", + "description": "port", "tags": [ "Site Settings Developer" ], @@ -18630,7 +18440,7 @@ "port": { "type": "integer", "example": 3000, - "description": "\"DEVELOPER ONLY! WARNING! Use this HTTP port rather than the default of port 80. Leave blank for default of 80.\"\n" + "description": "\"DEVELOPER ONLY! WARNING! Use this HTTP port rather than the default of port 80. Leave blank for default of 80.\"" } } } @@ -18639,14 +18449,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/queue_jobs": { "put": { - "description": "queue jobs\n", + "description": "queue jobs", "tags": [ "Site Settings Developer" ], @@ -18662,7 +18472,7 @@ "port": { "type": "boolean", "example": true, - "description": "\"DEVELOPER ONLY! WARNING! By default, queue jobs in sidekiq. If disabled, your site will be broken.\"\n" + "description": "\"DEVELOPER ONLY! WARNING! By default, queue jobs in sidekiq. If disabled, your site will be broken.\"" } } } @@ -18671,14 +18481,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_long_polling": { "put": { - "description": "enable long polling\n", + "description": "enable long polling", "tags": [ "Site Settings Developer" ], @@ -18694,7 +18504,7 @@ "enable_long_polling": { "type": "boolean", "example": true, - "description": "\"Message bus used for notification can use long polling\"\n" + "description": "\"Message bus used for notification can use long polling\"" } } } @@ -18703,14 +18513,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/long_polling_interval": { "put": { - "description": "long polling interval\n", + "description": "long polling interval", "tags": [ "Site Settings Developer" ], @@ -18726,7 +18536,7 @@ "long_polling_interval": { "type": "integer", "example": 25000, - "description": "\"Amount of time the server should wait before responding to clients when there is no data to send (logged on users only)\"\n" + "description": "\"Amount of time the server should wait before responding to clients when there is no data to send (logged on users only)\"" } } } @@ -18735,14 +18545,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/long_polling_base_url": { "put": { - "description": "long polling base url\n", + "description": "long polling base url", "tags": [ "Site Settings Developer" ], @@ -18758,7 +18568,7 @@ "long_polling_base_url": { "type": "string", "example": "/", - "description": "\"Base URL used for long polling (when a CDN is serving dynamic content, be sure to set this to origin pull) eg: http://origin.site.com\"\n" + "description": "\"Base URL used for long polling (when a CDN is serving dynamic content, be sure to set this to origin pull) eg: http://origin.site.com\"" } } } @@ -18767,14 +18577,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/background_polling_interval": { "put": { - "description": "background polling interval\n", + "description": "background polling interval", "tags": [ "Site Settings Developer" ], @@ -18790,7 +18600,7 @@ "background_polling_interval": { "type": "integer", "example": 60000, - "description": "\"How often should the clients poll in milliseconds (when the window is in the background)\"\n" + "description": "\"How often should the clients poll in milliseconds (when the window is in the background)\"" } } } @@ -18799,14 +18609,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/polling_interval": { "put": { - "description": "polling interval\n", + "description": "polling interval", "tags": [ "Site Settings Developer" ], @@ -18822,7 +18632,7 @@ "polling_interval": { "type": "integer", "example": 3000, - "description": "\"When not long polling, how often should logged on clients poll in milliseconds\"\n" + "description": "\"When not long polling, how often should logged on clients poll in milliseconds\"" } } } @@ -18831,14 +18641,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/anon_polling_interval": { "put": { - "description": "anon polling interval\n", + "description": "anon polling interval", "tags": [ "Site Settings Developer" ], @@ -18854,7 +18664,7 @@ "anon_polling_interval": { "type": "integer", "example": 15000, - "description": "\"How often should anonymous clients poll in milliseconds\"\n" + "description": "\"How often should anonymous clients poll in milliseconds\"" } } } @@ -18863,14 +18673,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/flush_timings_secs": { "put": { - "description": "flush timings secs\n", + "description": "flush timings secs", "tags": [ "Site Settings Developer" ], @@ -18886,7 +18696,7 @@ "flush_timings_secs": { "type": "integer", "example": 20, - "description": "\"How frequently we flush timing data to the server, in seconds.\"\n" + "description": "\"How frequently we flush timing data to the server, in seconds.\"" } } } @@ -18895,14 +18705,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/active_user_rate_limit_secs": { "put": { - "description": "active user rate limit secs\n", + "description": "active user rate limit secs", "tags": [ "Site Settings Developer" ], @@ -18918,7 +18728,7 @@ "active_user_rate_limit_secs": { "type": "integer", "example": 60, - "description": "\"How frequently we update the 'last_seen_at' field, in seconds\"\n" + "description": "\"How frequently we update the 'last_seen_at' field, in seconds\"" } } } @@ -18927,14 +18737,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/verbose_localization": { "put": { - "description": "verbose localization\n", + "description": "verbose localization", "tags": [ "Site Settings Developer" ], @@ -18950,7 +18760,7 @@ "verbose_localization": { "type": "boolean", "example": false, - "description": "\"Show extended localization tips in the UI\"\n" + "description": "\"Show extended localization tips in the UI\"" } } } @@ -18959,14 +18769,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/top_topics_formula_log_views_multiplier": { "put": { - "description": "top topics formula log views multiplier\n", + "description": "top topics formula log views multiplier", "tags": [ "Site Settings Developer" ], @@ -18982,7 +18792,7 @@ "top_topics_formula_log_views_multiplier": { "type": "number", "example": 2, - "description": "\"value of log views multiplier (n) in top topics formula: `log(views_count) * (n) + op_likes_count * 0.5 + LEAST(likes_count / posts_count, 3) + 10 + log(posts_count)`\"\n" + "description": "\"value of log views multiplier (n) in top topics formula: `log(views_count) * (n) + op_likes_count * 0.5 + LEAST(likes_count / posts_count, 3) + 10 + log(posts_count)`\"" } } } @@ -18991,14 +18801,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/top_topics_formula_first_post_likes_multiplier": { "put": { - "description": "top topics formula first post likes multiplier\n", + "description": "top topics formula first post likes multiplier", "tags": [ "Site Settings Developer" ], @@ -19014,7 +18824,7 @@ "top_topics_formula_first_post_likes_multiplier": { "type": "number", "example": 0.5, - "description": "\"value of first post likes multiplier (n) in top topics formula: `log(views_count) * 2 + op_likes_count * (n) + LEAST(likes_count / posts_count, 3) + 10 + log(posts_count)`\"\n" + "description": "\"value of first post likes multiplier (n) in top topics formula: `log(views_count) * 2 + op_likes_count * (n) + LEAST(likes_count / posts_count, 3) + 10 + log(posts_count)`\"" } } } @@ -19023,14 +18833,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/top_topics_formula_least_likes_per_post_multiplier": { "put": { - "description": "top topics formula least likes per post multiplier\n", + "description": "top topics formula least likes per post multiplier", "tags": [ "Site Settings Developer" ], @@ -19046,7 +18856,7 @@ "top_topics_formula_least_likes_per_post_multiplier": { "type": "number", "example": 3, - "description": "\"value of least likes per post multiplier (n) in top topics formula: `log(views_count) * 2 + op_likes_count * 0.5 + LEAST(likes_count / posts_count, (n)) + 10 + log(posts_count)`\"\n" + "description": "\"value of least likes per post multiplier (n) in top topics formula: `log(views_count) * 2 + op_likes_count * 0.5 + LEAST(likes_count / posts_count, (n)) + 10 + log(posts_count)`\"" } } } @@ -19055,14 +18865,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/rebake_old_posts_count": { "put": { - "description": "rebake old posts count\n", + "description": "rebake old posts count", "tags": [ "Site Settings Developer" ], @@ -19078,7 +18888,7 @@ "rebake_old_posts_count": { "type": "integer", "example": 250, - "description": "\"Number of old posts to be rebaked every 15 minutes.\"\n" + "description": "\"Number of old posts to be rebaked every 15 minutes.\"" } } } @@ -19087,14 +18897,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tos_url": { "put": { - "description": "tos url\n", + "description": "tos url", "tags": [ "Site Settings Legal" ], @@ -19110,7 +18920,7 @@ "tos_url": { "type": "string", "example": "", - "description": "\"If you have a Terms of Service document hosted elsewhere that you want to use, provide the full URL here.\"\n" + "description": "\"If you have a Terms of Service document hosted elsewhere that you want to use, provide the full URL here.\"" } } } @@ -19119,14 +18929,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/privacy_policy_url": { "put": { - "description": "privacy policy url\n", + "description": "privacy policy url", "tags": [ "Site Settings Legal" ], @@ -19142,7 +18952,7 @@ "privacy_policy_url": { "type": "string", "example": "", - "description": "\"If you have a Privacy Policy document hosted elsewhere that you want to use, provide the full URL here.\"\n" + "description": "\"If you have a Privacy Policy document hosted elsewhere that you want to use, provide the full URL here.\"" } } } @@ -19151,14 +18961,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/fag_url": { "put": { - "description": "faq url\n", + "description": "faq url", "tags": [ "Site Settings Legal" ], @@ -19174,7 +18984,7 @@ "faq_url": { "type": "string", "example": "", - "description": "\"If you have a FAQ hosted elsewhere that you want to use, provide the full URL here.\"\n" + "description": "\"If you have a FAQ hosted elsewhere that you want to use, provide the full URL here.\"" } } } @@ -19183,14 +18993,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/readonly_mode_during_backup": { "put": { - "description": "readonly_mode_during_backup\n", + "description": "readonly_mode_during_backup", "tags": [ "Site Settings Backups" ], @@ -19206,7 +19016,7 @@ "readonly_mode_during_backup": { "type": "boolean", "example": true, - "description": "\"Enable read only mode while taking a backup\"\n" + "description": "\"Enable read only mode while taking a backup\"" } } } @@ -19215,14 +19025,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_restore": { "put": { - "description": "allow_restore\n", + "description": "allow_restore", "tags": [ "Site Settings Backups" ], @@ -19238,7 +19048,7 @@ "allow_restore": { "type": "boolean", "example": false, - "description": "\"Allow restore, which can replace ALL site data! Leave false unless you plan to restore a backup\"\n" + "description": "\"Allow restore, which can replace ALL site data! Leave false unless you plan to restore a backup\"" } } } @@ -19247,14 +19057,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/maximum_backups": { "put": { - "description": "maximum backups\n", + "description": "maximum backups", "tags": [ "Site Settings Backups" ], @@ -19270,7 +19080,7 @@ "maximum_backups": { "type": "integer", "example": 5, - "description": "\"The maximum amount of backups to keep on disk. Older backups are automatically deleted\"\n" + "description": "\"The maximum amount of backups to keep on disk. Older backups are automatically deleted\"" } } } @@ -19279,14 +19089,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/automatic_backups_enabled": { "put": { - "description": "automatic backups enabled\n", + "description": "automatic backups enabled", "tags": [ "Site Settings Backups" ], @@ -19302,7 +19112,7 @@ "automatic_backups_enabled": { "type": "boolean", "example": true, - "description": "\"Run automatic backups as defined in backup frequency\"\n" + "description": "\"Run automatic backups as defined in backup frequency\"" } } } @@ -19311,14 +19121,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/backup_frequency": { "put": { - "description": "backup frequency\n", + "description": "backup frequency", "tags": [ "Site Settings Backups" ], @@ -19334,7 +19144,7 @@ "backup_frequency": { "type": "integer", "example": 7, - "description": "\"How frequently we create a site backup, in days.\"\n" + "description": "\"How frequently we create a site backup, in days.\"" } } } @@ -19343,14 +19153,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/enable_s3_backups": { "put": { - "description": "enable s3 backups\n", + "description": "enable s3 backups", "tags": [ "Site Settings Backups" ], @@ -19366,7 +19176,7 @@ "enable_s3_backups": { "type": "boolean", "example": false, - "description": "\"Upload backups to S3 when complete. IMPORTANT: requires valid S3 credentials entered in Files settings.\"\n" + "description": "\"Upload backups to S3 when complete. IMPORTANT: requires valid S3 credentials entered in Files settings.\"" } } } @@ -19375,14 +19185,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_backup_bucket": { "put": { - "description": "s3 backup bucket\n", + "description": "s3 backup bucket", "tags": [ "Site Settings Backups" ], @@ -19398,7 +19208,7 @@ "s3_backup_bucket": { "type": "string", "example": "", - "description": "\"The remote bucket to hold backups. WARNING: Make sure it is a private bucket.\"\n" + "description": "\"The remote bucket to hold backups. WARNING: Make sure it is a private bucket.\"" } } } @@ -19407,14 +19217,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/s3_disable_cleanup": { "put": { - "description": "s3 disable cleanup\n", + "description": "s3 disable cleanup", "tags": [ "Site Settings Backups" ], @@ -19430,7 +19240,7 @@ "s3_disable_cleanup": { "type": "boolean", "example": false, - "description": "\"Disable the removal of backups from S3 when removed locally.\"\n" + "description": "\"Disable the removal of backups from S3 when removed locally.\"" } } } @@ -19439,14 +19249,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/backup_time_of_day": { "put": { - "description": "backup time of day\n", + "description": "backup time of day", "tags": [ "Site Settings Backups" ], @@ -19462,7 +19272,7 @@ "backup_time_of_day": { "type": "string", "example": "3:30", - "description": "\"Time of day UTC when the backup should occur.\"\n" + "description": "\"Time of day UTC when the backup should occur.\"" } } } @@ -19471,14 +19281,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/backup_with_uploads": { "put": { - "description": "backup with uploads\n", + "description": "backup with uploads", "tags": [ "Site Settings Backups" ], @@ -19494,7 +19304,7 @@ "backup_with_uploads": { "type": "boolean", "example": true, - "description": "\"Include uploads in scheduled backups. Disabling this will only backup the database.\"\n" + "description": "\"Include uploads in scheduled backups. Disabling this will only backup the database.\"" } } } @@ -19503,14 +19313,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_search_term_length": { "put": { - "description": "min search term length\n", + "description": "min search term length", "tags": [ "Site Settings Search" ], @@ -19526,7 +19336,7 @@ "min_search_term_length": { "type": "integer", "example": 3, - "description": "\"Minimum valid search term length in characters\"\n" + "description": "\"Minimum valid search term length in characters\"" } } } @@ -19535,14 +19345,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/search_tokenize_chinese_japanese_korean": { "put": { - "description": "search tokenize chinese japanese korean\n", + "description": "search tokenize chinese japanese korean", "tags": [ "Site Settings Search" ], @@ -19558,7 +19368,7 @@ "search_tokenize_chinese_japanese_korean": { "type": "boolean", "example": false, - "description": "\"Force search to tokenize Chinese/Japanese/Korean even on non CJK sites\"\n" + "description": "\"Force search to tokenize Chinese/Japanese/Korean even on non CJK sites\"" } } } @@ -19567,14 +19377,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/search_prefer_recent_posts": { "put": { - "description": "search prefer recent posts\n", + "description": "search prefer recent posts", "tags": [ "Site Settings Search" ], @@ -19590,7 +19400,7 @@ "search_prefer_recent_posts": { "type": "boolean", "example": false, - "description": "\"If searching your large forum is slow, this option tries an index of more recent posts first\"\n" + "description": "\"If searching your large forum is slow, this option tries an index of more recent posts first\"" } } } @@ -19599,14 +19409,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/search_recent_posts_size": { "put": { - "description": "search recent posts size\n", + "description": "search recent posts size", "tags": [ "Site Settings Search" ], @@ -19622,7 +19432,7 @@ "search_recent_posts_size": { "type": "integer", "example": 100000, - "description": "\"How many recent posts to keep in the index\"\n" + "description": "\"How many recent posts to keep in the index\"" } } } @@ -19631,14 +19441,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/version_checks": { "put": { - "description": "version checks\n", + "description": "version checks", "tags": [ "Site Settings Other" ], @@ -19654,7 +19464,7 @@ "version_checks": { "type": "boolean", "example": true, - "description": "\"Ping the Discourse Hub for version updates and show new version messages on the /admin dashboard\"\n" + "description": "\"Ping the Discourse Hub for version updates and show new version messages on the /admin dashboard\"" } } } @@ -19663,14 +19473,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/new_version_emails": { "put": { - "description": "new version emails\n", + "description": "new version emails", "tags": [ "Site Settings Other" ], @@ -19686,7 +19496,7 @@ "new_version_emails": { "type": "boolean", "example": true, - "description": "\"Send an email to the contact_email address when a new version of Discourse is available.\"\n" + "description": "\"Send an email to the contact_email address when a new version of Discourse is available.\"" } } } @@ -19695,14 +19505,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/send_welcome_message": { "put": { - "description": "send welcome message\n", + "description": "send welcome message", "tags": [ "Site Settings Other" ], @@ -19718,7 +19528,7 @@ "send_welcome_message": { "type": "boolean", "example": true, - "description": "\"Send all new users a welcome message with a quick start guide.\"\n" + "description": "\"Send all new users a welcome message with a quick start guide.\"" } } } @@ -19727,14 +19537,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suppress_uncategorized_badge": { "put": { - "description": "suppress uncategorized badge\n", + "description": "suppress uncategorized badge", "tags": [ "Site Settings Other" ], @@ -19750,7 +19560,7 @@ "suppress_uncategorized_badge": { "type": "boolean", "example": true, - "description": "\"Don't show the badge for uncategorized topics in topic lists.\"\n" + "description": "\"Don't show the badge for uncategorized topics in topic lists.\"" } } } @@ -19759,14 +19569,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/slug_generation_method": { "put": { - "description": "slug generation method\n", + "description": "slug generation method", "tags": [ "Site Settings Other" ], @@ -19787,7 +19597,7 @@ "none" ], "example": "ascii", - "description": "\"Choose a slug generation method. 'encoded' will generate percent encoding string. 'none' will disable slug at all.\"\n" + "description": "\"Choose a slug generation method. 'encoded' will generate percent encoding string. 'none' will disable slug at all.\"" } } } @@ -19796,14 +19606,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/permalink_normalizations": { "put": { - "description": "permalink normalizations\n", + "description": "permalink normalizations", "tags": [ "Site Settings Other" ], @@ -19819,7 +19629,7 @@ "permalink_normalizations": { "type": "string", "example": "", - "description": "\"Apply the following regex before matching permalinks, for example: /(topic.*)\\?.*/\\1 will strip query strings from topic routes. Format is regex+string use \\1 etc. to access captures\"\n" + "description": "\"Apply the following regex before matching permalinks, for example: /(topic.*)\\?.*/\\1 will strip query strings from topic routes. Format is regex+string use \\1 etc. to access captures\"" } } } @@ -19828,14 +19638,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_similar_results": { "put": { - "description": "max similar results\n", + "description": "max similar results", "tags": [ "Site Settings Other" ], @@ -19851,7 +19661,7 @@ "max_similar_results": { "type": "integer", "example": 5, - "description": "\"How many similar topics to show above the editor when composing a new topic. Comparison is based on title and body.\"\n" + "description": "\"How many similar topics to show above the editor when composing a new topic. Comparison is based on title and body.\"" } } } @@ -19860,14 +19670,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/minimum_topics_similar": { "put": { - "description": "minimum topics similar\n", + "description": "minimum topics similar", "tags": [ "Site Settings Other" ], @@ -19883,7 +19693,7 @@ "minimum_topics_similar": { "type": "integer", "example": 50, - "description": "\"How many topics need to exist before similar topics are presented when composing new topics.\"\n" + "description": "\"How many topics need to exist before similar topics are presented when composing new topics.\"" } } } @@ -19892,14 +19702,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/previous_visit_timeout_hours": { "put": { - "description": "previous visit timeout hours\n", + "description": "previous visit timeout hours", "tags": [ "Site Settings Other" ], @@ -19915,7 +19725,7 @@ "previous_visit_timeout_hours": { "type": "integer", "example": 1, - "description": "\"How long a visit lasts before we consider it the 'previous' visit, in hours\"\n" + "description": "\"How long a visit lasts before we consider it the 'previous' visit, in hours\"" } } } @@ -19924,14 +19734,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/staff_like_weight": { "put": { - "description": "staff like weight\n", + "description": "staff like weight", "tags": [ "Site Settings Other" ], @@ -19947,7 +19757,7 @@ "staff_like_weight": { "type": "integer", "example": 3, - "description": "\"How much extra weighting factor to give staff likes.\"\n" + "description": "\"How much extra weighting factor to give staff likes.\"" } } } @@ -19956,14 +19766,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_view_duration_hours": { "put": { - "description": "topic view duration hours\n", + "description": "topic view duration hours", "tags": [ "Site Settings Other" ], @@ -19979,7 +19789,7 @@ "topic_view_duration_hours": { "type": "integer", "example": 8, - "description": "\"Count a new topic view once per IP/User every N hours\"\n" + "description": "\"Count a new topic view once per IP/User every N hours\"" } } } @@ -19988,14 +19798,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/user_profile_view_duration_hours": { "put": { - "description": "user profile view duration hours\n", + "description": "user profile view duration hours", "tags": [ "Site Settings Other" ], @@ -20011,7 +19821,7 @@ "user_profile_view_duration_hours": { "type": "integer", "example": 8, - "description": "\"Count a new user profile view once per IP/User every N hours\"\n" + "description": "\"Count a new user profile view once per IP/User every N hours\"" } } } @@ -20020,14 +19830,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/summary_score_threshold": { "put": { - "description": "summary score threshold\n", + "description": "summary score threshold", "tags": [ "Site Settings Other" ], @@ -20043,7 +19853,7 @@ "summary_score_threshold": { "type": "integer", "example": 15, - "description": "\"The minimum score required for a post to be included in 'Summarize This Topic'\"\n" + "description": "\"The minimum score required for a post to be included in 'Summarize This Topic'\"" } } } @@ -20052,14 +19862,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/summary_posts_required": { "put": { - "description": "summary posts required\n", + "description": "summary posts required", "tags": [ "Site Settings Other" ], @@ -20075,7 +19885,7 @@ "summary_posts_required": { "type": "integer", "example": 50, - "description": "\"Minimum posts in a topic before 'Summarize This Topic' is enabled\"\n" + "description": "\"Minimum posts in a topic before 'Summarize This Topic' is enabled\"" } } } @@ -20084,14 +19894,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/summary_likes_required": { "put": { - "description": "summary likes required\n", + "description": "summary likes required", "tags": [ "Site Settings Other" ], @@ -20107,7 +19917,7 @@ "summary_likes_required": { "type": "integer", "example": 1, - "description": "\"Minimum likes in a topic before 'Summarize This Topic' is enabled\"\n" + "description": "\"Minimum likes in a topic before 'Summarize This Topic' is enabled\"" } } } @@ -20116,14 +19926,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/summary_percent_filter": { "put": { - "description": "summary percent filter\n", + "description": "summary percent filter", "tags": [ "Site Settings Other" ], @@ -20139,7 +19949,7 @@ "summary_percent_filter": { "type": "integer", "example": 20, - "description": "\"When a user clicks 'Summarize This Topic', show the top % of posts\"\n" + "description": "\"When a user clicks 'Summarize This Topic', show the top % of posts\"" } } } @@ -20148,14 +19958,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/summary_max_results": { "put": { - "description": "summary max results\n", + "description": "summary max results", "tags": [ "Site Settings Other" ], @@ -20171,7 +19981,7 @@ "summary_max_results": { "type": "integer", "example": 100, - "description": "\"Maximum posts returned by 'Summary This Topic'\"\n" + "description": "\"Maximum posts returned by 'Summary This Topic'\"" } } } @@ -20180,14 +19990,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_views_heat_low": { "put": { - "description": "topic views heat low\n", + "description": "topic views heat low", "tags": [ "Site Settings Other" ], @@ -20203,7 +20013,7 @@ "topic_view_heat_low": { "type": "integer", "example": 1000, - "description": "\"After this many views, the views field is slightly highlighted.\"\n" + "description": "\"After this many views, the views field is slightly highlighted.\"" } } } @@ -20212,14 +20022,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_views_heat_medium": { "put": { - "description": "topic views heat medium\n", + "description": "topic views heat medium", "tags": [ "Site Settings Other" ], @@ -20235,7 +20045,7 @@ "topic_views_heat_medium": { "type": "integer", "example": 2000, - "description": "\"After this many views, the views field is moderately highlighted.\"\n" + "description": "\"After this many views, the views field is moderately highlighted.\"" } } } @@ -20244,14 +20054,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_views_heat_high": { "put": { - "description": "topic views heat high\n", + "description": "topic views heat high", "tags": [ "Site Settings Other" ], @@ -20267,7 +20077,7 @@ "topic_views_heat_high": { "type": "integer", "example": 5000, - "description": "\"After this many views, the views field is strongly highlighted.\"\n" + "description": "\"After this many views, the views field is strongly highlighted.\"" } } } @@ -20276,14 +20086,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_post_like_heat_low": { "put": { - "description": "topic post like heat low\n", + "description": "topic post like heat low", "tags": [ "Site Settings Other" ], @@ -20299,7 +20109,7 @@ "topic_post_like_heat_low": { "type": "number", "example": 0.5, - "description": "\"After the likes:post ratio exceeds this ratio, the post count field is slightly highlighted.\"\n" + "description": "\"After the likes:post ratio exceeds this ratio, the post count field is slightly highlighted.\"" } } } @@ -20308,14 +20118,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_post_like_heat_medium": { "put": { - "description": "topic post like heat medium\n", + "description": "topic post like heat medium", "tags": [ "Site Settings Other" ], @@ -20331,7 +20141,7 @@ "topic_post_like_heat_medium": { "type": "number", "example": 1, - "description": "\"After the likes:post ratio exceeds this ratio, the post count field is moderately highlighted.\"\n" + "description": "\"After the likes:post ratio exceeds this ratio, the post count field is moderately highlighted.\"" } } } @@ -20340,14 +20150,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_post_like_heat_high": { "put": { - "description": "topic post like heat high\n", + "description": "topic post like heat high", "tags": [ "Site Settings Other" ], @@ -20363,7 +20173,7 @@ "topic_post_like_heat_high": { "type": "number", "example": 2, - "description": "\"After the likes:post ratio exceeds this ratio, the post count field is strongly highlighted.\"\n" + "description": "\"After the likes:post ratio exceeds this ratio, the post count field is strongly highlighted.\"" } } } @@ -20372,14 +20182,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/history_hours_low": { "put": { - "description": "history hours low\n", + "description": "history hours low", "tags": [ "Site Settings Other" ], @@ -20395,7 +20205,7 @@ "history_hours_low": { "type": "integer", "example": 12, - "description": "\"A post edited within this many hours has the edit indicator slightly highlighted\"\n" + "description": "\"A post edited within this many hours has the edit indicator slightly highlighted\"" } } } @@ -20404,14 +20214,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/history_hours_medium": { "put": { - "description": "history hours medium\n", + "description": "history hours medium", "tags": [ "Site Settings Other" ], @@ -20427,7 +20237,7 @@ "history_hours_medium": { "type": "integer", "example": 24, - "description": "\"A post edited within this many hours has the edit indicator moderately highlighted.\"\n" + "description": "\"A post edited within this many hours has the edit indicator moderately highlighted.\"" } } } @@ -20436,14 +20246,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/history_hours_high": { "put": { - "description": "history hours high\n", + "description": "history hours high", "tags": [ "Site Settings Other" ], @@ -20459,7 +20269,7 @@ "history_hours_high": { "type": "integer", "example": 48, - "description": "\"A post edited within this many hours has the edit indicator strongly highlighted.\"\n" + "description": "\"A post edited within this many hours has the edit indicator strongly highlighted.\"" } } } @@ -20468,14 +20278,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/cold_age_days_low": { "put": { - "description": "cold age days low\n", + "description": "cold age days low", "tags": [ "Site Settings Other" ], @@ -20491,7 +20301,7 @@ "cold_age_days_low": { "type": "integer", "example": 14, - "description": "\"After this many days of conversation, the last activity date is slightly dimmed.\"\n" + "description": "\"After this many days of conversation, the last activity date is slightly dimmed.\"" } } } @@ -20500,14 +20310,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/cold_age_days_medium": { "put": { - "description": "cold age days medium\n", + "description": "cold age days medium", "tags": [ "Site Settings Other" ], @@ -20523,7 +20333,7 @@ "cold_age_days_medium": { "type": "integer", "example": 90, - "description": "\"After this many days of conversation, the last activity date is moderately dimmed.\"\n" + "description": "\"After this many days of conversation, the last activity date is moderately dimmed.\"" } } } @@ -20532,14 +20342,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/cold_age_days_high": { "put": { - "description": "cold age days high\n", + "description": "cold age days high", "tags": [ "Site Settings Other" ], @@ -20555,7 +20365,7 @@ "cold_age_days_high": { "type": "integer", "example": 180, - "description": "\"After this many days of conversation, the last activity date is strongly dimmed.\"\n" + "description": "\"After this many days of conversation, the last activity date is strongly dimmed.\"" } } } @@ -20564,14 +20374,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/educate_until_posts": { "put": { - "description": "educate until posts\n", + "description": "educate until posts", "tags": [ "Site Settings Other" ], @@ -20587,7 +20397,7 @@ "educate_until_posts": { "type": "integer", "example": 2, - "description": "\"When the user starts typing their first (n) new posts, show the pop-up new user education panel in the composer.\"\n" + "description": "\"When the user starts typing their first (n) new posts, show the pop-up new user education panel in the composer.\"" } } } @@ -20596,14 +20406,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/sequential_replies_threshold": { "put": { - "description": "sequential replies threshold\n", + "description": "sequential replies threshold", "tags": [ "Site Settings Other" ], @@ -20619,7 +20429,7 @@ "sequential_replies_threshold": { "type": "integer", "example": 2, - "description": "\"Number of posts a user has to make in a row in a topic before being reminded about too many sequential replies.\"\n" + "description": "\"Number of posts a user has to make in a row in a topic before being reminded about too many sequential replies.\"" } } } @@ -20628,14 +20438,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/dominating_topic_minimum_percent": { "put": { - "description": "dominating topic minimum percent\n", + "description": "dominating topic minimum percent", "tags": [ "Site Settings Other" ], @@ -20651,7 +20461,7 @@ "dominating_topic_minimum_percent": { "type": "integer", "example": 20, - "description": "\"What percentage of posts a user has to make in a topic before being reminded about overly dominating a topic.\"\n" + "description": "\"What percentage of posts a user has to make in a topic before being reminded about overly dominating a topic.\"" } } } @@ -20660,14 +20470,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_avatar_education_message": { "put": { - "description": "disable avatar education message\n", + "description": "disable avatar education message", "tags": [ "Site Settings Other" ], @@ -20683,7 +20493,7 @@ "disable_avatar_education_message": { "type": "boolean", "example": false, - "description": "\"Disable education message for changing avatar.\"\n" + "description": "\"Disable education message for changing avatar.\"" } } } @@ -20692,14 +20502,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/global_notice": { "put": { - "description": "global notice\n", + "description": "global notice", "tags": [ "Site Settings Other" ], @@ -20715,7 +20525,7 @@ "global_notice": { "type": "string", "example": "", - "description": "\"Display an URGENT, EMERGENCY global banner notice to all visitors, change to blank to hide it (HTML allowed).\"\n" + "description": "\"Display an URGENT, EMERGENCY global banner notice to all visitors, change to blank to hide it (HTML allowed).\"" } } } @@ -20724,14 +20534,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/notify_about_flags_after": { "put": { - "description": "notify about flags after\n", + "description": "notify about flags after", "tags": [ "Site Settings Other" ], @@ -20747,7 +20557,7 @@ "notify_about_flags_after": { "type": "integer", "example": 48, - "description": "\"If there are flags that haven't been handled after this many hours, send an email to the contact_email. Set to 0 to disable.\"\n" + "description": "\"If there are flags that haven't been handled after this many hours, send an email to the contact_email. Set to 0 to disable.\"" } } } @@ -20756,14 +20566,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_create_topics_notice": { "put": { - "description": "show create topics notice\n", + "description": "show create topics notice", "tags": [ "Site Settings Other" ], @@ -20779,7 +20589,7 @@ "show_create_topics_notice": { "type": "boolean", "example": true, - "description": "\"If the site has fewer than 5 public topics, show a notice asking admins to create some topics.\"\n" + "description": "\"If the site has fewer than 5 public topics, show a notice asking admins to create some topics.\"" } } } @@ -20788,14 +20598,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_edit_notifications": { "put": { - "description": "disable edit notifications\n", + "description": "disable edit notifications", "tags": [ "Site Settings Other" ], @@ -20811,7 +20621,7 @@ "disable_edit_notifications": { "type": "boolean", "example": false, - "description": "\"Disables edit notifications by the system user when 'download_remote_images_to_local' is active.\"\n" + "description": "\"Disables edit notifications by the system user when 'download_remote_images_to_local' is active.\"" } } } @@ -20820,14 +20630,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/vacuum_db_days": { "put": { - "description": "vacuum db days\n", + "description": "vacuum db days", "tags": [ "Site Settings Other" ], @@ -20843,7 +20653,7 @@ "vacuum_db_days": { "type": "integer", "example": 90, - "description": "\"Run VACUUM ANALYZE to reclaim DB space after migrations (set to 0 to disable)\"\n" + "description": "\"Run VACUUM ANALYZE to reclaim DB space after migrations (set to 0 to disable)\"" } } } @@ -20852,14 +20662,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/delete_drafts_older_than_n_days": { "put": { - "description": "delete drafts older than n days\n", + "description": "delete drafts older than n days", "tags": [ "Site Settings Other" ], @@ -20875,7 +20685,7 @@ "delete_drafts_older_than_n_days": { "type": "integer", "example": 180, - "description": "\"Delete drafts older than (n) days.\"\n" + "description": "\"Delete drafts older than (n) days.\"" } } } @@ -20884,14 +20694,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/bootstrap_mode_min_users": { "put": { - "description": "bootstrap mode min users\n", + "description": "bootstrap mode min users", "tags": [ "Site Settings Other" ], @@ -20907,7 +20717,7 @@ "bootstrap_mode_min_users": { "type": "integer", "example": 50, - "description": "\"Minimum number of users required to disable bootstrap mode (set to 0 to disable)\"\n" + "description": "\"Minimum number of users required to disable bootstrap mode (set to 0 to disable)\"" } } } @@ -20916,14 +20726,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/automatically_unpin_topics": { "put": { - "description": "automatically unpin topics\n", + "description": "automatically unpin topics", "tags": [ "Site Settings Other" ], @@ -20939,7 +20749,7 @@ "automatically_unpin_topics": { "type": "boolean", "example": true, - "description": "\"Automatically unpin topics when the user reaches the bottom.\"\n" + "description": "\"Automatically unpin topics when the user reaches the bottom.\"" } } } @@ -20948,14 +20758,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/read_time_word_count": { "put": { - "description": "read time word count\n", + "description": "read time word count", "tags": [ "Site Settings Other" ], @@ -20971,7 +20781,7 @@ "read_time_word_count": { "type": "integer", "example": 500, - "description": "\"Word count per minute for calculating estimated reading time.\"\n" + "description": "\"Word count per minute for calculating estimated reading time.\"" } } } @@ -20980,14 +20790,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/topic_page_title_includes_category": { "put": { - "description": "topic page title includes category\n", + "description": "topic page title includes category", "tags": [ "Site Settings Other" ], @@ -21003,7 +20813,7 @@ "topic_page_title_includes_category": { "type": "boolean", "example": true, - "description": "\"Topic page title includes the category name.\"\n" + "description": "\"Topic page title includes the category name.\"" } } } @@ -21012,14 +20822,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/native_app_install_banner": { "put": { - "description": "\"native app install banner\"\n", + "description": "\"native app install banner\"", "tags": [ "Site Settings Other" ], @@ -21035,7 +20845,7 @@ "native_app_install_banner": { "type": "boolean", "example": false, - "description": "\"Asks recurring visitors to install Discourse native app.\"\n" + "description": "\"Asks recurring visitors to install Discourse native app.\"" } } } @@ -21044,14 +20854,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_digest_frequency": { "put": { - "description": "\"default email digest frequency\"\n", + "description": "\"default email digest frequency\"", "tags": [ "Site Settings User Preferences" ], @@ -21067,7 +20877,7 @@ "default_email_digest_frequency": { "type": "integer", "example": 0, - "description": "\"How often users receive summary emails by default.\"\n" + "description": "\"How often users receive summary emails by default.\"" } } } @@ -21076,14 +20886,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_include_tl0_in_digests": { "put": { - "description": "\"default include tl0 in digests\"\n", + "description": "\"default include tl0 in digests\"", "tags": [ "Site Settings User Preferences" ], @@ -21099,7 +20909,7 @@ "default_include_tl0_in_digests": { "type": "boolean", "example": false, - "description": "\"Include posts from new users in summary emails by default. Users can change this in their preferences.\"\n" + "description": "\"Include posts from new users in summary emails by default. Users can change this in their preferences.\"" } } } @@ -21108,14 +20918,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_private_messages": { "put": { - "description": "\"default email private messages\"\n", + "description": "\"default email private messages\"", "tags": [ "Site Settings User Preferences" ], @@ -21131,7 +20941,7 @@ "default_email_private_messages": { "type": "boolean", "example": true, - "description": "\"Send an email when someone messages the user by default.\"\n" + "description": "\"Send an email when someone messages the user by default.\"" } } } @@ -21140,14 +20950,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_direct": { "put": { - "description": "\"default email direct\"\n", + "description": "\"default email direct\"", "tags": [ "Site Settings User Preferences" ], @@ -21163,7 +20973,7 @@ "default_email_direct": { "type": "boolean", "example": true, - "description": "\"Send an email when someone quotes/replies to/mentions or invites the user by default.\"\n" + "description": "\"Send an email when someone quotes/replies to/mentions or invites the user by default.\"" } } } @@ -21172,14 +20982,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_mailing_list_mode": { "put": { - "description": "\"default email mailing list mode\"\n", + "description": "\"default email mailing list mode\"", "tags": [ "Site Settings User Preferences" ], @@ -21195,7 +21005,7 @@ "default_email_mailing_list_mode": { "type": "boolean", "example": false, - "description": "\"Send an email for every new post by default.\"\n" + "description": "\"Send an email for every new post by default.\"" } } } @@ -21204,14 +21014,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_mailing_list_mode_frequency": { "put": { - "description": "\"default email mailing list mode frequency\"\n", + "description": "\"default email mailing list mode frequency\"", "tags": [ "Site Settings User Preferences" ], @@ -21232,7 +21042,7 @@ 2 ], "example": 0, - "description": "\"Users who enable mailing list mode will receive emails this often by default.\"\n" + "description": "\"Users who enable mailing list mode will receive emails this often by default.\"" } } } @@ -21241,14 +21051,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_mailing_list_mode": { "put": { - "description": "\"disable mailing list mode\"\n", + "description": "\"disable mailing list mode\"", "tags": [ "Site Settings User Preferences" ], @@ -21264,7 +21074,7 @@ "disable_mailing_list_mode": { "type": "boolean", "example": false, - "description": "\"Disallow users from enabling mailing list mode.\"\n" + "description": "\"Disallow users from enabling mailing list mode.\"" } } } @@ -21273,14 +21083,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_always": { "put": { - "description": "\"default email always\"\n", + "description": "\"default email always\"", "tags": [ "Site Settings User Preferences" ], @@ -21296,7 +21106,7 @@ "default_email_always": { "type": "boolean", "example": false, - "description": "\"Send an email notification even when the user is active by default.\"\n" + "description": "\"Send an email notification even when the user is active by default.\"" } } } @@ -21305,14 +21115,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_previous_replies": { "put": { - "description": "\"default email previous replies\"\n", + "description": "\"default email previous replies\"", "tags": [ "Site Settings User Preferences" ], @@ -21328,7 +21138,7 @@ "default_email_previous_replies": { "type": "integer", "example": 2, - "description": "\"Include previous replies in emails by default.\"\n" + "description": "\"Include previous replies in emails by default.\"" } } } @@ -21337,14 +21147,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_email_in_reply_to": { "put": { - "description": "\"default email in reply to\"\n", + "description": "\"default email in reply to\"", "tags": [ "Site Settings User Preferences" ], @@ -21360,7 +21170,7 @@ "default_email_in_reply_to": { "type": "boolean", "example": true, - "description": "\"Include excerpt of replied to post in emails by default.\"\n" + "description": "\"Include excerpt of replied to post in emails by default.\"" } } } @@ -21369,14 +21179,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_new_topic_duration_minutes": { "put": { - "description": "\"default other new topic duration minutes\"\n", + "description": "\"default other new topic duration minutes\"", "tags": [ "Site Settings User Preferences" ], @@ -21392,7 +21202,7 @@ "default_other_new_topic_duration_minutes": { "type": "integer", "example": 2880, - "description": "\"Global default condition for which a topic is considered new.\"\n" + "description": "\"Global default condition for which a topic is considered new.\"" } } } @@ -21401,14 +21211,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_auto_track_topic_after_msecs": { "put": { - "description": "\"default other auto track topics after msecs\"\n", + "description": "\"default other auto track topics after msecs\"", "tags": [ "Site Settings User Preferences" ], @@ -21424,7 +21234,7 @@ "default_other_auto_track_topic_after_msecs": { "type": "integer", "example": 240000, - "description": "\"Global default time before a topic is automatically tracked.\"\n" + "description": "\"Global default time before a topic is automatically tracked.\"" } } } @@ -21433,14 +21243,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_notification_level_when_replying": { "put": { - "description": "\"default other notification level when replying\"\n", + "description": "\"default other notification level when replying\"", "tags": [ "Site Settings User Preferences" ], @@ -21456,7 +21266,7 @@ "default_other_notification_level_when_replying": { "type": "integer", "example": 2, - "description": "\"Global default notification level when the user replies to a topic.\"\n" + "description": "\"Global default notification level when the user replies to a topic.\"" } } } @@ -21465,14 +21275,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_external_links_in_new_tab": { "put": { - "description": "\"default other external links in new tab\"\n", + "description": "\"default other external links in new tab\"", "tags": [ "Site Settings User Preferences" ], @@ -21488,7 +21298,7 @@ "default_other_external_links_in_new_tab": { "type": "boolean", "example": false, - "description": "\"Open external links in a new tab by default.\"\n" + "description": "\"Open external links in a new tab by default.\"" } } } @@ -21497,14 +21307,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_enable_quoting": { "put": { - "description": "\"default other enable quoting\"\n", + "description": "\"default other enable quoting\"", "tags": [ "Site Settings User Preferences" ], @@ -21520,7 +21330,7 @@ "default_other_enable_quoting": { "type": "boolean", "example": true, - "description": "\"Enable quote reply for highlighted text by default.\"\n" + "description": "\"Enable quote reply for highlighted text by default.\"" } } } @@ -21529,14 +21339,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_dynamic_favicon": { "put": { - "description": "default other dynamic favicon\n", + "description": "default other dynamic favicon", "tags": [ "Site Settings User Preferences" ], @@ -21552,7 +21362,7 @@ "default_other_dynamic_favicon": { "type": "boolean", "example": false, - "description": "\"Show new/updated topic count on browser icon by default.\"\n" + "description": "\"Show new/updated topic count on browser icon by default.\"" } } } @@ -21561,14 +21371,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_disable_jump_reply": { "put": { - "description": "\"default other disable jump reply\"\n", + "description": "\"default other disable jump reply\"", "tags": [ "Site Settings User Preferences" ], @@ -21584,7 +21394,7 @@ "default_other_disable_jump_reply": { "type": "boolean", "example": false, - "description": "\"Don't jump to user's post after they reply by default.\"\n" + "description": "\"Don't jump to user's post after they reply by default.\"" } } } @@ -21593,14 +21403,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_other_like_notification_frequency": { "put": { - "description": "\"default other like notification frequency\"\n", + "description": "\"default other like notification frequency\"", "tags": [ "Site Settings User Preferences" ], @@ -21616,7 +21426,7 @@ "default_other_like_notification_frequency": { "type": "integer", "example": 1, - "description": "\"Notify users on likes by default\"\n" + "description": "\"Notify users on likes by default\"" } } } @@ -21625,14 +21435,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_topics_automatic_unpin": { "put": { - "description": "\"default topics automatic unpin\"\n", + "description": "\"default topics automatic unpin\"", "tags": [ "Site Settings User Preferences" ], @@ -21648,7 +21458,7 @@ "default_topics_automatic_unpin": { "type": "boolean", "example": true, - "description": "\"Automatically unpin topics when the user reaches the bottom by default.\"\n" + "description": "\"Automatically unpin topics when the user reaches the bottom by default.\"" } } } @@ -21657,14 +21467,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_categories_watching": { "put": { - "description": "\"default categories watching\"\n", + "description": "\"default categories watching\"", "tags": [ "Site Settings User Preferences" ], @@ -21680,7 +21490,7 @@ "default_categories_watching": { "type": "string", "example": "4|1", - "description": "\"Pipe delimited category id's. List of categories that are watched by default.\"\n" + "description": "\"Pipe delimited category id's. List of categories that are watched by default.\"" } } } @@ -21689,14 +21499,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_categories_tracking": { "put": { - "description": "\"default categories tracking\"\n", + "description": "\"default categories tracking\"", "tags": [ "Site Settings User Preferences" ], @@ -21712,7 +21522,7 @@ "default_categories_tracking": { "type": "string", "example": "", - "description": "\"Pipe delimited category id's. List of categories that are tracked by default.\"\n" + "description": "\"Pipe delimited category id's. List of categories that are tracked by default.\"" } } } @@ -21721,14 +21531,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_categories_muted": { "put": { - "description": "\"default categories muted\"\n", + "description": "\"default categories muted\"", "tags": [ "Site Settings User Preferences" ], @@ -21744,7 +21554,7 @@ "default_categories_muted": { "type": "string", "example": "", - "description": "\"Pipe delimited category id's. List of categories that are muted by default.\"\n" + "description": "\"Pipe delimited category id's. List of categories that are muted by default.\"" } } } @@ -21753,14 +21563,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/default_categories_watching_first_post": { "put": { - "description": "\"default categories watching first post\"\n", + "description": "\"default categories watching first post\"", "tags": [ "Site Settings User Preferences" ], @@ -21776,7 +21586,7 @@ "default_categories_watching_first_post": { "type": "string", "example": "", - "description": "\"Pipe delimited category id's. List of categories in which first post in each new topic will be watched by default.\"\n" + "description": "\"Pipe delimited category id's. List of categories in which first post in each new topic will be watched by default.\"" } } } @@ -21785,14 +21595,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_user_api_reqs_per_day": { "put": { - "description": "\"max user api reqs per day\"\n", + "description": "\"max user api reqs per day\"", "tags": [ "Site Settings User API" ], @@ -21808,7 +21618,7 @@ "max_user_api_reqs_per_day": { "type": "integer", "example": 2880, - "description": "\"Maximum number of user API requests per key per day\"\n" + "description": "\"Maximum number of user API requests per key per day\"" } } } @@ -21817,14 +21627,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_user_api_reqs_per_minute": { "put": { - "description": "\"max user api reqs per minute\"\n", + "description": "\"max user api reqs per minute\"", "tags": [ "Site Settings User API" ], @@ -21840,7 +21650,7 @@ "max_user_api_reqs_per_minute": { "type": "integer", "example": 20, - "description": "\"Maximum number of user API requests per key per minute\"\n" + "description": "\"Maximum number of user API requests per key per minute\"" } } } @@ -21849,14 +21659,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_user_api_keys": { "put": { - "description": "\"allow user api keys\"\n", + "description": "\"allow user api keys\"", "tags": [ "Site Settings User API" ], @@ -21872,7 +21682,7 @@ "allow_user_api_keys": { "type": "boolean", "example": true, - "description": "\"Allow generation of user API keys\"\n" + "description": "\"Allow generation of user API keys\"" } } } @@ -21881,14 +21691,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allow_user_api_key_scopes": { "put": { - "description": "\"allow user api key scopes\"\n", + "description": "\"allow user api key scopes\"", "tags": [ "Site Settings User API" ], @@ -21904,7 +21714,7 @@ "allow_user_api_key_scopes": { "type": "string", "example": "read|write|message_bus|push|notifications|session_info", - "description": "\"List of scopes allowed for user API keys\"\n" + "description": "\"List of scopes allowed for user API keys\"" } } } @@ -21913,14 +21723,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_api_keys_per_user": { "put": { - "description": "\"max api keys per user\"\n", + "description": "\"max api keys per user\"", "tags": [ "Site Settings User Preferences" ], @@ -21936,7 +21746,7 @@ "max_api_keys_per_user": { "type": "integer", "example": 10, - "description": "\"Maximum number of user API keys per user\"\n" + "description": "\"Maximum number of user API keys per user\"" } } } @@ -21945,14 +21755,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_level_for_user_api_key": { "put": { - "description": "\"min trust level for user api key\"\n", + "description": "\"min trust level for user api key\"", "tags": [ "Site Settings User API" ], @@ -21968,7 +21778,7 @@ "min_trust_level_for_user_api_key": { "type": "integer", "example": 1, - "description": "\"Trust level required for generation of user API keys\"\n" + "description": "\"Trust level required for generation of user API keys\"" } } } @@ -21977,14 +21787,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allowed_user_api_push_urls": { "put": { - "description": "\"allowed user api push urls\"\n", + "description": "\"allowed user api push urls\"", "tags": [ "Site Settings User API" ], @@ -22000,7 +21810,7 @@ "allowed_user_api_push_urls": { "type": "string", "example": "", - "description": "\"Allowed URLs for server push to user API\"\n" + "description": "\"Allowed URLs for server push to user API\"" } } } @@ -22009,14 +21819,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/allowed_user_api_auth_redirects": { "put": { - "description": "\"allowed user api auth redirects\"\n", + "description": "\"allowed user api auth redirects\"", "tags": [ "Site Settings User API" ], @@ -22032,7 +21842,7 @@ "allowed_user_api_auth_redirects": { "type": "string", "example": "https://api.discourse.org/api/auth_redirect|discourse://auth_redirect", - "description": "\"Allowed URL for authentication redirect for user API keys\"\n" + "description": "\"Allowed URL for authentication redirect for user API keys\"" } } } @@ -22041,14 +21851,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tagging_enabled": { "put": { - "description": "\"tagging enabled\"\n", + "description": "\"tagging enabled\"", "tags": [ "Site Settings Tags" ], @@ -22064,7 +21874,7 @@ "tagging_enabled": { "type": "boolean", "example": false, - "description": "\"Enable tags on topics?\"\n" + "description": "\"Enable tags on topics?\"" } } } @@ -22073,14 +21883,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tag_style": { "put": { - "description": "\"tag style\"\n", + "description": "\"tag style\"", "tags": [ "Site Settings Tags" ], @@ -22101,7 +21911,7 @@ "box" ], "example": "simple", - "description": "\"Visual style for tag badges.\"\n" + "description": "\"Visual style for tag badges.\"" } } } @@ -22110,14 +21920,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_tags_per_topic": { "put": { - "description": "\"max tags per topic\"\n", + "description": "\"max tags per topic\"", "tags": [ "Site Settings Tags" ], @@ -22133,7 +21943,7 @@ "max_tags_per_topic": { "type": "integer", "example": 5, - "description": "\"The maximum tags that can be applied to a topic.\"\n" + "description": "\"The maximum tags that can be applied to a topic.\"" } } } @@ -22142,14 +21952,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_tag_length": { "put": { - "description": "\"max tag length\"\n", + "description": "\"max tag length\"", "tags": [ "Site Settings Tags" ], @@ -22165,7 +21975,7 @@ "max_tag_length": { "type": "integer", "example": 20, - "description": "\"The maximum amount of characters that can be used in a tag.\"\n" + "description": "\"The maximum amount of characters that can be used in a tag.\"" } } } @@ -22174,14 +21984,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_to_create_tag": { "put": { - "description": "\"min trust to create tag\"\n", + "description": "\"min trust to create tag\"", "tags": [ "Site Settings Tags" ], @@ -22204,7 +22014,7 @@ 4 ], "example": 3, - "description": "\"The minimum trust level required to create a tag.\"\n" + "description": "\"The minimum trust level required to create a tag.\"" } } } @@ -22213,14 +22023,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/min_trust_level_to_tag_topics": { "put": { - "description": "\"min trust level to tag topics\"\n", + "description": "\"min trust level to tag topics\"", "tags": [ "Site Settings Tags" ], @@ -22243,7 +22053,7 @@ 4 ], "example": 0, - "description": "\"Minimum trust level required to tag topics\"\n" + "description": "\"Minimum trust level required to tag topics\"" } } } @@ -22252,14 +22062,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_tag_search_results": { "put": { - "description": "\"max_tag_search_results\"\n", + "description": "\"max_tag_search_results\"", "tags": [ "Site Settings Tags" ], @@ -22275,7 +22085,7 @@ "max_tag_search_results": { "type": "integer", "example": 5, - "description": "\"When searching for tags, the maximum number of results to show.\"\n" + "description": "\"When searching for tags, the maximum number of results to show.\"" } } } @@ -22284,14 +22094,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/show_filter_by_tag": { "put": { - "description": "\"show filter by tag\"\n", + "description": "\"show filter by tag\"", "tags": [ "Site Settings Tags" ], @@ -22307,7 +22117,7 @@ "show_filter_by_tag": { "type": "boolean", "example": false, - "description": "\"Show a dropdown to filter a topic list by tag.\"\n" + "description": "\"Show a dropdown to filter a topic list by tag.\"" } } } @@ -22316,14 +22126,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/max_tags_in_filter_list": { "put": { - "description": "\"max tags in filter list\"\n", + "description": "\"max tags in filter list\"", "tags": [ "Site Settings Tags" ], @@ -22339,7 +22149,7 @@ "max_tags_in_filter_list": { "type": "integer", "example": 30, - "description": "\"Maximum number of tags to show in the filter dropdown. The most used tags will be shown.\"\n" + "description": "\"Maximum number of tags to show in the filter dropdown. The most used tags will be shown.\"" } } } @@ -22348,14 +22158,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/tags_sort_alphabetically": { "put": { - "description": "\"tags sort alphabetically\"\n", + "description": "\"tags sort alphabetically\"", "tags": [ "Site Settings Tags" ], @@ -22371,7 +22181,7 @@ "tags_sort_alphabetically": { "type": "boolean", "example": false, - "description": "\"Show tags in alphabetical order. Default is to show in order of popularity.\"\n" + "description": "\"Show tags in alphabetical order. Default is to show in order of popularity.\"" } } } @@ -22380,14 +22190,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/staff_tags": { "put": { - "description": "\"staff tags\"\n", + "description": "\"staff tags\"", "tags": [ "Site Settings Tags" ], @@ -22403,7 +22213,7 @@ "staff_tags": { "type": "string", "example": "", - "description": "\"A list of tags that can only be applied by staff members\"\n" + "description": "\"A list of tags that can only be applied by staff members\"" } } } @@ -22412,14 +22222,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/suppress_overlapping_tags_in_list": { "put": { - "description": "\"suppress overlapping tags in list\"\n", + "description": "\"suppress overlapping tags in list\"", "tags": [ "Site Settings Tags" ], @@ -22435,7 +22245,7 @@ "suppress_overlapping_tags_in_list": { "type": "boolean", "example": false, - "description": "\"If tags match exact words in topic titles, don't show the tag\"\n" + "description": "\"If tags match exact words in topic titles, don't show the tag\"" } } } @@ -22444,14 +22254,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/remove_muted_tags_from_latest": { "put": { - "description": "\"remove muted tags from latest\"\n", + "description": "\"remove muted tags from latest\"", "tags": [ "Site Settings Tags" ], @@ -22467,7 +22277,7 @@ "remove_muted_tags_from_latest": { "type": "boolean", "example": false, - "description": "\"Don't show topics tagged with muted tags in the latest topic list.\"\n" + "description": "\"Don't show topics tagged with muted tags in the latest topic list.\"" } } } @@ -22476,14 +22286,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/details_enabled": { "put": { - "description": "\"details enabled\"\n", + "description": "\"details enabled\"", "tags": [ "Site Settings Plugins" ], @@ -22499,7 +22309,7 @@ "details_enabled": { "type": "boolean", "example": true, - "description": "'Enable the details plugin. If you change this, you must rebake all posts with: \"rake posts:rebake\".'\n" + "description": "'Enable the details plugin. If you change this, you must rebake all posts with: \"rake posts:rebake\".'" } } } @@ -22508,14 +22318,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/daily_performance_report": { "put": { - "description": "\"daily performance report\"\n", + "description": "\"daily performance report\"", "tags": [ "Site Settings Plugins" ], @@ -22531,7 +22341,7 @@ "daily_performance_report": { "type": "boolean", "example": false, - "description": "\"Analyze NGINX logs daily and post a Staff Only topic with details\"\n" + "description": "\"Analyze NGINX logs daily and post a Staff Only topic with details\"" } } } @@ -22540,14 +22350,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/poll_enabled": { "put": { - "description": "\"poll enabled\"\n", + "description": "\"poll enabled\"", "tags": [ "Site Settings Plugins" ], @@ -22563,7 +22373,7 @@ "poll_enabled": { "type": "boolean", "example": true, - "description": "\"Allow users to create polls?\"\n" + "description": "\"Allow users to create polls?\"" } } } @@ -22572,14 +22382,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/poll_maximum_options": { "put": { - "description": "\"poll maximum options\"\n", + "description": "\"poll maximum options\"", "tags": [ "Site Settings Plugins" ], @@ -22595,7 +22405,7 @@ "poll_maximum_options": { "type": "integer", "example": 20, - "description": "\"Maximum number of options allowed in a poll.\"\n" + "description": "\"Maximum number of options allowed in a poll.\"" } } } @@ -22604,14 +22414,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/poll_edit_window_mins": { "put": { - "description": "poll edit window mins\n", + "description": "poll edit window mins", "tags": [ "Site Settings Plugins" ], @@ -22627,7 +22437,7 @@ "poll_edit_window_mins": { "type": "integer", "example": 5, - "description": "Number of minutes after post creation during which polls can be edited.\n" + "description": "Number of minutes after post creation during which polls can be edited." } } } @@ -22636,14 +22446,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/discourse_narrative_bot_enabled": { "put": { - "description": "enable discourse narrative bot\n", + "description": "enable discourse narrative bot", "tags": [ "Site Settings Narrative Bot" ], @@ -22659,7 +22469,7 @@ "discourse_narrative_bot_enabled": { "type": "boolean", "example": true, - "description": "Enable Discourse Narrative Bot\n" + "description": "Enable Discourse Narrative Bot" } } } @@ -22668,14 +22478,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/disable_discourse_narrative_bot_welcome_post": { "put": { - "description": "disable discourse narrative bot welcome post\n", + "description": "disable discourse narrative bot welcome post", "tags": [ "Site Settings Narrative Bot" ], @@ -22691,7 +22501,7 @@ "disable_discourse_narrative_bot_welcome_post": { "type": "boolean", "example": false, - "description": "disable discourse narrative bot welcome post\n" + "description": "disable discourse narrative bot welcome post" } } } @@ -22700,14 +22510,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/discourse_narrative_bot_disable_public_replies": { "put": { - "description": "discourse narrative bot disable public replies\n", + "description": "discourse narrative bot disable public replies", "tags": [ "Site Settings Narrative Bot" ], @@ -22723,7 +22533,7 @@ "discourse_narrative_bot_disable_public_replies": { "type": "boolean", "example": false, - "description": "Disable public replies by Discourse Narrative Bot\n" + "description": "Disable public replies by Discourse Narrative Bot" } } } @@ -22732,14 +22542,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/discourse_narrative_bot_ignored_usernames": { "put": { - "description": "discourse narrative bot ignored usernames\n", + "description": "discourse narrative bot ignored usernames", "tags": [ "Site Settings Narrative Bot" ], @@ -22755,7 +22565,7 @@ "discourse_narrative_bot_ignored_usernames": { "type": "boolean", "example": "discourse|steve", - "description": "Usernames that the Discourse Narrative Bot should ignore. Pipe delimited.\n" + "description": "Usernames that the Discourse Narrative Bot should ignore. Pipe delimited." } } } @@ -22764,14 +22574,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/discourse_narrative_bot_welcome_post_delay": { "put": { - "description": "discourse narrative bot welcome post delay\n", + "description": "discourse narrative bot welcome post delay", "tags": [ "Site Settings Narrative Bot" ], @@ -22787,7 +22597,7 @@ "discourse_narrative_bot_welcome_post_delay": { "type": "integer", "example": 0, - "description": "Wait (n) seconds before sending the Discourse Narrative Bot welcome post.\n" + "description": "Wait (n) seconds before sending the Discourse Narrative Bot welcome post." } } } @@ -22796,14 +22606,14 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/site_settings/discourse_narrative_bot_welcome_post_type": { "put": { - "description": "discourse narrative bot welcome post type\n", + "description": "discourse narrative bot welcome post type", "tags": [ "Site Settings Narrative Bot" ], @@ -22823,7 +22633,7 @@ "new_user_track", "welcome_message" ], - "description": "Type of welcome post that the Discourse Narrative Bot should send out\n" + "description": "Type of welcome post that the Discourse Narrative Bot should send out" } } } @@ -22832,20 +22642,20 @@ }, "responses": { "200": { - "description": "empty response body\n" + "description": "empty response body" } } } }, "/admin/plugins": { "get": { - "description": "get a list of installed plugins\n", + "description": "get a list of installed plugins", "tags": [ "Plugins" ], "responses": { "200": { - "description": "plugin list response\n", + "description": "plugin list response", "content": { "application/json": { "schema": { @@ -22887,13 +22697,13 @@ }, "/admin/backups.json": { "get": { - "description": "get a list of backups\n", + "description": "get a list of backups", "tags": [ "Backups" ], "responses": { "200": { - "description": "\"List of backups response. NOTE: Backups link urls cannot be called directly.\"\n\"Please create a PUT request to download a backup.\"\n", + "description": "\"List of backups response. NOTE: Backups link urls cannot be called directly.\"\n\"Please create a PUT request to download a backup.\"", "content": { "application/json": { "schema": { @@ -22919,7 +22729,7 @@ } }, "post": { - "description": "create a backup\n", + "description": "create a backup", "tags": [ "Backups" ], @@ -22943,7 +22753,7 @@ }, "responses": { "200": { - "description": "create a backup response\n", + "description": "create a backup response", "content": { "application/json": { "schema": { @@ -22963,7 +22773,7 @@ }, "/admin/backups/{filename}": { "put": { - "description": "Download a backup. Sends an email to the account specified by your api_username\nwith a link and token to download the backup.\n", + "description": "Download a backup. Sends an email to the account specified by your api_username\nwith a link and token to download the backup.", "tags": [ "Backups" ], @@ -22980,14 +22790,14 @@ ], "responses": { "200": { - "description": "Send an email to download backup response\n" + "description": "Send an email to download backup response" } } } }, "/admin/emails/{action}.json": { "get": { - "description": "get a list of emails\n", + "description": "get a list of emails", "tags": [ "Emails" ], @@ -23017,7 +22827,7 @@ ], "responses": { "200": { - "description": "list of emails response\n", + "description": "list of emails response", "content": { "application/json": { "schema": { @@ -23065,7 +22875,7 @@ }, "/admin/flags/{type}.json": { "get": { - "description": "get a list of flags\n", + "description": "get a list of flags", "tags": [ "Flags" ], @@ -23091,7 +22901,7 @@ ], "responses": { "200": { - "description": "list of flags response\n", + "description": "list of flags response", "content": { "application/json": { "schema": { @@ -23116,13 +22926,23 @@ }, "/user-badges/{username}.json": { "get": { - "description": "get a list of badges assigned to a user\n", + "description": "get a list of badges assigned to a user", + "parameters": [ + { + "name": "username", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], "tags": [ "Badges" ], "responses": { "200": { - "description": "list of badges assigned to a user response\n", + "description": "list of badges assigned to a user response", "content": { "application/json": { "schema": { @@ -23156,7 +22976,7 @@ }, "/user_badges.json": { "post": { - "description": "assign a badge to a user\n", + "description": "assign a badge to a user", "tags": [ "Badges" ], @@ -23182,7 +23002,7 @@ }, "responses": { "200": { - "description": "assign a badge to a user response\n", + "description": "assign a badge to a user response", "content": { "application/json": { "schema": { @@ -23216,13 +23036,13 @@ }, "/admin/badges.json": { "get": { - "description": "get a list of badges\n", + "description": "get a list of badges", "tags": [ "Badges" ], "responses": { "200": { - "description": "list of badges response\n", + "description": "list of badges response", "content": { "application/json": { "schema": { @@ -23320,7 +23140,7 @@ "type": "number" }, "name": { - "type": "number" + "type": "string" }, "description": { "type": "string" @@ -23394,7 +23214,7 @@ } }, "post": { - "description": "create a badge\n", + "description": "create a badge", "tags": [ "Badges" ], @@ -23453,25 +23273,45 @@ }, "responses": { "200": { - "description": "create a badge response\n" + "description": "create a badge response" } } } }, "/admin/customize/user_fields.json": { "get": { - "description": "list user fields\n", + "description": "list user fields", "tags": [ "User Fields" ], "responses": { "200": { - "description": "list user fields response\n" + "description": "list user fields response", + "content": { + "application/json": { + "schema": { + "description": "", + "type": "object", + "properties": { + "xxxx": { + "type": "array", + "items": { + "properties": { + "xxxx": { + "type": "number" + } + } + } + } + } + } + } + } } } }, "post": { - "description": "create a user fields\n", + "description": "create a user fields", "tags": [ "User Fields" ], @@ -23500,14 +23340,14 @@ }, "responses": { "200": { - "description": "create a user_fields response\n" + "description": "create a user_fields response" } } } }, "/admin/customize/user_fields/{id}": { "delete": { - "description": "delete a user field\n", + "description": "delete a user field", "tags": [ "User Fields" ], @@ -23520,7 +23360,7 @@ ], "responses": { "200": { - "description": "delete a user field response\n", + "description": "delete a user field response", "content": { "application/json": { "schema": { @@ -23540,7 +23380,7 @@ }, "/t/{id}/timer": { "post": { - "description": "Create a timed topic\n", + "description": "Create a timed topic", "tags": [ "Topics" ], @@ -23571,7 +23411,7 @@ }, "responses": { "200": { - "description": "create a timed topic response\n", + "description": "create a timed topic response", "content": { "application/json": { "schema": { @@ -23608,7 +23448,7 @@ }, "/t/{id}/change-timestamp": { "put": { - "description": "Update a topics timestamp\n", + "description": "Update a topics timestamp", "tags": [ "Topics" ], @@ -23629,7 +23469,7 @@ }, "responses": { "200": { - "description": "update timestamp response\n", + "description": "update timestamp response", "content": { "application/json": { "schema": { @@ -23649,7 +23489,7 @@ }, "/t/{id}/notifications": { "post": { - "description": "set notification level\n", + "description": "set notification level", "tags": [ "Topics" ], @@ -23676,7 +23516,7 @@ }, "responses": { "200": { - "description": "set notification level response\n", + "description": "set notification level response", "content": { "application/json": { "schema": { @@ -23696,7 +23536,7 @@ }, "/user_badges/{id}": { "delete": { - "description": "revoke a badge assigned to a user\n", + "description": "revoke a badge assigned to a user", "tags": [ "Badges" ], @@ -23709,7 +23549,7 @@ ], "responses": { "200": { - "description": "revoke a badge response\n", + "description": "revoke a badge response", "content": { "application/json": { "schema": { @@ -23729,7 +23569,7 @@ }, "/user_actions.json": { "get": { - "description": "Get a list of user actions\n", + "description": "Get a list of user actions", "tags": [ "Users" ], @@ -23752,7 +23592,7 @@ ], "responses": { "200": { - "description": "list of user actions response\n", + "description": "list of user actions response", "content": { "application/json": { "schema": { @@ -23848,7 +23688,7 @@ }, "/admin/api/web_hooks": { "post": { - "description": "create a web hook\n", + "description": "create a web hook", "tags": [ "Web Hooks" ], @@ -23892,7 +23732,7 @@ }, "responses": { "200": { - "description": "create a web hook response\n", + "description": "create a web hook response", "content": { "application/json": { "schema": { @@ -23957,7 +23797,7 @@ }, "/admin/backups/readonly": { "put": { - "description": "update readonly mode\n", + "description": "update readonly mode", "tags": [ "Backups" ], @@ -23985,7 +23825,7 @@ }, "/admin/logs/staff_action_logs.json": { "get": { - "description": "get staff action logs\n", + "description": "get staff action logs", "tags": [ "Logs" ], @@ -24003,7 +23843,7 @@ ], "responses": { "200": { - "description": "staff action logs response\n", + "description": "staff action logs response", "content": { "application/json": { "schema": { @@ -24094,13 +23934,13 @@ }, "/about.json": { "get": { - "description": "fetch about page data\n", + "description": "fetch about page data", "tags": [ "About" ], "responses": { "200": { - "description": "about page data response\n", + "description": "about page data response", "content": { "application/json": { "schema": { @@ -24185,7 +24025,7 @@ }, "/polls/vote": { "put": { - "description": "vote on a poll\n", + "description": "vote on a poll", "tags": [ "Poll Plugin" ], @@ -24211,7 +24051,7 @@ }, "responses": { "200": { - "description": "vote on a poll response\n", + "description": "vote on a poll response", "content": { "application/json": { "schema": { @@ -24267,7 +24107,7 @@ }, "/admin/users/{id}/log_out": { "post": { - "description": "Log a user out\n", + "description": "Log a user out", "tags": [ "Users" ], @@ -24280,7 +24120,7 @@ ], "responses": { "200": { - "description": "log a user out response\n", + "description": "log a user out response", "content": { "application/json": { "schema": { @@ -24300,7 +24140,7 @@ }, "/page_view_total_reqs": { "get": { - "description": "return pageview stats, defaults to one month\n", + "description": "return pageview stats, defaults to one month", "tags": [ "Reports" ], @@ -24328,7 +24168,7 @@ ], "responses": { "200": { - "description": "pageviews response\n", + "description": "pageviews response", "content": { "application/json": { "schema": { @@ -24393,7 +24233,7 @@ }, "/export_csv/export_entity.json": { "post": { - "description": "Start export of a report\n", + "description": "Start export of a report", "tags": [ "Reports" ], @@ -24435,7 +24275,7 @@ }, "responses": { "200": { - "description": "Export report response\n", + "description": "Export report response", "content": { "application/json": { "schema": { @@ -24455,7 +24295,7 @@ }, "/user_avatar/{username}/refresh_gravatar.json": { "post": { - "description": "Refresh a users gravatar\n", + "description": "Refresh a users gravatar", "tags": [ "Users" ], @@ -24471,7 +24311,7 @@ ], "responses": { "200": { - "description": "Refresh a users gravatar response\n", + "description": "Refresh a users gravatar response", "content": { "application/json": { "schema": {