fix: use CategoryObject in admins-mods schema def

This commit is contained in:
Julian Lam
2024-03-22 12:37:52 -04:00
parent 65bb866654
commit aafdefa7d6

View File

@@ -18,87 +18,16 @@ get:
categoryMods: categoryMods:
type: array type: array
items: items:
type: object allOf:
properties: - $ref: ../../../components/schemas/CategoryObject.yaml#/CategoryObject
cid: - type: object
type: number properties:
description: A category identifier assigned upon category creation (this value cannot be changed) moderators:
name: type: array
type: string items:
description: The category's name/title $ref: ../../../components/schemas/UserObject.yaml#/UserObjectSlim
description: subCategoryCount:
type: string type: number
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
minTags:
type: number
description: Minimum tags per topic in this category
maxTags:
type: number
description: Maximum tags per topic in this category
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
subCategoriesPerPage:
type: number
description: The number of subcategories to display on the categories and category page
moderators:
type: array
items:
$ref: ../../../components/schemas/UserObject.yaml#/UserObjectSlim
subCategoryCount:
type: number
selectedCategory: selectedCategory:
nullable: true nullable: true
anyOf: anyOf: