swagger.yml

swagger: '2.0'
info:
  title: 'Discourse API Documentation'
  x-logo:
    url: "https://discourse-meta.s3-us-west-1.amazonaws.com/optimized/3X/9/d/9d543e92b15b06924249654667a81441a55867eb_1_690x184.png"
  description: |
    Documentation on how to use Discourse through API calls.

     ### Authentication

    Some endpoints do not require any authentication, pretty much anything else will
    require you to be authenticated.

    To become authenticated you will need to create an API Key from the admin panel.

    Once you have your API Key you can pass it in as a GET url parameter like this:
    
    ```
    curl -X GET "http://127.0.0.1:3000/admin/users/list/active.json?api_key=714552c6148e1617aeab526d0606184b94a80ec048fc09894ff1a72b740c5f19&api_username=discourse1"
    ```

    If you are making a POST request you can pass them in the body:

    ```
    curl -X POST "Content-Type: multipart/form-data;" -F "api_key=714552c6148e1617aeab526d0606184b94a80ec048fc09894ff1a72b740c5f19" -F "api_username=discourse1" -F "name=89853c20-4409-e91a-a8ea-f6cdff96aaaa" -F "color=49d9e9" -F "text_color=f0fcfd" "http://127.0.0.1:3000/categories"
    ```
  version: latest
host: discourse.example.com
schemes:
  - https
basePath: /
produces:
  - application/json
paths:
  /categories.json:
    get:
      summary: Get a list of categories
      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
          schema:
            $ref: 'definitions/categories/categories.yml'
    post:
      description: Create a new category
      parameters:
        - name: name
          in: body
          required: true
          schema:
            $ref: 'definitions/categories/new_category.yml'
      tags:
        - Categories
      responses:
        '200':
          description: category response
          schema:
            $ref: 'definitions/categories/new_category_response.yml'
  /c/{id}.json:
    get:
      description: |
        Get a single category
      tags:
        - Categories
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: category response
          schema:
            $ref: 'definitions/categories/category_response.yml'
  /categories/{id}:
    put:
      description: |
        Update a single category
      tags:
        - Categories
      parameters:
        - name: body
          in: body
          required: true
          schema:
            $ref: 'definitions/categories/update_category.yml'
      responses:
        '200':
          description: update category response
          schema:
            $ref: 'definitions/categories/update_category_response.yml'
  /posts:
    post:
      description: |
        Create a new topic, a new post, or a private message
      tags:
        - Topics
        - Posts
      parameters:
        - name: body
          in: body
          required: false
          schema:
            type: object
            required:
              - raw
            properties:
              title:
                type: string
                description: |
                  required if creating a new topic or new private message
              topic_id:
                type: integer
                description: required if creating a new post
              raw:
                type: string
              category:
                type: integer
                description: |
                  optional if creating a new topic,
                  ignored if creating a new post
              target_usernames:
                type: string
                description: |
                  required for private message, comma separated
                example: discourse1,discourse2
              archetype:
                type: string
                description: |
                  required for private message
                example: private_message
                enum:
                  - private_message
              created_at:
                type: string
                description: |
                  pick a date other than the default current time
                example: "2017-01-31"
      responses:
        '200':
          description: new topic response
          schema:
            $ref: 'definitions/topics/new_topic_response.yml'
  /posts/{id}:
    get:
      description: |
        Get a single post
      tags:
        - Posts
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: post response
          schema:
            $ref: 'definitions/posts/get_post_response.yml'
    put:
      description: |
        Update a single post
      tags:
        - Posts
      parameters:
        - name: id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          schema:
            type: object
            properties:
              post[raw]:
                type: string
      responses:
        '200':
          description: update post response
          schema:
            $ref: 'definitions/posts/update_post_response.yml'
  /post_actions:
    post:
      description: |
        Like a post and other actions
      tags:
        - Posts
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - id
              - post_action_type_id
            properties:
              id:
                type: integer
              post_action_type_id:
                type: integer
              flag_topic:
                type: boolean
  /post_actions/{id}:
    delete:
      description: |
        Un-like a post
      tags:
        - Posts
      parameters:
        - name: id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_action_type_id
            properties:
              post_action_type_id:
                type: integer
  /t/{id}.json:
    get:
      description: |
        Get a single topic
      tags:
        - Topics
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: topic response
          schema:
            $ref: 'definitions/topics/topic_response.yml'
    delete:
      description: |
        Remove a single topic
      tags:
        - Topics
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: |
            delete topic response is empty, just a status code
  /t/{slug}/{id}.json:
    put:
      description: |
        Update a single topic
      tags:
        - Topics
      parameters:
        - name: slug
          in: path
          required: true
          type: string
        - name: id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          required: true
          schema:
            $ref: 'definitions/topics/update_topic.yml'
      responses:
        '200':
          description: update topic response
          schema:
            $ref: 'definitions/topics/update_topic_response.yml'
  /t/{topic_id}/invite:
    post:
      description: |
        Invite user to topic
      tags:
        - Invites
        - Topics
      parameters:
        - name: topic_id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          required: true
          schema:
            type: object
            required:
              - username
            properties:
              username:
                type: string
      responses:
        '200':
          description: invite response
          schema:
            $ref: 'definitions/topics/invite.yml'
  /topics/private-messages/{username}.json:
    get:
      description: |
        Get a list of private messages for a user
      tags:
        - Private Messages
      responses:
        '200':
          description: list of private messages response
          schema:
            $ref: 'definitions/topics/private-messages.yml'
  /topics/private-messages-sent/{username}.json:
    get:
      description: |
        Get a list of private messages sent
      tags:
        - Private Messages
      responses:
        '200':
          description: private messages sent response
          schema:
            $ref: 'definitions/topics/private-messages-sent.yml'
  /notifications.json:
    get:
      description: |
        Get some notifications
      tags:
        - Notifications
      responses:
        '200':
          description: notifications response
          schema:
            $ref: 'definitions/notifications/get.yml'
  /invites:
    post:
      description: |
        Invite a user by email to join your forum
      tags:
        - Invites
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email
            properties:
              email:
                type: string
              group_names:
                type: string
              custom_message:
                type: string
      responses:
        '200':
          description: response
          schema:
            type: object
            properties:
              success:
                type: string
  /invites/link:
    post:
      description: |
        generate an invite link but don't send an email
      tags:
        - Invites
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email
            properties:
              email:
                type: string
              group_names:
                type: string
              custom_message:
                type: string
      responses:
        '200':
          description: response
          schema:
            type: string
            example: "http://forum.com/invites/token_value"
  /invites/disposable:
    post:
      description: |
        Create disposable invite token
      tags:
        - Invites
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - username
            properties:
              username:
                type: string
              email:
                type: string
              quantity:
                type: integer
              group_names:
                type: string
      responses:
        '200':
          description: disposable invites response
          schema:
            type: array
            items:
              type: string
        '429':
          description: rate limit response
          schema:
            type: object
            properties:
              errors:
                type: array
                items:
                  type: string
              error_type:
                type: string
  /tag_groups.json:
    get:
      description: |
        Get a list of tag groups
      tags:
        - Tags
      responses:
        '200':
          description: |
            List of tag groups response
          schema:
            type: object
            properties:
              tag_groups:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    name:
                      type: string
                    tag_names:
                      type: array
                      items:
                        type: string
                    parent_tag_name:
                      type: string
                    one_per_topic:
                      type: boolean
    post:
      description: |
        Create a new tag group
      tags:
        - Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - name
            properties:
              name:
                type: string
              tag_names:
                type: array
                items:
                  type: string
      responses:
        '200':
          description: |
            Create tab group response
          schema:
            type: object
            properties:
              tag_group:
                type: object
                required:
                  - id
                  - name
                  - tag_names
                  - parent_tag_name
                  - one_per_topic
                properties:
                  id:
                    type: integer
                  name:
                    type: string
                  tag_names:
                    type: array
                    items:
                      type: string
                  parent_tag_name:
                    type: array
                    items:
                      properties:
                        tag_name:
                          type: string
                  one_per_topic:
                    type: boolean
  /tag_groups/{id}.json:
    get:
      description: |
        Get a single tag group
      tags:
        - Tags
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: |
            Tag group response
          schema:
            type: object
            properties:
              tag_group:
                type: object
                properties:
                  id:
                    type: integer
                  name:
                    type: string
                  tag_names:
                    type: array
                    items:
                      type: string
                  parent_tag_name:
                    type: array
                    items:
                      properties:
                        tag_name:
                          type: string
                  one_per_topic:
                    type: boolean
    put:
      description: |
        Update an existing tag group
      tags:
        - Tags
      parameters:
        - name: id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          schema:
            type: object
            required:
              - name
            properties:
              name:
                type: string
              tag_names:
                type: array
                items:
                  type: string
      responses:
        '200':
          description: |
            Create tab group response
          schema:
            type: object
            properties:
              success:
                type: string
                example: OK
              tag_group:
                type: object
                properties:
                  id:
                    type: integer
                  name:
                    type: string
                  tag_names:
                    type: array
                    items:
                      type: string
                  parent_tag_name:
                    type: array
                    items:
                      properties:
                        tag_name:
                          type: string
                  one_per_topic:
                    type: boolean
  /users/{username}.json:
    get:
      description: |
        Get a single user by username
      tags:
        - Users
      parameters:
        - name: username
          in: path
          required: true
          type: string
      responses:
        '200':
          description: get user response
          schema:
            $ref: 'definitions/users/get_user_response.yml'
  /uploads.json:
    post:
      description: |
        Upload an image or avatar
      tags:
        - Upload
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - type
            properties:
              type:
                type: string
                example: upload
                description: |
                  a lowercase string with numbers but no spaces. Set to 'avatar' if uploading an avatar
                enum:
                  - avatar
                  - profile_background
                  - card_background
                  - custom_emoji
              user_id:
                type: integer
                example: 1
                description: required if uploading an avatar
              synchronous:
                type: boolean
                example: true
                description: use this flag to return an id and url
        - name: files[]
          in: formData
          required: true
          type: file
      responses:
        200:
          description: |
            if async will return '{ success: true}'
          schema:
            type: object
            properties:
              id:
                type: integer
              user_id:
                type: integer
              original_filename:
                type: string
              filesize:
                type: integer
              width:
                type: integer
              height:
                type: integer
              url:
                type: string
              created_at:
                type: string
              updated_at:
                type: string
              sha1:
                type: string
              origin:
                type: null
              retain_hours:
                type: null
  /users/{username}/preferences/avatar/pick:
    put:
      description: |
        update avatar
      tags:
        - Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - upload_id
              - type
            properties:
              upload_id:
                type: integer
                example: 4
              type:
                type: string
                example: uploaded
  /users/{username}/preferences/email:
    put:
      description: |
        update email
      tags:
        - Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email
            properties:
              email:
                type: string
                example: discourse1@example.com
  /users:
    post:
      description: |
        Creates a new user
      tags:
        - Users
      parameters:
        - name: body
          in: body
          schema:
            $ref: 'definitions/users/new_user.yml'
      responses:
        '200':
          description: new user response
          schema:
            $ref: 'definitions/users/new_user_response.yml'
  /directory_items.json?period={period}&order={order}:
    get:
      description: |
        get a public list of users
      tags:
        - Users
      parameters:
        - name: period
          in: path
          required: true
          type: string
          enum:
            - daily
            - weekly
            - monthly
            - quarterly
            - yearly
            - all
        - name: order
          in: path
          required: true
          type: string
          enum:
            - likes_received
            - likes_given
            - topic_count
            - post_count
            - topics_entered
            - posts_read
            - days_visited
        - name: asc
          in: path
          required: false
          type: boolean
          enum:
            - true
        - name: page
          in: path
          required: false
          type: integer
      responses:
        '200':
          description: |
            public list of users response
          schema:
            $ref: 'definitions/users/directory_items_response.yml'
  /tags:
    get:
      description: |
        get a list of tags
      tags:
        - Tags
      responses:
        '200':
          description: |
            tag list response
  /tags/{tag}:
    get:
      description: |
        Get a specific tag
      tags:
        - Tags
      parameters:
        - name: tag
          in: path
          required: true
          type: string
      responses:
        '200':
          description: |
            tag response
  /search/query:
    get:
      description: |
        Search for something
      tags:
        - Search
      parameters:
        - name: term
          in: path
          required: true
          type: string
        - name: include_blurbs
          in: path
          required: false
          type: boolean
      responses:
        '200':
          description: search response
          schema:
            $ref: 'definitions/search/query_response.yml'
  /admin/email.json:
    get:
      description: |
        Show email settings
      tags:
        - Admin Emails
      responses:
        '200':
          description: |
            email settings response
          schema:
            type: object
            properties:
              delivery_method:
                type: string
                example: smtp
              settings:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      example: address
                    value:
                      type: string
                      example: localhost
  /admin/customize/email_templates.json:
    get:
      description: |
        show list of email templates
      tags:
        - Admin Emails
      responses:
        '200':
          description: |
            show email templates response
          schema:
            type: object
            properties:
              email_templates:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    title:
                      type: string
                    subject:
                      type: string
                    body:
                      type: string
                    can_revert:
                      type: boolean
  /admin/users/{id}/suspend:
    put:
      description: |
        Suspend a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
        - name: body
          in: body
          schema:
            type: object
            required:
              - duration
              - reason
            properties:
              duration:
                type: integer
              reason:
                type: string
      responses:
        '200':
          description: empty response body
  /admin/users/{id}/unsuspend:
    put:
      description: |
        Unsuspend a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: empty response body
  /admin/users/{id}/block:
    put:
      description: |
        Block a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: empty response body
  /admin/users/{id}/unblock:
    put:
      description: |
        Unblock a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: empty response body
  /admin/users/{id}/activate:
    put:
      description: |
        Activate a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: activate user response
          schema:
            type: object
            properties:
              success:
                type: string
  /admin/users/{id}/generate_api_key:
    post:
      description: |
        Generate/Regenerate api_key for a user
      tags:
        - Admin
      parameters:
        - name: id
          in: path
          required: true
          type: integer
      responses:
        '200':
          description: generate api key response
          schema:
            $ref: 'definitions/admin/generate_api_key.yml'
  /admin/users/list/{flag}.json:
    get:
      description: |
        returns a list of users
      tags:
        - Admin
        - Users
      parameters:
        - name: flag
          in: path
          required: true
          type: string
          enum:
            - active
            - new
            - staff
            - suspended
            - blocked
            - suspect
        - name: order
          in: path
          required: false
          type: string
          enum:
            - created
            - last_emailed
            - seen
            - username
            - email
            - trust_level
            - days_visited
            - posts_read
            - topics_viewed
            - posts
            - read_time
        - name: ascending
          in: path
          required: false
          type: boolean
          description: |
            optional. defaults to desc.
      responses:
        '200':
          description: list of users response
          schema:
            $ref: 'definitions/users/list.yml'
  /admin/groups.json:
    get:
      description: |
        Get some groups
      tags:
        - Admin
        - Groups
      responses:
        '200':
          description: groups response
          schema:
            $ref: 'definitions/groups/get_groups_response.yml'
  /admin/groups:
    post:
      description: |
        Create a group
      tags:
        - Admin
        - Groups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - group[name]
            properties:
              group[name]:
                type: string
      responses:
        '200':
          description: create group response
          schema:
            $ref: 'definitions/groups/new_group_response.yml'
  /admin/groups/{group_id}.json:
    delete:
      description: |
        Delete a group
      tags:
        - Admin
        - Groups
      responses:
        '200':
          description: delete group response
          schema:
            type: object
            properties:
              success:
                type: string
  /groups/{group_name}/members.json:
    get:
      description: |
        Get some group members
      tags:
        - Admin
        - Groups
      responses:
        '200':
          description: group members response
          schema:
            $ref: 'definitions/groups/group_members_response.yml'
  /groups/{group_id}/members.json:
    put:
      description: |
        Add users to a group (comma separated)
      tags:
        - Admin
        - Groups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - usernames
            properties:
              usernames:
                type: string
      responses:
        '200':
          description: |
            add user to group response
          schema:
            type: object
            properties:
              success:
                type: string
          
    delete:
      description: |
        Delete a user from a group
      tags:
        - Admin
        - Groups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - user_id
            properties:
              user_id:
                type: integer
      responses:
        '200':
          description: delete user from group response
          schema:
            type: object
            properties:
              success:
                type: string
  /latest.json:
    get:
      description: |
        Get the latest topics
      tags:
        - Topics
      parameters:
        - name: order
          in: path
          required: false
          type: string
          enum:
            - default
            - created
            - activity
            - views
            - posts
            - category
            - likes
            - op_likes
            - posters
        - name: ascending
          in: path
          required: false
          type: boolean
          description: defaults to desc, add `ascending=true` to sort asc
      responses:
        '200':
          description: latest topics response
          schema:
            $ref: 'definitions/topics/latest_topics_response.yml'
  /top.json:
    get:
      description: |
        Get the top topics
      tags:
        - Topics
      responses:
        '200':
          description: top topics response
          schema:
            $ref: 'definitions/topics/top.yml'
  /top/{flag}.json:
    get:
      description: |
        Get the top topics filtered by specified flag
      tags:
        - Topics
      parameters:
        - name: flag
          in: path
          required: false
          type: string
          enum:
            - all
            - yearly
            - quarterly
            - monthly
            - weekly
            - daily
  /session/forgot_password:
    post:
      description: |
        Send password reset email
      tags:
        - Password Reset
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - login
            properties:
              login:
                type: string
      responses:
        '200':
          description: |
            send password reset email response
          schema:
            type: object
            properties:
              result:
                type: string
              user_found:
                type: boolean
  /users/password-reset/{token}:
    put:
      description: |
        create a new password
      tags:
        - Password Reset
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - username
              - password
            properties:
              username:
                type: string
              password:
                type: string
      responses:
        '200':
          description: |
            password has been reset response
  /admin/site_settings.json:
    get:
      description: |
        show site settings
      tags:
        - Admin
      responses:
        '200':
          description: show site settings response
          schema:
            $ref: 'definitions/admin/site_settings.yml'
  /admin/site_settings/title:
    put:
      description: |
        Update the site title
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - title
            properties:
              title:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/site_description:
    put:
      description: |
        Update the site description
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - site_description
            properties:
              site_description:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/contact_email:
    put:
      description: |
        Update the contact email
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - contact_email
            properties:
              contact_email:
                type: string
      responses:
        '200':
          description: |
            empty response body
        '422':
          description: |
            Invalid email address
          schema:
            type: object
            properties:
              errors:
                type: array
                items:
                  type: string
  /admin/site_settings/contact_url:
    put:
      description: |
        Update the contact url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - contact_url
            properties:
              contact_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/notification_email:
    put:
      description: |
        Update the notification email
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - notification_email
            properties:
              notification_email:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/site_contact_username:
    put:
      description: |
        Update the site contact username
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - site_contact_username
            properties:
              site_contact_username:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/logo_url:
    put:
      description: |
        Update logo url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - logo_url
            properties:
              logo_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/logo_small_url:
    put:
      description: |
        Update the small logo url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - logo_small_url
            properties:
              logo_small_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_logo_url:
    put:
      description: |
        Update the digest logo url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_logo_url
            properties:
              digest_logo_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/mobile_logo_url:
    put:
      description: |
        Update the mobile logo url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - mobile_logo_url
            properties:
              mobile_logo_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/favicon_url:
    put:
      description: |
        Update the favicon url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - favicon_url
            properties:
              favicon_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/apple_touch_icon_url:
    put:
      description: |
        Update the apple touch icon url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - apple_touch_icon_url
            properties:
              apple_touch_icon_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_opengraph_image_url:
    put:
      description: |
        Update the default opengraph image url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_opengraph_image_url
            properties:
              default_opengraph_image_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/twitter_summary_large_image_url:
    put:
      description: |
        Update the twitter summary large image url
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - twitter_summary_large_image_url
            properties:
              twitter_summary_large_image_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/exclude_rel_nofollow_domains:
    put:
      description: |
        Update the exclude rel nofollow domains
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - exclude_rel_nofollow_domains
            properties:
              exclude_rel_nofollow_domains:
                description: |
                  pipe delimited
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/company_short_name:
    put:
      description: |
        Update the company short name
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - company_short_name
            properties:
              company_short_name:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/company_full_name:
    put:
      description: |
        Update the company full name
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - company_full_name
            properties:
              company_full_name:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/company_domain:
    put:
      description: |
        Update the company domain
      tags:
        - Site Settings Required
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - company_domain
            properties:
              company_domain:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_locale:
    put:
      description: |
        Update the default locale
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_locale
            properties:
              default_locale:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_user_locale:
    put:
      description: |
        Update allow user locale
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_user_locale
            properties:
              allow_user_locale:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/set_locale_from_accept_language_header:
    put:
      description: |
        Update set locale from accept language header
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - set_locale_from_accept_language_header
            properties:
              set_locale_from_accept_language_header:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/categories_topics:
    put:
      description: |
        Update the number of topics to show
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - categories_topics
            properties:
              categories_topics:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suggested_topics:
    put:
      description: |
        Update the number of suggested topics
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suggested_topics
            properties:
              suggested_topics:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/limit_suggested_to_category:
    put:
      description: |
        Update show topics from the current category
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - limit_suggested_to_category
            properties:
              limit_suggested_to_category:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suggested_topics_max_days_old:
    put:
      description: |
        Update suggested topics max days old
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suggested_topics_max_days_old
            properties:
              suggested_topics_max_days_old:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/track_external_right_clicks:
    put:
      description: |
        Update track external right clicks
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - track_external_right_clicks
            properties:
              track_external_right_clicks:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/ga_universal_tracking_code:
    put:
      description: |
        Update Google Universal Analytics tracking code
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - ga_universal_tracking_code
            properties:
              ga_universal_tracking_code:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/ga_universal_domain_name:
    put:
      description: |
        Update Google Universal Analytics domain name
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - ga_universal_domain_name
            properties:
              ga_universal_domain_name:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/ga_tracking_code:
    put:
      description: |
        Update the OBSOLETE ga tracking code
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - ga_tracking_code
            properties:
              ga_tracking_code:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/ga_domain_name:
    put:
      description: |
        Update the OBSOLETE ga domain name
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - ga_domain_name
            properties:
              ga_domain_name:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/gtm_container_id:
    put:
      description: |
        Update Google Tag Manager container id
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - gtm_container_id
            properties:
              gtm_container_id:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/top_menu:
    put:
      description: |
        Update the homepage navigation
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - top_menu
            properties:
              top_menu:
                description: pipe delimited
                example: latest|new|unread|top|categories|read
                type: string
                enum:
                  - latest
                  - new
                  - unread
                  - top
                  - categories
                  - read
                  - posted
                  - bookmarks
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_menu:
    put:
      description: |
        Update the post menu items
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_menu
            properties:
              post_menu:
                description: pipe delimited
                example: like|edit|flag|delete|share|bookmark|reply
                type: string
                enum:
                  - like-count
                  - like
                  - share
                  - flag
                  - edit
                  - bookmark
                  - delete
                  - admin
                  - reply
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_menu_hidden_items:
    put:
      description: |
        Update the post menu hidden items
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_menu_hidden_items
            properties:
              post_menu_hidden_items:
                description: pipe delimited
                example: like|edit|flag|delete|share|bookmark|reply
                type: string
                enum:
                  - like
                  - share
                  - flag
                  - edit
                  - bookmark
                  - delete
                  - admin
                  - reply
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/desktop_category_page_style:
    put:
      description: |
        Update the visual style for the /categories page
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - desktop_category_page_style
            properties:
              desktop_category_page_style:
                type: string
                enum:
                  - categories_only
                  - categories_with_featured_topics
                  - categories_and_latest_topics
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/category_colors:
    put:
      description: |
        Update a list of hexadecimal color values
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - category_colors
            properties:
              category_colors:
                description: pipe delimited
                example: BF1E2E|F1592A|F7941D
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/category_style:
    put:
      description: |
        Update the category style
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - category_style
            properties:
              category_style:
                type: string
                enum:
                  - bar
                  - box
                  - bullet
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_mobile_theme:
    put:
      description: |
        Update enable mobile theme
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_mobile_theme
            properties:
              enable_mobile_theme:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/relative_date_duration:
    put:
      description: |
        Update relative date duration
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - relative_date_duration
            properties:
              relative_date_duration:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/fixed_category_positions:
    put:
      description: |
        Update fixed category positions
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - fixed_category_positions
            properties:
              fixed_category_positions:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/fixed_category_positions_on_create:
    put:
      description: |
        Update fixed category positions on create
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - fixed_category_positions_on_create
            properties:
              fixed_category_positions_on_create:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_subcategory_list:
    put:
      description: |
        Update show subcategory list
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_subcategory_list
            properties:
              show_subcategory_list:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_badges:
    put:
      description: |
        Update enable the badge system
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_badges
            properties:
              enable_badges:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_whispers:
    put:
      description: |
        Update enable whispers
      tags:
        - Site Settings Basic Setup
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_whispers
            properties:
              enable_whispers:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/invite_only:
    put:
      description: |
        Update invite only
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - invite_only
            properties:
              invite_only:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/login_required:
    put:
      description: |
        Update login required
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - login_required
            properties:
              login_required:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/must_approve_users:
    put:
      description: |
        Update must approve users
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - must_approve_users
            properties:
              must_approve_users:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_local_logins:
    put:
      description: |
        Update enable_local_logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_local_logins
            properties:
              enable_local_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_new_registrations:
    put:
      description: |
        Update allow new registrations
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_new_registrations
            properties:
              allow_new_registrations:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_signup_cta:
    put:
      description: |
        Update enable signup cta
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_signup_cta
            properties:
              enable_signup_cta:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_google_oauth2_logins:
    put:
      description: |
        Update enable Google Oauth2 authentication
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_google_oath2_logins
            properties:
              enable_google_oath2_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/google_oath2_client_id:
    put:
      description: |
        Update google oauth2 client id
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - google_oath2_client_id
            properties:
              google_oath2_client_id:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/google_oath2_client_secret:
    put:
      description: |
        Update google oauth2 client secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - google_oath2_client_secret
            properties:
              google_oath2_client_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_yahoo_logins:
    put:
      description: |
        Update enable yahoo logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_yahoo_logins
            properties:
              enable_yahoo_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_twitter_logins:
    put:
      description: |
        Enable twitter logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_twitter_logins
            properties:
              enable_twitter_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/twitter_consumer_key:
    put:
      description: |
        twitter consumer key
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - twitter_consumer_key
            properties:
              twitter_consumer_key:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/twitter_consumer_secret:
    put:
      description: |
        twitter consumer secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - twitter_consumer_secret
            properties:
              twitter_consumer_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_instagram_logins:
    put:
      description: |
        enable instagram logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_instagram_logins
            properties:
              enable_instagram_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/instagram_consumer_key:
    put:
      description: |
        instagram consumer key
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - instagram_consumer_key
            properties:
              instagram_consumer_key:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/instagram_consumer_secret:
    put:
      description: |
        instagram consumer secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - instagram_consumer_secret
            properties:
              instagram_consumer_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_facebook_logins:
    put:
      description: |
        enable facebook logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_facebook_logins
            properties:
              enable_facebook_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/facebook_app_id:
    put:
      description: |
        facebook app id
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - facebook_app_id
            properties:
              facebook_app_id:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/facebook_app_secret:
    put:
      description: |
        facebook app secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - facebook_app_secret
            properties:
              facebook_app_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/facebook_request_extra_profile_details:
    put:
      description: |
        facebook request extra profile details
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - facebook_request_extra_profile_details
            properties:
              facebook_request_extra_profile_details:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_github_logins:
    put:
      description: |
        enable github logins
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_github_logins
            properties:
              enable_github_logins:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/github_client_id:
    put:
      description: |
        github client id
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - github_client_id
            properties:
              github_client_id:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/github_client_secret:
    put:
      description: |
        github client secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - github_client_secret
            properties:
              github_client_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_sso:
    put:
      description: |
        enable sso
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_sso
            properties:
              enable_sso:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_allows_all_return_paths:
    put:
      description: |
        sso allows all return paths
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_allows_all_return_paths
            properties:
              ss_allows_all_return_paths:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_sso_provider:
    put:
      description: |
        enable sso provider
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_sso_provider
            properties:
              enable_sso_provider:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/verbose_sso_logging:
    put:
      description: |
        verbose sso logging
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - verbose_sso_logging
            properties:
              verbose_sso_logging:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_url:
    put:
      description: |
        sso url
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_url
            properties:
              sso_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_secret:
    put:
      description: |
        sso secret
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_secret
            properties:
              sso_secret:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_overrides_bio:
    put:
      description: |
        sso overrides bio
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_overrides_bio
            properties:
              sso_overrides_bio:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_overrides_email:
    put:
      description: |
        sso overrides email
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_overrides_email
            properties:
              sso_overrides_email:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_overrides_username:
    put:
      description: |
        sso overrides username
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_overrides_username
            properties:
              sso_overrides_username:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_overrides_name:
    put:
      description: |
        sso overrides name
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_overrides_name
            properties:
              sso_overrides_name:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_overrides_avatar:
    put:
      description: |
        sso overrides avatar
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_overrides_avatar
            properties:
              sso_overrides_avatar:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sso_not_approved_url:
    put:
      description: |
        sso not approved url
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sso_not_approved_url
            properties:
              sso_not_approved_url:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_domains_blacklist:
    put:
      description: |
        email domains blacklist
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_domains_blacklist
            properties:
              email_domains_blacklist:
                description: |
                  pipe delimited
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_domains_whitelist:
    put:
      description: |
        email domains whitelist
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_domains_whitelist
            properties:
              email_domains_whitelist:
                description: |
                  pipe delimited
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/forgot_password_strict:
    put:
      description: |
        forgot password strict
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - forgot_password_strict
            properties:
              forgot_password_strict:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/log_out_strict:
    put:
      description: |
        log out strict
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - log_out_strict
            properties:
              log_out_strict:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pending_users_reminder_delay:
    put:
      description: |
        pending users reminder delay
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pending_users_reminder_delay
            properties:
              pending_users_reminder_delay:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/maximum_session_age:
    put:
      description: |
        maximum session age
      tags:
        - Site Settings Login
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - maximum_session_age
            properties:
              maximum_session_age:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_username_length:
    put:
      description: |
        min username length
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_username_length
            properties:
              min_username_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_username_length:
    put:
      description: |
        max username length
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_username_length
            properties:
              max_username_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/reserved_usernames:
    put:
      description: |
        reserved usernames
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - reserved_usernames
            properties:
              reserved_usernames:
                description: |
                  pipe delimited
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_password_length:
    put:
      description: |
        min password length
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_password_length
            properties:
              min_password_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_admin_password_length:
    put:
      description: |
        min admin password length
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_admin_password_length
            properties:
              min_admin_password_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/block_common_passwords:
    put:
      description: |
        block common passwords
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - block_common_passwords
            properties:
              block_common_passwords:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/username_change_period:
    put:
      description: |
        username change period
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - username_change_period
            properties:
              username_change_period:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_editable:
    put:
      description: |
        email editable
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_editable
            properties:
              email_editable:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/logout_redirect:
    put:
      description: |
        logout redirect
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - logout_redirect
            properties:
              logout_redirect:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/full_name_required:
    put:
      description: |
        full name required
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - full_name_required
            properties:
              full_name_required:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_names:
    put:
      description: |
        enable names
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_names
            properties:
              enable_names:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/invite_expiry_days:
    put:
      description: |
        invite expiry days
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - invite_expiry_days
            properties:
              invite_expiry_days:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/invite_passthrough_hours:
    put:
      description: |
        invite passthrough hours
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - invite_passthrough_hours
            properties:
              invite_passthrough_hours:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/invites_per_page:
    put:
      description: |
        invites per page
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - invites_per_page
            properties:
              invites_per_page:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_user_max_post_age:
    put:
      description: |
        delete user max post age
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_user_max_post_age
            properties:
              delete_user_max_post_age:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_all_posts_max:
    put:
      description: |
        delete all posts max
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_all_posts_max
            properties:
              delete_all_posts_max:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/redirect_users_to_top_page:
    put:
      description: |
        redirect users to top page
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - redirect_users_to_top_page
            properties:
              redirect_users_to_top_page:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_email_on_profile:
    put:
      description: |
        show email on profile
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_email_on_profile
            properties:
              show_email_on_profile:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/prioritize_username_in_ux:
    put:
      description: |
        prioritize username in ux
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - prioritize_username_in_ux
            properties:
              prioritize_username_in_ux:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_token_valid_hours:
    put:
      description: |
        email token valid hours
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_token_valid_hours
            properties:
              email_token_valid_hours:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/purge_unactivated_users_grace_period_days:
    put:
      description: |
        purge unactivated users grace period days
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - purge_unactivated_users_grace_period_days
            properties:
              purge_unactivated_users_grace_period_days:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/public_user_custom_fields:
    put:
      description: |
        public user custom fields
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - public_user_custom_fields
            properties:
              public_user_custom_fields:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/staff_users_custom_fields:
    put:
      description: |
        staff user custom fields
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - staff_users_custom_fields
            properties:
              staff_users_custom_fields:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_user_directory:
    put:
      description: |
        enable user directory
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_user_directory
            properties:
              enable_user_directory:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_anonymous_posting:
    put:
      description: |
        allow anonymous posting
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_anonymous_posting
            properties:
              allow_anonymous_posting:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/anonymous_posting_min_trust_level:
    put:
      description: |
        anonymous posting min trust level
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - anonymous_posting_min_trust_level
            properties:
              anonymous_posting_min_trust_level:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/anonymous_account_duration_minutes:
    put:
      description: |
        anonymous account duration minutes
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - anonymous_account_duration_minutes
            properties:
              anonymous_account_duration_minutes:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/hide_user_profiles_from_public:
    put:
      description: |
        hide user profiles from public
      tags:
        - Site Settings Users
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - hide_user_profiles_from_public
            properties:
              hide_user_profiles_from_public:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_post_length:
    put:
      description: |
        min post length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_post_length
            properties:
              min_post_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_first_post_length:
    put:
      description: |
        min first post length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_first_post_length
            properties:
              min_first_post_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_private_message_post_length:
    put:
      description: |
        min private message post length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_private_message_post_length
            properties:
              min_private_message_post_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_post_length:
    put:
      description: |
        max post length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_post_length
            properties:
              max_post_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_featured_link_enabled:
    put:
      description: |
        topic featured link enabled
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_featured_link_enabled
            properties:
              topic_featured_link_enabled:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/body_min_entropy:
    put:
      description: |
        body min entropy
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - body_min_entropy
            properties:
              body_min_entropy:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_topic_title_length:
    put:
      description: |
        min topic title length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_topic_title_length
            properties:
              min_topic_title_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_topic_title_length:
    put:
      description: |
        max topic title length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_topic_title_length
            properties:
              max_topic_title_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/title_min_entropy:
    put:
      description: |
        title min entropy
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - title_min_entropy
            properties:
              title_min_entropy:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_uppercase_posts:
    put:
      description: |
        allow_uppercase_posts
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_uppercase_posts
            properties:
              allow_uppercase_posts:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/title_prettify:
    put:
      description: |
        title_prettify
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - title_prettify
            properties:
              title_prettify:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/title_fancy_entities:
    put:
      description: |
        title fancy entities
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - title_fancy_entities
            properties:
              title_fancy_entities:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_private_message_title_length:
    put:
      description: |
        min private message title length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_private_message_title_length
            properties:
              min_private_message_title_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_uncategorized_topics:
    put:
      description: |
        allow uncategorized topics
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_uncategorized_topics
            properties:
              allow_uncategorized_topics:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_duplicate_topic_titles:
    put:
      description: |
        allow duplicate topic titles
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_duplicate_topic_titles
            properties:
              allow_duplicate_topic_titles:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_title_similar_length:
    put:
      description: |
        min_title_similar_length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_title_similar_length
            properties:
              min_title_similar_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_body_title_length:
    put:
      description: |
        min body title length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_body_title_length
            properties:
              min_body_title_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_private_messages:
    put:
      description: |
        enable private messages
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_private_messages
            properties:
              enable_private_messages:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/editing_grace_period:
    put:
      description: |
        editing grace period
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - editing_grace_period
            properties:
              editing_grace_period:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_edit_time_limit:
    put:
      description: |
        post edit time limit
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_edit_time_limit
            properties:
              post_edit_time_limit:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/edit_history_visible_to_public:
    put:
      description: |
        edit history visible to public
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - edit_history_visible_to_public
            properties:
              edit_history_visible_to_public:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_removed_posts_after:
    put:
      description: |
        delete removed posts after
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_removed_posts_after
            properties:
              delete_removed_posts_after:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/traditional_markdown_linebreaks:
    put:
      description: |
        traditional markdown linebreaks
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - traditional_markdown_linebreaks
            properties:
              traditional_markdown_linebreaks:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_html_tables:
    put:
      description: |
        allow html tables
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_html_tables
            properties:
              allow_html_tables:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suppress_reply_directly_below:
    put:
      description: |
        suppress reply directly below
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suppress_reply_directly_below
            properties:
              suppress_reply_directly_below:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suppress_reply_directly_above:
    put:
      description: |
        suppress reply directly above
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suppress_reply_directly_above
            properties:
              suppress_reply_directly_above:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suppress_reply_when_quoting:
    put:
      description: |
        suppress reply when quoting
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suppress_reply_when_quoting
            properties:
              suppress_reply_when_quoting:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_reply_history:
    put:
      description: |
        max reply history
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_reply_history
            properties:
              max_reply_history:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_undo_action_window_mins:
    put:
      description: |
        post undo action window mins
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_undo_action_window_mins
            properties:
              post_undo_action_window_mins:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_mentions_per_post:
    put:
      description: |
        max mentions per post
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_mentions_per_post
            properties:
              max_mentions_per_post:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_users_notified_per_group_mention:
    put:
      description: |
        max users notified per group mention
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_users_notified_per_group_mention
            properties:
              max_users_notified_per_group_mention:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_max_replies_per_topic:
    put:
      description: |
        newuser max replies per topic
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_max_replies_per_topic
            properties:
              newuser_max_replies_per_topic:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_max_mentions_per_post:
    put:
      description: |
        newuser max mentions per post
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_max_mentions_per_post
            properties:
              newuser_max_mentions_per_post:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/title_max_word_length:
    put:
      description: |
        title max word length
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - title_max_word_length
            properties:
              title_max_word_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_max_links:
    put:
      description: |
        newuser max links
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_max_links
            properties:
              newuser_max_links:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_max_images:
    put:
      description: |
        newuser max images
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_max_images
            properties:
              newuser_max_images:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_max_attachments:
    put:
      description: |
        newuser max attachments
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_max_attachments
            properties:
              newuser_max_attachments:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_excerpt_maxlength:
    put:
      description: |
        post excerpt maxlength
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_excerpt_maxlength
            properties:
              post_excerpt_maxlength:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_pinned_excerpt_mobile:
    put:
      description: |
        show pinned excerpt mobile
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_pinned_excerpt_mobile
            properties:
              show_pinned_excerpt_mobile:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_pinned_excerpt_desktop:
    put:
      description: |
        show pinned excerpt desktop
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_pinned_excerpt_desktop
            properties:
              show_pinned_excerpt_desktop:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/display_name_on_posts:
    put:
      description: |
        display name on posts
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - display_name_on_posts
            properties:
              display_name_on_posts:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_time_gap_days:
    put:
      description: |
        show time gap days
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_time_gap_days
            properties:
              show_time_gap_days:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/short_progress_text_threshold:
    put:
      description: |
        short progress text threshold
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - short_progress_text_threshold
            properties:
              short_progress_text_threshold:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_code_lang:
    put:
      description: |
        default code lang
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_code_lang
            properties:
              default_code_lang:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/warn_reviving_old_topic_age:
    put:
      description: |
        warn reviving old topic age
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - warn_reviving_old_topic_age
            properties:
              warn_reviving_old_topic_age:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/autohighlight_all_code:
    put:
      description: |
        autohighlight all code
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - autohighlight_all_code
            properties:
              autohighlight_all_code:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/highlighted_languages:
    put:
      description: |
        highlighted languages
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - highlighted_languages
            properties:
              highlighted_languages:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_old_hidden_posts:
    put:
      description: |
        delete old hidden posts
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_old_hidden_posts
            properties:
              delete_old_hidden_posts:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/censored_words:
    put:
      description: |
        censored words
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - censored_words
            properties:
              censored_words:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/censored_pattern:
    put:
      description: |
        censored pattern
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - censored_pattern
            properties:
              censored_pattern:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_emoji:
    put:
      description: |
        enable emoji
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_emoji
            properties:
              enable_emoji:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/emoji_set:
    put:
      description: |
        emoji set
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - emoji_set
            properties:
              emoji_set:
                type: string
                enum:
                  - apple
                  - google
                  - twitter
                  - emoji_one
                  - win10
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enforce_square_emoji:
    put:
      description: |
        enforce square emoji
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enforce_square_emoji
            properties:
              enforce_square_emoji:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/approve_post_count:
    put:
      description: |
        approve post count
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - approve_post_count
            properties:
              approve_post_count:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/approve_unless_trust_level:
    put:
      description: |
        approve unless trust level
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - approve_unless_trust_level
            properties:
              approve_unless_trust_level:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/approve_new_topics_unless_trust_level:
    put:
      description: |
        approve new topics unless trust level
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - approve_new_topics_unless_trust_level
            properties:
              approve_new_topics_unless_trust_level:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/notify_about_queued_posts_after:
    put:
      description: |
        notify about queued posts after
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - notify_about_queued_posts_after
            properties:
              notify_about_queued_posts_after:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_close_messages_post_count:
    put:
      description: |
        auto close messages post count
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_close_messages_post_count
            properties:
              auto_close_messages_post_count:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_close_topics_post_count:
    put:
      description: |
        auto close topics post count
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_close_topics_post_count
            properties:
              auto_close_topics_post_count:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/code_formatting_style:
    put:
      description: |
        code formatting style
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - code_formatting_style
            properties:
              code_formatting_style:
                type: string
                enum:
                  - 4-spaces-indent
                  - code-fences
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/embed_truncate:
    put:
      description: |
        embed truncate
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - embed_truncate
            properties:
              embed_truncate:
                type: boolean
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allowed_href_schemes:
    put:
      description: |
        allowed href schemes
      tags:
        - Site Settings Posting
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allowed_href_schemes
            properties:
              allowed_href_schemes:
                type: string
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_time_window_mins:
    put:
      description: |
        email time window mins
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_time_window_mins
            properties:
              email_time_window_mins:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/private_email_time_window_seconds:
    put:
      description: |
        private email time window seconds
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - private_email_time_window_seconds
            properties:
              private_email_time_window_seconds:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_posts_context:
    put:
      description: |
        email posts context
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_posts_context
            properties:
              email_posts_context:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_min_excerpt_length:
    put:
      description: |
        digest min excerpt length
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_min_excerpt_length
            properties:
              digest_min_excerpt_length:
                type: integer
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_topics:
    put:
      description: |
        digest topics
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_topics
            properties:
              digest_topics:
                type: integer
                example: 5
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_posts:
    put:
      description: |
        digest posts
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_posts
            properties:
              digest_posts:
                type: integer
                example: 3
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_other_topics:
    put:
      description: |
        digest other topics
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_other_topics
            properties:
              digest_other_topics:
                type: integer
                example: 5
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_digest_email_after_days:
    put:
      description: |
        delete digest email after days
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_digest_email_after_days
            properties:
              delete_digest_email_after_days:
                type: integer
                example: 365
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/digest_suppress_categories:
    put:
      description: |
        digest suppress categories
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - digest_suppress_categories
            properties:
              digest_suppress_categories:
                type: string
                description: pipe delimited category_id's
                example: 3|1
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disable_digest_emails:
    put:
      description: |
        disable digest emails
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disable_digest_emails
            properties:
              digest_digest_emails:
                type: boolean
                example: false
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_accent_bg_color:
    put:
      description: |
        email accent bg color
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_accent_bg_color
            properties:
              email_accent_bg_color:
                type: string
                example: "#2F70AD"
                description: |
                  Enter a color name ('red') or hex value ('#FF000').
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_accent_fg_color:
    put:
      description: |
        email accent fg color
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_accent_fg_color
            properties:
              email_accent_fg_color:
                type: string
                example: "#FFFFFF"
                description: |
                  Enter a color name ('white') or hex value ('#FFFFFF').
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_link_color:
    put:
      description: |
        email link color
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_link_color
            properties:
              email_link_color:
                type: string
                example: "#006699"
                description: |
                  Enter a color name ('blue') or hex value ('#0000FF').
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_topic_featured_link_in_digest:
    put:
      description: |
        show topic featured link in digest
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_topic_featured_link_in_digest
            properties:
              show_topic_featured_link_in_digest:
                type: boolean
                example: false
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_custom_headers:
    put:
      description: |
        email custom headers
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_custom_headers
            properties:
              email_custom_headers:
                type: string
                example: 'Auto-Submitted: auto-generated'
                description: A pipe-delimited list of custom email headers
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_subject:
    put:
      description: |
        email subject
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_subject
            properties:
              email_subject:
                type: string
                example: '[%{site_name}] %{optional_pm}%{optional_cat}%{topic_title}'
                description: Customizable subject format for standard emails.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/reply_by_email_enabled:
    put:
      description: |
        reply by email enabled
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - reply_by_email_enabled
            properties:
              reply_by_email_enabled:
                type: boolean
                example: false
                description: `reply_by_email_address` needs to be set first
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/reply_by_email_address:
    put:
      description: |
        reply by email address
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - reply_by_email_address
            properties:
              reply_by_email_address:
                type: string
                example: '%{reply_key}@reply.example.com or replies+%{reply_key}@example.com'
                description: Template for reply by email incoming email address.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/alternative_reply_by_email_addresses:
    put:
      description: |
        alternative reply by email addresses
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - alternative_reply_by_email_addresses
            properties:
              alternative_reply_by_email_addresses:
                type: string
                example: '%{reply_key}@reply.example.com|replies+%{reply_key}@example.com'
                description: List of alternative templates for reply by email incoming email addresses.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/manual_polling_enabled:
    put:
      description: |
        manual polling enabled
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - manual_polling_enabled
            properties:
              manual_polling_enabled:
                type: boolean
                example: false
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_enabled:
    put:
      description: |
        pop3 polling enabled
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_enabled
            properties:
              pop3_polling_enabled:
                type: boolean
                example: false
                description: You must set a 'pop3 polling host' before enabling POP3 polling
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_ssl:
    put:
      description: |
        pop3 polling ssl
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_ssl
            properties:
              pop3_polling_ssl:
                type: boolean
                example: true
                description: Use SSL while connecting to the POP3 server
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_openssl_verify:
    put:
      description: |
        pop3 polling openssl verify
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_openssl_verify
            properties:
              pop3_polling_openssl_verify:
                type: boolean
                example: true
                description: Verify TLS server certificate
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_period_mins:
    put:
      description: |
        pop3 polling period mins
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_period_mins
            properties:
              pop3_polling_period_mins:
                type: integer
                example: 5
                description: |
                  "The period in minutes between checking the POP3 account for email. NOTE: requires restart."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_host:
    put:
      description: |
        pop3 polling host
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_host
            properties:
              pop3_polling_host:
                type: string
                description: The host to poll for email via POP3
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_port:
    put:
      description: |
        pop3 polling port
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_port
            properties:
              pop3_polling_port:
                type: integer
                example: 995
                description: The port to poll a POP3 account on
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_username:
    put:
      description: |
        pop3 polling username
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_username
            properties:
              pop3_polling_username:
                type: string
                description: The username for the POP3 account to poll for email.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/pop3_polling_password:
    put:
      description: |
        pop3 polling password
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - pop3_polling_password
            properties:
              pop3_polling_password:
                type: string
                description: The password for the POP3 account to poll for email.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/log_mail_processing_failures:
    put:
      description: |
        log mail processing failures
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - log_mail_processing_failures
            properties:
              log_mail_processing_failures:
                type: boolean
                description: Log all email processing failures to http://yoursite.com/logs
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/incoming_email_prefer_html:
    put:
      description: |
        incoming email prefer html
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - incoming_email_prefer_html
            properties:
              incoming_email_prefer_html:
                type: boolean
                description: |
                  Use the HTML instead of the text for incoming email. May cause unexpected formatting issues!
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_in:
    put:
      description: |
        email in
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_in
            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.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_in_min_trust:
    put:
      description: |
        email in min trust
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_in_min_trust
            properties:
              email_in_min_trust:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  The minimum trust level a user needs to have to be allowed to post new topics via email.
                example: 2
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_prefix:
    put:
      description: |
        email prefix
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_prefix
            properties:
              email_prefix:
                type: string
                description: |
                  "The [label] used in the subject of emails. It will default to 'title' if not set."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/email_site_title:
    put:
      description: |
        email site title
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - email_site_title
            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.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disable_emails:
    put:
      description: |
        disable emails
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disable_emails
            properties:
              disable_emails:
                type: boolean
                example: false
                description: |
                  Prevent Discourse from sending any kind of emails
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/strip_images_from_short_emails:
    put:
      description: |
        strip images from short emails
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - strip_images_from_short_emails
            properties:
              strip_images_from_short_emails:
                type: boolean
                example: true
                description: Strip images from emails having size less than 2800 Bytes
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/short_email_length:
    put:
      description: |
        short email length
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - short_email_length
            properties:
              short_email_length:
                type: integer
                example: 2800
                description: Short email length in Bytes
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/display_name_on_email_from:
    put:
      description: |
        display name on email from
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - display_name_on_email_from
            properties:
              display_name_on_email_from:
                type: boolean
                example: true
                description: |
                  Display full names on email from fields
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/unsubscribe_via_email:
    put:
      description: |
        unsubscribe via email
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - unsubscribe_via_email
            properties:
              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
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/unsubscribe_via_email_footer:
    put:
      description: |
        unsubscribe via email footer
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - unsubscribe_via_email_footer
            properties:
              unsubscribe_via_email_footer:
                type: boolean
                example: false
                description: 'Attach an unsubcribe via email mailto: link to the footer of sent email'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_email_logs_after_days:
    put:
      description: |
        delete email logs after days
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_email_logs_after_days
            properties:
              delete_email_logs_after_days:
                type: integer
                exampe: 365
                description: |
                  Delete email logs after (N) days. 0 to keep indefinitely
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_emails_per_day_per_user:
    put:
      description: |
        max emails per day per user
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_emails_per_day_per_user
            properties:
              max_emails_per_day_per_user:
                type: integer
                example: 100
                description: Maximum number of emails to send users per day. 0 to disable the limit
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_staged_users:
    put:
      description: |
        enable staged users
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_staged_users
            properties:
              enable_staged_users:
                type: boolean
                example: true
                description: Automatically create staged users when processing incoming emails.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/maximum_staged_users_per_email:
    put:
      description: |
        maximum staged users per email
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - maximum_staged_users_per_email
            properties:
              maximum_staged_users_per_email:
                type: integer
                example: 10
                description: Maximum number of staged users created when processing an incoming email.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_generated_whitelist:
    put:
      description: |
        auto generated whitelist
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_generated_whitelist
            properties:
              auto_generated_whitelist:
                type: string
                example: "foo@bar.com|discourse@bar.com"
                description: List of email addresses that won't be checked for auto-generated content.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/block_auto_generated_emails:
    put:
      description: |
        block auto generated emails
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - block_auto_generated_emails
            properties:
              block_auto_generated_emails:
                type: boolean
                example: true
                description: Block incoming emails identified as being auto generated.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/ignore_by_title:
    put:
      description: |
        ignore by title
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - ignore_by_title
            properties:
              ignore_by_title:
                type: string
                example: ""
                description: pipe delimited list
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/mailgun_api_key:
    put:
      description: |
        mailgun api key
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - mailgun_api_key
            properties:
              mailgun_api_key:
                type: string
                example: ""
                description: Mailgun Secret API key used to verify webhook messages.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/bounce_score_threshold:
    put:
      description: |
        bounce score threshold
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - bounce_score_threshold
            properties:
              bounce_score_threshold:
                type: integer
                example: 4
                description: Max bounce score before we will stop emailing a user.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/bounce_score_threshold_deactivate:
    put:
      description: |
        bounce score threshold deactive
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - bounce_score_threshold_deactivate
            properties:
              bounce_score_threshold_deactivate:
                type: integer
                example: 30
                description: Max bounce score before we will deactivate a user.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/soft_bounce_score:
    put:
      description: |
        soft bounce score
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - soft_bounce_score
            properties:
              soft_bounce_score:
                type: integer
                example: 1
                description: Bounce score added to the user when a temporary bounce happens.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/hard_bounce_score:
    put:
      description: |
        hard bounce score
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - hard_bounce_score
            properties:
              hard_bounce_score:
                type: integer
                example: 2
                description: Bounce score added to the user when a permanent bounce happens.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/reset_bounce_score_after_days:
    put:
      description: |
        reset bounce score after days
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - reset_bounce_score_after_days
            properties:
              reset_bounce_score_after_days:
                type: integer
                example: 31
                description: Automatically reset bounce score after X days.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/attachment_content_type_blacklist:
    put:
      description: |
        attachment content type blacklist
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - attachment_content_type_blacklist
            properties:
              attachment_content_type_blacklist:
                type: string
                example: "pkcs7|x-vcard"
                description: Pipe delimited list of keywords used to blacklist attachments based on the content type.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/attachment_filename_blacklist:
    put:
      description: |
        attachment filename blacklist
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - attachment_filename_blacklist
            properties:
              attachment_filename_blacklist:
                type: string
                example: "smime.p7s|signature.asc"
                description: Pipe delimited list of keywords used to blacklist attachments based on the filename.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_forwarded_emails:
    put:
      description: |
        enable forwarded emails
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_forwarded_emails
            properties:
              enable_forwarded_emails:
                type: boolean
                example: false
                description: '[BETA] Allow users to create a topic by forwarding an email in.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/always_show_trimmed_content:
    put:
      description: |
        always show trimmed content
      tags:
        - Site Settings Email
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - always_show_trimmed_content
            properties:
              always_show_trimmed_content:
                type: boolean
                example: false
                description: Always show trimmed part of incoming emails. WARNING: might reveal email addresses.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_image_size_kb:
    put:
      description: |
        max image size kb
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_image_size_kb
            properties:
              max_image_size_kb:
                type: integer
                example: 3072
                description: 'The maximum image upload size in kB. This must be configured in nginx {client_max_body_size} / apache or proxy as well.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_attachment_size_kb:
    put:
      description: |
        max attachment size kb
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_attachment_size_kb
            properties:
              max_image_size_kb:
                type: integer
                example: 3072
                description: 'The maximum attachment upload size in kB. This must be configured in nginx {client_max_body_size} / apache or proxy as well.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_image_megapixels:
    put:
      description: |
        max image megapixels
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_image_megapixels
            properties:
              max_image_megapixels:
                type: integer
                example: 40
                description: 'Maximum number of megapixels allowed for an image'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/authorized_extensions:
    put:
      description: |
        authorized extensions
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - authorized_extensions
            properties:
              authorized_extensions:
                type: string
                example: "jpg|jpeg|png|gif"
                description: 'A pipe delimited list of file extensions allowed for upload (use "*" to enable all file types)'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/crawl_images:
    put:
      description: |
        crawl images
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - crawl_images
            properties:
              crawl_images:
                type: boolean
                example: true
                description: 'Retrieve images from remote URLs to insert the correct width and height dimensions.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_image_width:
    put:
      description: |
        max image width
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_image_width
            properties:
              max_image_width:
                type: integer
                example: 690
                description: 'Maximum thumbnail width of images in a post'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_image_height:
    put:
      description: |
        max image height
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_image_height
            properties:
              max_image_height:
                type: integer
                example: 500
                description: 'Maximum thumbnail height of images in a post'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/download_remote_images_to_local:
    put:
      description: |
        download remote images to local
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - download_remote_images_to_local
            properties:
              max_image_width:
                type: boolean
                example: true
                description: 'Convert remote images to local images by downloading them; this prevents broken images.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/download_remote_images_threshold:
    put:
      description: |
        download remote images threshold
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - download_remote_images_threshold
            properties:
              download_remote_images_threshold:
                type: integer
                example: 10
                description: |
                  Minimum disk space necessary to download remote images locally (in percent)
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/download_remote_images_max_days_old:
    put:
      description: |
        download remote images max days old
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - download_remote_images_max_days_old
            properties:
              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.
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disabled_image_download_domains:
    put:
      description: |
        disabled image download domains
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disabled_image_download_domains
            properties:
              disabled_image_download_domains:
                type: string
                example: ""
                description: "Remote images will never be downloaded from these domains. Pipe-delimited list."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/create_thumbnails:
    put:
      description: |
        create thumbnails
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - create_thumbnails
            properties:
              create_thumbnails:
                type: boolean
                example: true
                description: |
                  "Create thumbnails and lightbox images that are too large to fit in a post"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/clean_up_uploads:
    put:
      description: |
        clean up uploads
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - clean_up_uploads
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/clean_orphan_uploads_grace_period_hours:
    put:
      description: |
        clean orphan uploads grace period hours
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - clean_orphan_uploads_grace_period_hours
            properties:
              clean_orphan_uploads_grace_period_hours:
                type: integer
                example: 48
                description: |
                  "Grace period (in hours) before an orphan upload is removed."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/purge_deleted_uploads_grace_period_days:
    put:
      description: |
        purge deleted uploads grace period days
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - purge_deleted_uploads_grace_period_days
            properties:
              purge_deleted_uploads_grace_period_days:
                type: integer
                example: 30
                description: |
                  "Grace period (in days) before a deleted upload is erased."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/prevent_anons_from_downloading_files:
    put:
      description: |
        prevent anons from downloading files
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - prevent_anons_from_downloading_files
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_s3_uploads:
    put:
      description: |
        enable s3 uploads
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_s3_uploads
            properties:
              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)."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_use_iam_profile:
    put:
      description: |
        s3 use iam profile
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_use_iam_profile
            properties:
              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.'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_access_key_id:
    put:
      description: |
        s3 access key id
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_access_key_id
            properties:
              s3_access_key_id:
                type: string
                example: ""
                description: |
                  "The Amazon S3 access key id that will be used to upload images."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_secret_access_key:
    put:
      description: |
        s3 secret access key
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_secret_access_key
            properties:
              s3_secret_access_key:
                type: string
                example: ""
                description: |
                  "The Amazon S3 secret access key that will be used to upload images."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_region:
    put:
      description: |
        s3 region
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_region
            properties:
              s3_region:
                type: string
                enum:
                  - ap-northeast-1
                  - ap-northeast-2
                  - ap-south-1
                  - ap-southeast-1
                  - ap-southeast-2
                  - cn-north-1
                  - eu-central-1
                  - eu-west-1
                  - sa-east-1
                  - us-east-1
                  - us-gov-west-1
                  - us-west-1
                  - us-west-2
                example: "us-west-2"
                description: |
                  "The Amazon S3 region name that will be used to upload images."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_upload_bucket:
    put:
      description: |
        s3 upload bucket
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_upload_bucket
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_cdn_url:
    put:
      description: |
        s3 cdn url
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_cdn_url
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_profile_backgrounds:
    put:
      description: |
        allow profile backgrounds
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_profile_backgrounds
            properties:
              allow_profile_backgrounds:
                type: boolean
                example: true
                description: |
                  "Allow users to upload profile backgrounds."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/automatically_download_gravatars:
    put:
      description: |
        automatically download gravatars
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - automatically_download_gravatars
            properties:
              automatically_download_gravatars:
                type: boolean
                example: true
                description: |
                  "Download Gravatars for users upon account creation or email change."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_uploaded_avatars:
    put:
      description: |
        allow uploaded avatars
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_uploaded_avatars
            properties:
              allow_uploaded_avatars:
                type: boolean
                example: true
                description: |
                  "Allow users to upload custom profile pictures."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_animated_avatars:
    put:
      description: |
        allow animated avatars
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_animated_avatars
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_animated_thumbnails:
    put:
      description: |
        allow animated thumbnails
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_animated_thumbnails
            properties:
              allow_animated_thumbnails:
                type: boolean
                example: true
                description: |
                  "Generate animated thumbnails of animated gifs."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_avatars:
    put:
      description: |
        default avatars
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_avatars
            properties:
              default_avatars:
                type: string
                example: ""
                description: |
                  "URLs to avatars that will be used by default for new users until they change them."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/avatar_sizes:
    put:
      description: |
        avatar sizes
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - avatar_sizes
            properties:
              avatar_sizes:
                type: string
                example: "20|25|32|45|60|120"
                description: |
                  "List of automatically generated avatar sizes."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/external_system_avatars_enabled:
    put:
      description: |
        external system avatars enabled
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - external_system_avatars_enabled
            properties:
              external_system_avatars_enabled:
                type: boolean
                example: true
                description: |
                  "Use external system avatars service."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/external_system_avatars_url:
    put:
      description: |
        external system avatars url
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - external_system_avatars_url
            properties:
              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}"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_all_attachments_for_group_messages:
    put:
      description: |
        allow all attachments for group messages
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_all_attachments_for_group_messages
            properties:
              allow_all_attachments_for_group_messages:
                type: boolean
                example: false
                description: |
                  "Allow all email attachments for group messages."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/convert_pasted_images_to_hq_jpg:
    put:
      description: |
        convert pasted images to hq jpg
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - convert_pasted_images_to_hq_jpg
            properties:
              convert_pasted_images_to_hq_jpg:
                type: boolean
                example: true
                description: |
                  "Convert pasted images to high-quality JPG files."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/convert_pasted_images_quality:
    put:
      description: |
        convert pasted images quality
      tags:
        - Site Settings Files
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - convert_pasted_images_quality
            properties:
              convert_pasted_images_quality:
                type: integer
                example: 95
                description: |
                  "Quality of the converted JPG file (1 is lowest quality, 100 is best quality)."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_trust_level:
    put:
      description: |
        default trust level
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_trust_level
            properties:
              default_trust_level:
                type: integer
                example: 0
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "Default trust level (0-4) for all new users. WARNING! Changing this will put you at serious risk for spam."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_invitee_trust_level:
    put:
      description: |
        default invitee trust level
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_invitee_trust_level
            properties:
              default_invitee_trust_level:
                type: integer
                example: 1
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "Default trust level (0-4) for invited users."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_create_topic:
    put:
      description: |
        min trust to create topic
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_create_topic
            properties:
              min_trust_to_create_topic:
                type: integer
                example: 0
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "The minimum trust level required to create a new topic"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_edit_wiki_post:
    put:
      description: |
        min trust to edit wiki post
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_edit_wiki_post
            properties:
              min_trust_to_edit_wiki_post:
                type: integer
                example: 1
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "The minimum trust level required to edit post marked as wiki."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_edit_post:
    put:
      description: |
        min trust to edit post
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_edit_post
            properties:
              min_trust_to_edit_post:
                type: integer
                example: 0
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "The minimum trust level required to edit posts."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_allow_self_wiki:
    put:
      description: |
        min trust to allow self wiki
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_allow_self_wiki
            properties:
              min_trust_to_allow_self_wiki:
                type: integer
                example: 3
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "The minimum trust level required to make user's own post wiki."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_send_messages:
    put:
      description: |
        min trust to send messages
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_send_messages
            properties:
              min_trust_to_send_messages:
                type: integer
                example: 0
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                description: |
                  "The minimum trust level required to create new private messages."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl1_requires_topics_entered:
    put:
      description: |
        tl1 requires topics entered
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl1_requires_topics_entered
            properties:
              tl1_requires_topics_entered:
                type: integer
                example: 5
                description: |
                  "How many topics a new user must enter before promotion to trust level 1."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl1_requires_read_posts:
    put:
      description: |
        tl1 requires read posts
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl1_requires_read_posts
            properties:
              tl1_requires_read_posts:
                type: integer
                example: 30
                description: |
                  "How many posts a new user must read before promotion to trust level 1."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl1_requires_time_spent_mins:
    put:
      description: |
        tl1 requires time spent mins
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl1_requires_time_spent_mins
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_topics_entered:
    put:
      description: |
        tl2 requires topics entered
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_topics_entered
            properties:
              tl2_requires_topics_entered:
                type: integer
                example: 20
                description: |
                  "How many topics a user must enter before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_read_posts:
    put:
      description: |
        tl2 requires read posts
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_read_posts
            properties:
              tl2_requires_read_posts:
                type: integer
                example: 100
                description: |
                  "How many posts a user must read before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_time_spent_mins:
    put:
      description: |
        tl2 requires time spent mins
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_time_spent_mins
            properties:
              tl2_requires_time_spent_mins:
                type: integer
                example: 60
                description: |
                  "How many minutes a user must read posts before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_days_visited:
    put:
      description: |
        tl2 requires days visited
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_days_visited
            properties:
              tl2_requires_days_visited:
                type: integer
                example: 15
                description: |
                  "How many days a user must visit the site before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_likes_received:
    put:
      description: |
        tl2 requires likes received
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_likes_received
            properties:
              tl2_requires_likes_received:
                type: integer
                example: 1
                description: |
                  "How many likes a user must receive before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_likes_given:
    put:
      description: |
        tl2 requires likes given
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_likes_given
            properties:
              tl2_requires_likes_given:
                type: integer
                example: 1
                description: |
                  "How many likes a user must cast before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_requires_topic_reply_count:
    put:
      description: |
        tl2 requires topic reply count
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_requires_topic_reply_count
            properties:
              tl2_requires_topic_reply_count:
                type: integer
                example: 3
                description: |
                  "How many topics user must reply to before promotion to trust level 2."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_time_period:
    put:
      description: |
        tl2 time period
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_time_period
            properties:
              tl3_time_period:
                type: integer
                example: 100
                description: |
                  "Trust Level 3 requirements time period (in days)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_days_visited:
    put:
      description: |
        tl3 requires days visited
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_days_visited
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_topics_replied_to:
    put:
      description: |
        tl3 requires topics replied to
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_topics_replied_to
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_topics_viewed:
    put:
      description: |
        tl3 requires topics viewed
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_topics_viewed
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_topics_viewed_cap:
    put:
      description: |
        tl3 requires topics viewed cap
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_topics_viewed_cap
            properties:
              tl3_requires_topics_viewed_cap:
                type: integer
                example: 500
                description: |
                  "The maximum required number of topics viewed in the last (tl3 time period) days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_posts_read:
    put:
      description: |
        tl3 requires posts read
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_posts_read
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_posts_read_cap:
    put:
      description: |
        tl3 requires posts read cap
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_posts_read_cap
            properties:
              tl3_requires_posts_read_cap:
                type: integer
                example: 20000
                description: |
                  "The maximum required number of posts read in the last (tl3 time period) days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_topics_viewed_all_time:
    put:
      description: |
        tl3 requires topics viewed all time
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_viewed_all_time
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_posts_read_all_time:
    put:
      description: |
        tl3 requires posts read all time
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_posts_read_all_time
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_max_flagged:
    put:
      description: |
        tl3 requires max flagged
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_max_flagged
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_promotion_min_duration:
    put:
      description: |
        tl3 promotion min duration
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_promotion_min_duration
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_likes_given:
    put:
      description: |
        tl3 requires likes given
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_likes_given
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_requires_likes_received:
    put:
      description: |
        tl3 requires likes received
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_requires_likes_received
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_links_no_follow:
    put:
      description: |
        tl3 links no follow
      tags:
        - Site Settings Trust Levels
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_links_no_follow
            properties:
              tl3_links_no_follow:
                type: boolean
                example: false
                description: |
                  "Do not remove rel=nofollow from links posted by trust level 3 users."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/force_https:
    put:
      description: |
        force https
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - force_https
            properties:
              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?"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_escaped_fragments:
    put:
      description: |
        enable escaped fragments
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_escaped_fragments
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_index_in_robots_txt:
    put:
      description: |
        allow index in robots txt
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_index_in_robots_txt
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_noscript_support:
    put:
      description: |
        enable noscript support
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_noscript_support
            properties:
              enable_noscript_support:
                type: boolean
                example: true
                description: |
                  "Enable standard webcrawler search engine support via the noscript tag"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_moderators_to_create_categories:
    put:
      description: |
        allow moderators to create categories
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_moderators_to_create_categories
            properties:
              allow_moderators_to_create_categories:
                type: boolean
                example: false
                description: |
                  "Allow moderators to create new categories"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/cors_origins:
    put:
      description: |
        cors origins
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - cors_origins
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/use_admin_ip_whitelist:
    put:
      description: |
        use admin ip whitelist
      tags:
        - Site Settings Security
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - use_admin_ip_whitelist
            properties:
              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)."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_flash_video_onebox:
    put:
      description: |
        enable flash video onebox
      tags:
        - Site Settings Onebox
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_flash_video_onebox
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/post_onebox_maxlength:
    put:
      description: |
        post onebox maxlength
      tags:
        - Site Settings Onebox
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - post_onebox_maxlength
            properties:
              post_onebox_maxlength:
                type: integer
                example: 500
                description: |
                  "Maximum length of a oneboxed Discourse post in characters."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/onebox_domains_blacklist:
    put:
      description: |
        onebox domains blacklist
      tags:
        - Site Settings Onebox
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - onebox_domains_blacklist
            properties:
              onebox_domains_blacklist:
                type: string
                example: ""
                description: |
                  "A list of domains that will never be oneboxed."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_oneboxes_per_post:
    put:
      description: |
        max oneboxes per post
      tags:
        - Site Settings Onebox
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_oneboxes_per_post
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/add_rel_nofollow_to_user_content:
    put:
      description: |
        add rel nofollow to user content
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - add_rel_nofollow_to_user_content
            properties:
              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"'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/flags_required_to_hide_post:
    put:
      description: |
        flags required to hide post
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - flags_required_to_hide_post
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/cooldown_minutes_after_hiding_posts:
    put:
      description: |
        cooldown minutes after hiding posts
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - cooldown_minutes_after_hiding_posts
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_spam_flags_to_block_new_user:
    put:
      description: |
        num spam flags to block new user
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_spam_flags_to_block_new_user
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_users_to_block_new_user:
    put:
      description: |
        num users to block new user
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_users_to_block_new_user
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_tl3_flags_to_block_new_user:
    put:
      description: |
        num tl3 flags to block new user
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_tl3_flags_to_block_new_user
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_tl3_users_to_block_new_user:
    put:
      description: |
        num tl3 users to block new user
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_tl3_users_to_block_new_user
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/notify_mods_when_user_blocked:
    put:
      description: |
        notify mods when user blocked
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - notify_mods_when_user_blocked
            properties:
              notify_mods_when_user_blocked:
                type: boolean
                example: false
                description: |
                  "If a user is automatically blocked, send a message to all moderators."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/flag_sockpuppets:
    put:
      description: |
        flag sockpuppets
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - flag_sockpuppets
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/newuser_spam_host_threshold:
    put:
      description: |
        newuser spam host threshold
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - newuser_spam_host_threshold
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/white_listed_spam_host_domains:
    put:
      description: |
        white listed spam host domains
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - white_listed_spam_host_domains
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/levenshtein_distance_spammer_emails:
    put:
      description: |
        levenshtein distance spammer emails
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - levenshtein_distance_spammer_emails
            properties:
              levenshtein_distance_spammer_emails:
                type: integer
                example: 2
                description: |
                  "When matching spammer emails, number of characters difference that will still allow a fuzzy match."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_new_accounts_per_registration_ip:
    put:
      description: |
        max new accounts per registration ip
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_new_accounts_per_registration_ip
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_ban_entries_for_roll_up:
    put:
      description: |
        min ban entries for roll up
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_ban_entries_for_roll_up
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_age_unmatched_emails:
    put:
      description: |
        max age unmatched emails
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_age_unmatched_emails
            properties:
              max_age_unmatched_emails:
                type: integer
                example: 365
                description: |
                  "Delete unmatched screened email entries after (N) days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_age_unmatched_ips:
    put:
      description: |
        max age unmatched ips
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_age_unmatched_ips
            properties:
              max_age_unmatched_ips:
                type: integer
                example: 365
                description: |
                  "Delete unmatched screened IP entries after (N) days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_flaggers_to_close_topic:
    put:
      description: |
        num flaggers to close topic
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_flaggers_to_close_topic
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/num_flags_to_close_topic:
    put:
      description: |
        num flags to close topic
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - num_flags_to_close_topic
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_respond_to_flag_actions:
    put:
      description: |
        auto respond to flag actions
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_respond_to_flag_actions
            properties:
              auto_respond_to_flag_actions:
                type: boolean
                example: true
                description: |
                  "Enable automatic reply when disposing a flag."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_first_post_typing_time:
    put:
      description: |
        min first post typing time
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_first_post_typing_time
            properties:
              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)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_block_fast_typers_on_first_post:
    put:
      description: |
        auto block fast typers on first post
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_block_fast_typers_on_first_post
            properties:
              auto_block_fast_typers_on_first_post:
                type: boolean
                example: true
                description: |
                  "Automatically block users that do not meet min_first_post_typing_time"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_block_fast_typers_max_trust_level:
    put:
      description: |
        auto black fast typers max trust level
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_block_fast_typers_max_trust_level
            properties:
              auto_block_fast_typers_max_trust_level:
                type: integer
                example: 0
                description: |
                  "Maximum trust level to auto block fast typers"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/auto_block_first_post_regex:
    put:
      description: |
        auto block first post regex
      tags:
        - Site Settings Spam
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - auto_block_first_post_regex
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/unique_posts_min:
    put:
      description: |
        unique posts mins
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - unique_posts_min
            properties:
              unique_posts_min:
                type: integer
                example: 5
                description: |
                  "How many minutes before a user can make a post with the same content again"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/rate_limit_create_topic:
    put:
      description: |
        rate limit create topic
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - rate_limit_create_topic
            properties:
              rate_limit_create_topic:
                type: integer
                example: 16
                description: |
                  "After creating a topic, users must wait (n) seconds before creating another topic."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/rate_limit_create_post:
    put:
      description: |
        rate limit create post
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - rate_limit_create_post
            properties:
              rate_limit_create_post:
                type: integer
                example: 5
                description: |
                  "After posting, users must wait (n) seconds before creating another post."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/rate_limit_new_user_create_topic:
    put:
      description: |
        rate limit new user create topic
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - rate_limit_new_user_create_topic
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/rate_limit_new_user_create_post:
    put:
      description: |
        rate limit new user create post
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - rate_limit_new_user_create_post
            properties:
              rate_limit_new_user_create_post:
                type: integer
                example: 30
                description: |
                  "After posting, new users must wait (n) seconds before creating another post."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_topics_per_day:
    put:
      description: |
        max topics per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_topics_per_day
            properties:
              max_topics_per_day:
                type: integer
                example: 20
                description: |
                  "Maximum number of topics a user can create per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_private_messages_per_day:
    put:
      description: |
        max private messages per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_private_messages_per_day
            properties:
              max_private_messages_per_day:
                type: integer
                example: 20
                description: |
                  "Maximum number of messages users can create per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_likes_per_day:
    put:
      description: |
        max likes per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_likes_per_day
            properties:
              max_likes_per_day:
                type: integer
                example: 50
                description: |
                  "Maximum number of likes per user per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_bookmarks_per_day:
    put:
      description: |
        max bookmarks per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_bookmarks_per_day
            properties:
              max_bookmarks_per_day:
                type: integer
                example:  20
                description: |
                  "Maximum number of bookmarks per user per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_flags_per_day:
    put:
      description: |
        max flags per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_flags_per_day
            properties:
              max_flags_per_day:
                type: integer
                example: 20
                description: |
                  "Maximum number of flags per user per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_edits_per_day:
    put:
      description: |
        max edits per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_edits_per_day
            properties:
              max_edits_per_day:
                type: integer
                example: 30
                description: |
                  "Maximum number of edits per user per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_invites_per_day:
    put:
      description: |
        max invites per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_invites_per_day
            properties:
              max_invites_per_day:
                type: integer
                example: 10
                description: |
                  "Maximum number of invites a user can send per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_topic_invitations_per_day:
    put:
      description: |
        max topic invitations per day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_topic_invitations_per_day
            properties:
              max_topic_invitations_per_day:
                type: integer
                example: 30
                description: |
                  "Maximum number of topic invitations a user can send per day."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_topics_in_first_day:
    put:
      description: |
        max topics in first day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_topics_in_first_day
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_replies_in_first_day:
    put:
      description: |
        max replies in first day
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_replies_in_first_day
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl2_additional_likes_per_day_multiplier:
    put:
      description: |
        tl2 additional likes per day multiplier
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl2_additional_likes_per_day_multiplier
            properties:
              tl2_additional_likes_per_day_multiplier:
                type: decimal
                example: 1.5
                description: |
                  "Increase limit of likes per day for tl2 (member) by multiplying with this number"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl3_additional_likes_per_day_multiplier:
    put:
      description: |
        tl3 additional likes per day multiplier
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl3_additional_likes_per_day_multiplier
            properties:
              tl3_additional_likes_per_day_multiplier:
                type: decimal
                example: 2
                description: |
                  "Increase limit of likes per day for tl3 (regular) by multiplying with this number"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tl4_additional_likes_per_day_multiplier:
    put:
      description: |
        tl4 additional likes per day multiplier
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tl4_additional_likes_per_day_multiplier
            properties:
              tl4_additional_likes_per_day_multiplier:
                type: decimal
                example: 3
                description: |
                  "Increase limit of likes per day for tl4 (leader) by multiplying with this number"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/alert_admins_if_errors_per_minute:
    put:
      description: |
        alert admins if errors per minute
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - alert_admins_if_errors_per_minute
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/alert_admins_if_errors_per_hour:
    put:
      description: |
        alert admins if errors per hour
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - alert_admins_if_errors_per_hour
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_prints_per_hour_per_user:
    put:
      description: |
        max prints per hour per user
      tags:
        - Site Settings Rate Limits
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_prints_per_hour_per_user
            properties:
              max_prints_per_hour_per_user:
                type: integer
                example: 5
                description: |
                  "Maximum number of /print page impressions (set to 0 to disable)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/force_hostname:
    put:
      description: |
        force hostname
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - force_hostname
            properties:
              force_hostname:
                type: string
                example: ""
                description: |
                  "DEVELOPER ONLY! WARNING! Specify a hostname in the URL. Leave blank for default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/port:
    put:
      description: |
        port
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - port
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/queue_jobs:
    put:
      description: |
        queue jobs
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - queue jobs
            properties:
              port:
                type: boolean
                example: true
                description: |
                  "DEVELOPER ONLY! WARNING! By default, queue jobs in sidekiq. If disabled, your site will be broken."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_long_polling:
    put:
      description: |
        enable long polling
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_long_polling
            properties:
              enable_long_polling:
                type: boolean
                example: true
                description: |
                  "Message bus used for notification can use long polling"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/long_polling_interval:
    put:
      description: |
        long polling interval
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - long_polling_interval
            properties:
              long_polling_interval:
                type: integer
                example: true
                description: |
                  "Amount of time the server should wait before responding to clients when there is no data to send (logged on users only)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/long_polling_base_url:
    put:
      description: |
        long polling base url
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - long_polling_base_url
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/background_polling_interval:
    put:
      description: |
        background polling interval
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - background_polling_interval
            properties:
              background_polling_interval:
                type: integer
                example: 60000
                description: |
                  "How often should the clients poll in milliseconds (when the window is in the background)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/polling_interval:
    put:
      description: |
        polling interval
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - polling_interval
            properties:
              polling_interval:
                type: integer
                example: 3000
                description: |
                  "When not long polling, how often should logged on clients poll in milliseconds"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/anon_polling_interval:
    put:
      description: |
        anon polling interval
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - anon_polling_interval
            properties:
              anon_polling_interval:
                type: integer
                example: 15000
                description: |
                  "How often should anonymous clients poll in milliseconds"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/flush_timings_secs:
    put:
      description: |
        flush timings secs
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - flush_timings_secs
            properties:
              flush_timings_secs:
                type: integer
                example: 20
                description: |
                  "How frequently we flush timing data to the server, in seconds."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/active_user_rate_limit_secs:
    put:
      description: |
        active user rate limit secs
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - active_user_rate_limit_secs
            properties:
              active_user_rate_limit_secs:
                type: integer
                example: 60
                description: |
                  "How frequently we update the 'last_seen_at' field, in seconds"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/verbose_localization:
    put:
      description: |
        verbose localization
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - verbose_localization
            properties:
              verbose_localization:
                type: boolean
                example: false
                description: |
                  "Show extended localization tips in the UI"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/top_topics_formula_log_views_multiplier:
    put:
      description: |
        top topics formula log views multiplier
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - top_topics_formula_log_views_multiplier
            properties:
              top_topics_formula_log_views_multiplier:
                type: decimal
                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)`"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/top_topics_formula_first_post_likes_multiplier:
    put:
      description: |
        top topics formula first post likes multiplier
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - top_topics_formula_first_post_likes_multiplier
            properties:
              top_topics_formula_first_post_likes_multiplier:
                type: decimal
                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)`"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/top_topics_formula_first_post_likes_multiplier:
    put:
      description: |
        top topics formula first post likes multiplier
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - top_topics_formula_first_post_likes_multiplier
            properties:
              top_topics_formula_first_post_likes_multiplier:
                type: decimal
                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)`"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/rebake_old_posts_count:
    put:
      description: |
        rebake old posts count
      tags:
        - Site Settings Developer
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - rebake_old_posts_count
            properties:
              rebake_old_posts_count:
                type: integer
                example: 250
                description: |
                  "Number of old posts to be rebaked every 15 minutes."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tos_url:
    put:
      description: |
        tos url
      tags:
        - Site Settings Legal
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tos_url
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/privacy_policy_url:
    put:
      description: |
        privacy policy url
      tags:
        - Site Settings Legal
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - privacy_policy_url
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/fag_url:
    put:
      description: |
        faq url
      tags:
        - Site Settings Legal
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - faq_url
            properties:
              faq_url:
                type: string
                example: ""
                description: |
                  "If you have a FAQ hosted elsewhere that you want to use, provide the full URL here."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/readonly_mode_during_backup:
    put:
      description: |
        readonly_mode_during_backup
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - readonly_mode_during_backup
            properties:
              readonly_mode_during_backup:
                type: boolean
                example: true
                description: |
                  "Enable read only mode while taking a backup"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_restore:
    put:
      description: |
        allow_restore
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_restore
            properties:
              allow_restore:
                type: boolean
                example: false
                description: |
                  "Allow restore, which can replace ALL site data! Leave false unless you plan to restore a backup"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/maximum_backups:
    put:
      description: |
        maximum backups
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - maximum_backups
            properties:
              maximum_backups:
                type: integer
                example: 5
                description: |
                  "The maximum amount of backups to keep on disk. Older backups are automatically deleted"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/automatic_backups_enabled:
    put:
      description: |
        automatic backups enabled
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - automatic_backups_enabled
            properties:
              automatic_backups_enabled:
                type: boolean
                example: true
                description: |
                  "Run automatic backups as defined in backup frequency"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/backup_frequency:
    put:
      description: |
        backup frequency
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - backup_frequency
            properties:
              backup_frequency:
                type: integer
                example: 7
                description: |
                  "How frequently we create a site backup, in days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/enable_s3_backups:
    put:
      description: |
        enable s3 backups
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - enable_s3_backups
            properties:
              enable_s3_backups:
                type: boolean
                example: false
                description: |
                  "Upload backups to S3 when complete. IMPORTANT: requires valid S3 credentials entered in Files settings."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_backup_bucket:
    put:
      description: |
        s3 backup bucket
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_backup_bucket
            properties:
              s3_backup_bucket:
                type: string
                example: ""
                description: |
                  "The remote bucket to hold backups. WARNING: Make sure it is a private bucket."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/s3_disable_cleanup:
    put:
      description: |
        s3 disable cleanup
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - s3_disable_cleanup
            properties:
              s3_disable_cleanup:
                type: boolean
                example: false
                description: |
                  "Disable the removal of backups from S3 when removed locally."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/backup_time_of_day:
    put:
      description: |
        backup time of day
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - backup_time_of_day
            properties:
              backup_time_of_day:
                type: string
                example: "3:30"
                description: |
                  "Time of day UTC when the backup should occur."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/backup_with_uploads:
    put:
      description: |
        backup with uploads
      tags:
        - Site Settings Backups
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - backup_with_uploads
            properties:
              backup_with_uploads:
                type: boolean
                example: true
                description: |
                  "Include uploads in scheduled backups. Disabling this will only backup the database."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_search_term_length:
    put:
      description: |
        min search term length
      tags:
        - Site Settings Search
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_search_term_length
            properties:
              min_search_term_length:
                type: integer
                example: 3
                description: |
                  "Minimum valid search term length in characters"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/search_tokenize_chinese_japanese_korean:
    put:
      description: |
        search tokenize chinese japanese korean
      tags:
        - Site Settings Search
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - search_tokenize_chinese_japanese_korean
            properties:
              search_tokenize_chinese_japanese_korean:
                type: boolean
                example: false
                description: |
                  "Force search to tokenize Chinese/Japanese/Korean even on non CJK sites"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/search_prefer_recent_posts:
    put:
      description: |
        search prefer recent posts
      tags:
        - Site Settings Search
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - search_prefer_recent_posts
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/search_recent_posts_size:
    put:
      description: |
        search recent posts size
      tags:
        - Site Settings Search
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - search_recent_posts_size
            properties:
              search_recent_posts_size:
                type: integer
                example: 100000
                description: |
                  "How many recent posts to keep in the index"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/version_checks:
    put:
      description: |
        version checks
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - version_checks
            properties:
              version_checks:
                type: boolean
                example: true
                description: |
                  "Ping the Discourse Hub for version updates and show new version messages on the /admin dashboard"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/new_version_emails:
    put:
      description: |
        new version emails
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - new_version_emails
            properties:
              new_version_emails:
                type: boolean
                example: true
                description: |
                  "Send an email to the contact_email address when a new version of Discourse is available."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/send_welcome_message:
    put:
      description: |
        send welcome message
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - send_welcome_message
            properties:
              send_welcome_message:
                type: boolean
                example: true
                description: |
                  "Send all new users a welcome message with a quick start guide."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suppress_uncategorized_badge:
    put:
      description: |
        suppress uncategorized badge
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suppress_uncategorized_badge
            properties:
              suppress_uncategorized_badge:
                type: boolean
                example: true
                description: |
                  "Don't show the badge for uncategorized topics in topic lists."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/slug_generation_method:
    put:
      description: |
        slug generation method
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - slug_generation_method
            properties:
              slug_generation_method:
                type: string
                enum:
                  - ascii
                  - enocded
                  - none
                example: "ascii"
                description: |
                  "Choose a slug generation method. 'encoded' will generate percent encoding string. 'none' will disable slug at all."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/permalink_normalizations:
    put:
      description: |
        permalink normalizations
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - permalink_normalizations
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_similar_results:
    put:
      description: |
        max similar results
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_similar_results
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/minimum_topics_similar:
    put:
      description: |
        minimum topics similar
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - minimum_topics_similar
            properties:
              minimum_topics_similar:
                type: integer
                example: 50
                description: |
                  "How many topics need to exist before similar topics are presented when composing new topics."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/previous_visit_timeout_hours:
    put:
      description: |
        previous visit timeout hours
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - previous_visit_timeout_hours
            properties:
              previous_visit_timeout_hours:
                type: integer
                example: 1
                description: |
                  "How long a visit lasts before we consider it the 'previous' visit, in hours"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/staff_like_weight:
    put:
      description: |
        staff like weight
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - staff_like_weight
            properties:
              staff_like_weight:
                type: integer
                example: 3
                description: |
                  "How much extra weighting factor to give staff likes."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_view_duration_hours:
    put:
      description: |
        topic view duration hours
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_view_duration_hours
            properties:
              topic_view_duration_hours:
                type: integer
                example: 8
                description: |
                  "Count a new topic view once per IP/User every N hours"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/user_profile_view_duration_hours:
    put:
      description: |
        user profile view duration hours
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - user_profile_view_duration_hours
            properties:
              user_profile_view_duration_hours:
                type: integer
                example: 8
                description: |
                  "Count a new user profile view once per IP/User every N hours"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/summary_score_threshold:
    put:
      description: |
        summary score threshold
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - summary_score_threshold
            properties:
              summary_score_threshold:
                type: integer
                example: 15
                description: |
                  "The minimum score required for a post to be included in 'Summarize This Topic'"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/summary_posts_required:
    put:
      description: |
        summary posts required
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - summary_posts_required
            properties:
              summary_posts_required:
                type: integer
                example: 50
                description: |
                  "Minimum posts in a topic before 'Summarize This Topic' is enabled"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/summary_likes_required:
    put:
      description: |
        summary likes required
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - summary_likes_required
            properties:
              summary_likes_required:
                type: integer
                example: 1
                description: |
                  "Minimum likes in a topic before 'Summarize This Topic' is enabled"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/summary_percent_filter:
    put:
      description: |
        summary percent filter
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - summary_percent_filter
            properties:
              summary_percent_filter:
                type: integer
                example: 20
                description: |
                  "When a user clicks 'Summarize This Topic', show the top % of posts"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/summary_max_results:
    put:
      description: |
        summary max results
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - summary_max_results
            properties:
              summary_max_results:
                type: integer
                example: 100
                description: |
                  "Maximum posts returned by 'Summary This Topic'"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_views_heat_low:
    put:
      description: |
        topic views heat low
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_view_heat_low
            properties:
              topic_view_heat_low:
                type: integer
                example: 1000
                description: |
                  "After this many views, the views field is slightly highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_views_heat_medium:
    put:
      description: |
        topic views heat medium
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_views_heat_medium
            properties:
              topic_views_heat_medium:
                type: integer
                example: 2000
                description: |
                  "After this many views, the views field is moderately highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_views_heat_high:
    put:
      description: |
        topic views heat high
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_views_heat_high
            properties:
              topic_views_heat_high:
                type: integer
                example: 5000
                description: |
                  "After this many views, the views field is strongly highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_post_like_heat_low:
    put:
      description: |
        topic post like heat low
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_post_like_heat_low
            properties:
              topic_post_like_heat_low:
                type: decimal
                example: 0.5
                description: |
                  "After the likes:post ratio exceeds this ratio, the post count field is slightly highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_post_like_heat_medium:
    put:
      description: |
        topic post like heat medium
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_post_like_heat_medium
            properties:
              topic_post_like_heat_medium:
                type: decimal
                example: 1.0
                description: |
                  "After the likes:post ratio exceeds this ratio, the post count field is moderately highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_post_like_heat_high:
    put:
      description: |
        topic post like heat high
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_post_like_heat_high
            properties:
              topic_post_like_heat_high:
                type: decimal
                example: 2.0
                description: |
                  "After the likes:post ratio exceeds this ratio, the post count field is strongly highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/history_hours_low:
    put:
      description: |
        history hours low
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - history_hours_low
            properties:
              history_hours_low:
                type: integer
                example: 12
                description: |
                  "A post edited within this many hours has the edit indicator slightly highlighted"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/history_hours_medium:
    put:
      description: |
        history hours medium
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - history_hours_medium
            properties:
              history_hours_medium:
                type: integer
                example: 24
                description: |
                  "A post edited within this many hours has the edit indicator moderately highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/history_hours_high:
    put:
      description: |
        history hours high
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - history_hours_high
            properties:
              history_hours_high:
                type: integer
                example: 48
                description: |
                  "A post edited within this many hours has the edit indicator strongly highlighted."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/cold_age_days_low:
    put:
      description: |
        cold age days low
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - cold_age_days_low
            properties:
              cold_age_days_low:
                type: integer
                example: 14
                description: |
                  "After this many days of conversation, the last activity date is slightly dimmed."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/cold_age_days_medium:
    put:
      description: |
        cold age days medium
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - cold_age_days_medium
            properties:
              cold_age_days_medium:
                type: integer
                example: 90
                description: |
                  "After this many days of conversation, the last activity date is moderately dimmed."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/cold_age_days_high:
    put:
      description: |
        cold age days high
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - cold_age_days_high
            properties:
              cold_age_days_high:
                type: integer
                example: 180
                description: |
                  "After this many days of conversation, the last activity date is strongly dimmed."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/educate_until_posts:
    put:
      description: |
        educate until posts
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - educate_until_posts
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/sequential_replies_threshold:
    put:
      description: |
        sequential replies threshold
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - sequential_replies_threshold
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/dominating_topic_minimum_percent:
    put:
      description: |
        dominating topic minimum percent
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - dominating_topic_minimum_percent
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disable_avatar_education_message:
    put:
      description: |
        disable avatar education message
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disable_avatar_education_message
            properties:
              disable_avatar_education_message:
                type: boolean
                example: false
                description: |
                  "Disable education message for changing avatar."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/global_notice:
    put:
      description: |
        global notice
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - global_notice
            properties:
              global_notice:
                type: string
                example: ""
                description: |
                  "Display an URGENT, EMERGENCY global banner notice to all visitors, change to blank to hide it (HTML allowed)."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/notify_about_flags_after:
    put:
      description: |
        notify about flags after
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - notify_about_flags_after
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_create_topics_notice:
    put:
      description: |
        show create topics notice
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_create_topics_notice
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disable_edit_notifications:
    put:
      description: |
        disable edit notifications
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disable_edit_notifications
            properties:
              disable_edit_notifications:
                type: boolean
                example: false
                description: |
                  "Disables edit notifications by the system user when 'download_remote_images_to_local' is active."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/vacuum_db_days:
    put:
      description: |
        vacuum db days
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - vacuum_db_days
            properties:
              vacuum_db_days:
                type: integer
                example: 90
                description: |
                  "Run VACUUM ANALYZE to reclaim DB space after migrations (set to 0 to disable)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/delete_drafts_older_than_n_days:
    put:
      description: |
        delete drafts older than n days
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - delete_drafts_older_than_n_days
            properties:
              delete_drafts_older_than_n_days:
                type: integer
                example: 180
                description: |
                  "Delete drafts older than (n) days."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/bootstrap_mode_min_users:
    put:
      description: |
        bootstrap mode min users
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - bootstrap_mode_min_users
            properties:
              bootstrap_mode_min_users:
                type: integer
                example: 50
                description: |
                  "Minimum number of users required to disable bootstrap mode (set to 0 to disable)"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/automatically_unpin_topics:
    put:
      description: |
        automatically unpin topics
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - automatically_unpin_topics
            properties:
              automatically_unpin_topics:
                type: boolean
                example: true
                description: |
                  "Automatically unpin topics when the user reaches the bottom."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/read_time_word_count:
    put:
      description: |
        read time word count
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - read_time_word_count
            properties:
              read_time_word_count:
                type: integer
                example: 500
                description: |
                  "Word count per minute for calculating estimated reading time."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/topic_page_title_includes_category:
    put:
      description: |
        topic page title includes category
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - topic_page_title_includes_category
            properties:
              topic_page_title_includes_category:
                type: boolean
                example: true
                description: |
                  "Topic page title includes the category name."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/native_app_install_banner:
    put:
      description: |
        "native app install banner"
      tags:
        - Site Settings Other
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - native_app_install_banner
            properties:
              native_app_install_banner:
                type: boolean
                example: false
                description: |
                  "Asks recurring visitors to install Discourse native app."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_digest_frequency:
    put:
      description: |
        "default email digest frequency"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_digest_frequency
            properties:
              default_email_digest_frequency:
                type: integer
                example: 0
                description: |
                  "How often users receive summary emails by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_include_tl0_in_digests:
    put:
      description: |
        "default include tl0 in digests"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_include_tl0_in_digests
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_private_messages:
    put:
      description: |
        "default email private messages"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_private_messages
            properties:
              default_email_private_messages:
                type: boolean
                example: true
                description: |
                  "Send an email when someone messages the user by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_direct:
    put:
      description: |
        "default email direct"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_direct
            properties:
              default_email_direct:
                type: boolean
                example: true
                description: |
                  "Send an email when someone quotes/replies to/mentions or invites the user by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_mailing_list_mode:
    put:
      description: |
        "default email mailing list mode"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_mailing_list_mode
            properties:
              default_email_mailing_list_mode:
                type: boolean
                example: false
                description: |
                  "Send an email for every new post by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_mailing_list_mode_frequency:
    put:
      description: |
        "default email mailing list mode frequency"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_mailing_list_mode_frequency
            properties:
              default_email_mailing_list_mode_frequency:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                example: 0
                description: |
                  "Users who enable mailing list mode will receive emails this often by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/disable_mailing_list_mode:
    put:
      description: |
        "disable mailing list mode"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - disable_mailing_list_mode
            properties:
              disable_mailing_list_mode:
                type: boolean
                example: false
                description: |
                  "Disallow users from enabling mailing list mode."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_always:
    put:
      description: |
        "default email always"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_always
            properties:
              default_email_always:
                type: boolean
                example: false
                description: |
                  "Send an email notification even when the user is active by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_previous_replies:
    put:
      description: |
        "default email previous replies"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_previous_replies
            properties:
              default_email_previous_replies:
                type: integer
                example: 2
                description: |
                  "Include previous replies in emails by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_email_in_reply_to:
    put:
      description: |
        "default email in reply to"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_email_in_reply_to
            properties:
              default_email_in_reply_to:
                type: boolean
                example: true
                description: |
                  "Include excerpt of replied to post in emails by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_new_topic_duration_minutes:
    put:
      description: |
        "default other new topic duration minutes"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_new_topic_duration_minutes
            properties:
              default_other_new_topic_duration_minutes:
                type: integer
                example: 2880
                description: |
                  "Global default condition for which a topic is considered new."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_auto_track_topic_after_msecs:
    put:
      description: |
        "default other auto track topics after msecs"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_auto_track_topic_after_msecs
            properties:
              default_other_auto_track_topic_after_msecs:
                type: integer
                example: 240000
                description: |
                  "Global default time before a topic is automatically tracked."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_notification_level_when_replying:
    put:
      description: |
        "default other notification level when replying"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_notification_level_when_replying
            properties:
              default_other_notification_level_when_replying:
                type: integer
                example: 2
                description: |
                  "Global default notification level when the user replies to a topic."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_external_links_in_new_tab:
    put:
      description: |
        "default other external links in new tab"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_external_links_in_new_tab
            properties:
              default_other_external_links_in_new_tab:
                type: boolean
                example: false
                description: |
                  "Open external links in a new tab by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_enable_quoting:
    put:
      description: |
        "default other enable quoting"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_enable_quoting
            properties:
              default_other_enable_quoting:
                type: boolean
                example: true
                description: |
                  "Enable quote reply for highlighted text by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_dynamic_favicon:
    put:
      description: |
        default other dynamic favicon
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_dynamic_favicon
            properties:
              default_other_dynamic_favicon:
                type: boolean
                example: false
                description: |
                  "Show new/updated topic count on browser icon by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_disable_jump_reply:
    put:
      description: |
        "default other disable jump reply"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_disable_jump_reply
            properties:
              default_other_disable_jump_reply:
                type: boolean
                example: false
                description: |
                  "Don't jump to user's post after they reply by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_other_like_notification_frequency:
    put:
      description: |
        "default other like notification frequency"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_other_like_notification_frequency
            properties:
              default_other_like_notification_frequency:
                type: integer
                example: 1
                description: |
                  "Notify users on likes by default"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_topics_automatic_unpin:
    put:
      description: |
        "default topics automatic unpin"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_topics_automatic_unpin
            properties:
              default_topics_automatic_unpin:
                type: boolean
                example: true
                description: |
                  "Automatically unpin topics when the user reaches the bottom by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_categories_watching:
      description: |
        "default categories watching"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_categories_watching
            properties:
              default_categories_watching:
                type: string
                example: "4|1"
                description: |
                  "Pipe delimited category id's. List of categories that are watched by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_categories_tracking:
    put:
      description: |
        "default categories tracking"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_categories_tracking
            properties:
              default_categories_tracking:
                type: string
                example: ""
                description: |
                  "Pipe delimited category id's. List of categories that are tracked by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_categories_muted:
    put:
      description: |
        "default categories muted"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_categories_muted
            properties:
              default_categories_muted:
                type: string
                example: ""
                description: |
                  "Pipe delimited category id's. List of categories that are muted by default."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/default_categories_watching_first_post:
    put:
      description: |
        "default categories watching first post"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - default_categories_watching_first_post
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_user_api_reqs_per_day:
    put:
      description: |
        "max user api reqs per day"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_user_api_reqs_per_day
            properties:
              max_user_api_reqs_per_day:
                type: integer
                example: 2880
                description: |
                  "Maximum number of user API requests per key per day"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_user_api_reqs_per_minute:
    put:
      description: |
        "max user api reqs per minute"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_user_api_reqs_per_minute
            properties:
              max_user_api_reqs_per_minute:
                type: integer
                example: 20
                description: |
                  "Maximum number of user API requests per key per minute"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_user_api_keys:
    put:
      description: |
        "allow user api keys"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_user_api_keys
            properties:
              allow_user_api_keys:
                type: boolean
                example: true
                description: |
                  "Allow generation of user API keys"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allow_user_api_key_scopes:
    put:
      description: |
        "allow user api key scopes"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allow_user_api_key_scopes
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_api_keys_per_user:
    put:
      description: |
        "max api keys per user"
      tags:
        - Site Settings User Preferences
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_api_keys_per_user
            properties:
              max_api_keys_per_user:
                type: integer
                example: 10
                description: |
                  "Maximum number of user API keys per user"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_level_for_user_api_key:
    put:
      description: |
        "min trust level for user api key"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_level_for_user_api_key
            properties:
              min_trust_level_for_user_api_key:
                type: integer
                example: 1
                description: |
                  "Trust level required for generation of user API keys"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allowed_user_api_push_urls:
    put:
      description: |
        "allowed user api push urls"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allowed_user_api_push_urls
            properties:
              allowed_user_api_push_urls:
                type: string
                example: ""
                description: |
                  "Allowed URLs for server push to user API"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/allowed_user_api_auth_redirects:
    put:
      description: |
        "allowed user api auth redirects"
      tags:
        - Site Settings User API
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - allowed_user_api_auth_redirects
            properties:
              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"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tagging_enabled:
    put:
      description: |
        "tagging enabled"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tagging_enabled
            properties:
              tagging_enabled:
                type: boolean
                example: false
                description: |
                  "Enable tags on topics?"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tag_style:
    put:
      description: |
        "tag style"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tag_style
            properties:
              tag_style:
                type: string
                enum:
                  - simple
                  - bullet
                  - box
                example: simple
                description: |
                  "Visual style for tag badges."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_tags_per_topic:
    put:
      description: |
        "max tags per topic"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_tags_per_topic
            properties:
              max_tags_per_topic:
                type: integer
                example: 5
                description: |
                  "The maximum tags that can be applied to a topic."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_tag_length:
    put:
      description: |
        "max tag length"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_tag_length
            properties:
              max_tag_length:
                type: integer
                example: 20
                description: |
                  "The maximum amount of characters that can be used in a tag."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_to_create_tag:
    put:
      description: |
        "min trust to create tag"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_to_create_tag
            properties:
              tagging_enabled:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                example: 3
                description: |
                  "The minimum trust level required to create a tag."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/min_trust_level_to_tag_topics:
    put:
      description: |
        "min trust level to tag topics"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - min_trust_level_to_tag_topics
            properties:
              min_trust_level_to_tag_topics:
                type: integer
                enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  - 4
                example: 0
                description: |
                  "Minimum trust level required to tag topics"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_tag_search_results:
    put:
      description: |
        "max_tag_search_results"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_tag_search_results
            properties:
              max_tag_search_results:
                type: integer
                example: 5
                description: |
                  "When searching for tags, the maximum number of results to show."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/show_filter_by_tag:
    put:
      description: |
        "show filter by tag"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - show_filter_by_tag
            properties:
              show_filter_by_tag:
                type: boolean
                example: false
                description: |
                  "Show a dropdown to filter a topic list by tag."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/max_tags_in_filter_list:
    put:
      description: |
        "max tags in filter list"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - max_tags_in_filter_list
            properties:
              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."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/tags_sort_alphabetically:
    put:
      description: |
        "tags sort alphabetically"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - tags_sort_alphabetically
            properties:
              tags_sort_alphabetically:
                type: boolean
                example: false
                description: |
                  "Show tags in alphabetical order. Default is to show in order of popularity."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/staff_tags:
    put:
      description: |
        "staff tags"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - staff_tags
            properties:
              staff_tags:
                type: string
                example: ""
                description: |
                  "A list of tags that can only be applied by staff members"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/suppress_overlapping_tags_in_list:
    put:
      description: |
        "suppress overlapping tags in list"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - suppress_overlapping_tags_in_list
            properties:
              suppress_overlapping_tags_in_list:
                type: boolean
                example: false
                description: |
                  "If tags match exact words in topic titles, don't show the tag"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/remove_muted_tags_from_latest:
    put:
      description: |
        "remove muted tags from latest"
      tags:
        - Site Settings Tags
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - remove_muted_tags_from_latest
            properties:
              remove_muted_tags_from_latest:
                type: boolean
                example: false
                description: |
                  "Don't show topics tagged with muted tags in the latest topic list."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/details_enabled:
    put:
      description: |
        "details enabled"
      tags:
        - Site Settings Plugins
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - details_enabled
            properties:
              details_enabled:
                type: boolean
                example: true
                description: |
                  'Enable the details plugin. If you change this, you must rebake all posts with: "rake posts:rebake".'
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/daily_performance_report:
    put:
      description: |
        "daily performance report"
      tags:
        - Site Settings Plugins
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - daily_performance_report
            properties:
              daily_performance_report:
                type: boolean
                example: false
                description: |
                  "Analyze NGINX logs daily and post a Staff Only topic with details"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/poll_enabled:
    put:
      description: |
        "poll enabled"
      tags:
        - Site Settings Plugins
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - poll_enabled
            properties:
              poll_enabled:
                type: boolean
                example: true
                description: |
                  "Allow users to create polls?"
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/poll_maximum_options:
    put:
      description: |
        "poll maximum options"
      tags:
        - Site Settings Plugins
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - poll_maximum_options
            properties:
              poll_maximum_options:
                type: integer
                example: 20
                description: |
                  "Maximum number of options allowed in a poll."
      responses:
        '200':
          description: |
            empty response body
  /admin/site_settings/poll_edit_window_mins:
    put:
      description: |
        poll edit window mins
      tags:
        - Site Settings Plugins
      parameters:
        - name: body
          in: body
          schema:
            type: object
            required:
              - poll_edit_window_mins
            properties:
              poll_edit_window_mins:
                type: integer
                example: 5
                description: |
                  Number of minutes after post creation during which polls can be edited.
      responses:
        '200':
          description: |
            empty response body
  /admin/plugins:
    get:
      description: |
        get a list of installed plugins
      tags:
        - Plugins
      responses:
        '200':
          description: |
            plugin list response
          schema:
            type: object
            properties:
              plugins:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                    version:
                      type: string
                    url:
                      type: string
                    enabled:
                      type: boolean
                    enabled_setting:
                      type: string
  /admin/backups.json:
    get:
      description: |
        get a list of backups
      tags:
        - Backups
      responses:
        200:
          description: |
            list of backups response
          schema:
            type: array
            items:
              type: object
              properties:
                filename:
                  type: string
                size:
                  type: integer
                link:
                  type: string
  /admin/emails/{action}.json:
    get:
      description: |
        get a list of emails
      tags:
        - Emails
      parameters:
        - name: action
          in: path
          required: true
          example: sent
          type: string
          enum:
            - sent
            - skipped
            - bounced
            - received
            - rejected
        - name: offset
          in: path
          required: true
          example: 0
          type: integer
      responses:
        '200':
          description: |
            list of emails response
          schema:
            type: array
            items:
              type: object
              properties:
                id:
                  type: integer
                reply_key:
                  type: string
                to_address:
                  type: string
                email_type:
                  type: string
                user_id:
                  type: integer
                created_at:
                  type: string
                skipped:
                  type: boolean
                  example: false
                bounced:
                  type: boolean
                  example: false
                user:
                  type: object
  /admin/flags/{type}.json:
    get:
      description: |
        get a list of flags
      tags:
        - Flags
      parameters:
        - name: type
          in: path
          required: true
          example: active
          type: string
          enum:
            - active
            - old
        - name: offset
          in: path
          required: true
          example: 0
          type: integer
      responses:
        '200':
          description: |
            list of flags response
          schema:
            type: object
            properties:
              posts:
                type: array
              topics:
                type: array
              users:
                type: array
  /admin/badges.json:
    get:
      description: |
        get a list of badges
      tags:
        - Badges
      responses:
        200:
          description: |
            list of badges response
          schema:
            $ref: 'definitions/admin/get_badges.yml'
    post:
      description: |
        create a badge
      tags:
        - Badges
      parameters:
        - name: body
          in: body
          schema:
            type: object
            properties:
              allow_title:
                type: boolean
              multiple_grant:
                type: boolean
              listable:
                type: boolean
              auto_revoke:
                type: boolean
              enabled:
                type: boolean
              show_posts:
                type: boolean
              target_posts:
                type: boolean
              name:
                type: string
              description:
                type: string
              long_description:
                type: string
              icon:
                type: string
              image:
                type: string
              badge_grouping_id:
                type: integer
              badge_type_id:
                type: integer
      responses:
        200:
          description: |
            create a badge response
  /admin/customize/user_fields.json:
    get:
      description: |
        list user fields
      tags:
        - User Fields
      responses:
        200:
          description: |
            list user fields response
    post:
      description: |
        create a user fields
      tags:
        - User Fields
      parameters:
        - name: body
          in: body
          schema:
            type: object
            properties:
              user_field[name]:
                type: string
              user_field[description]:
                type: string
              user_field[field_type:
                type: string
              user_field[required]:
                type: boolean
      responses:
        200:
          description: |
            create a user_fields response
  /admin/customize/user_fields/{id}:
    delete:
      description: |
        delete a user field
      tags:
        - User Fields
      parameters:
        - name: id
          in: path
          type: integer
          required: true
      responses:
        200:
          description: |
            delete a user field response
          schema:
            type: object
            properties:
              success:
                type: string
                example: "OK"
  /t/{id}/status_update:
    post:
      description: |
        Create a timed topic
      tags:
        - Topics
      parameters:
        - name: body
          in: body
          schema:
            type: object
            properties:
              time:
                type: string
              timezone_offset:
                type: integer
              status_type:
                type: string
                example: publish_to_category
              category_id:
                type: integer
      responses:
        200:
          description: |
            create a timed topic response
  /t/{id}/status:
    put:
      description: |
        Update a topics status
      tags:
        - Topics
      parameters:
        - name: body
          in: body
          schema:
            type: object
            properties:
              status:
                type: string
                example: closed
                enum:
                  - closed
                  - visible
                  - archived
                  - pinned_globally
              enabled:
                type: boolean
                example: true
              until:
                type: string
      responses:
        200:
          description: |
            update status response
  /t/{id}/change-timestamp:
    put:
      description: |
        Update a topics timestamp
      tags:
        - Topics
      parameters:
        - name: body
          in: body
          schema:
            type: object
            properties:
              timestamp:
                type: integer
                example: 1491199200
      responses:
        200:
          description: |
            update timestamp response
          schema:
            type: object
            properties:
              success:
                type: string
                example: OK