CategoryObject:
  type: object
  properties:
    cid:
      type: number
      description: A category identifier assigned upon category creation (this value cannot be changed)
    name:
      type: string
      description: The category's name/title
    description:
      type: string
      description: A variable-length description of the category (usually displayed underneath the category name)
    descriptionParsed:
      type: string
      description: A variable-length description of the category (usually displayed underneath the category name). Unlike `description`, this value here will have been run through any parsers installed on the forum (e.g. Markdown)
    icon:
      type: string
      description: A FontAwesome icon string
      example: fa-comments-o
    bgColor:
      type: string
      description: Theme-related, a six-character hexadecimal string representing the background colour of the category
    color:
      type: string
      description: Theme-related, a six-character hexadecimal string representing the foreground/text colour of the category
    slug:
      type: string
      description: An URL-safe variant of the category title. This value is automatically generated.
      readOnly: true
    parentCid:
      type: number
      description: The category identifier for the category that is the immediate ancestor of the current category
    topic_count:
      type: number
      description: The number of topics in the category
    post_count:
      type: number
      description: The number of posts in the category
    disabled:
      type: number
      description: Whether or not this category is disabled.
    order:
      type: number
      description: A number representing the category's place in the hierarchy
    link:
      type: string
      description: If set, attempting to access the forum will go to this external link instead (theme-specific)
    numRecentReplies:
      type: number
      description: The number of posts to render in the API response (this is mostly used at the theme level)
    class:
      type: string
      description: Values that are appended to the `class` attribute of the category's parent/root element
    imageClass:
      type: string
      enum: [auto, cover, contain]
      description: The `background-position` of the category background image, if one is set
    isSection:
      type: number
    postQueue:
      type: number
    totalPostCount:
      type: number
      description: The number of posts in the category
    totalTopicCount:
      type: number
      description: The number of topics in the category
    minTags:
      type: number
      description: Minimum tags per topic in this category
    maxTags:
      type: number
      description: Maximum tags per topic in this category