You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
68 lines
1.8 KiB
YAML
68 lines
1.8 KiB
YAML
4 years ago
|
put:
|
||
|
|
tags:
|
||
|
|
- topics
|
||
|
|
summary: update a category
|
||
|
|
description: This operation updates an existing category.
|
||
|
|
parameters:
|
||
|
|
- in: path
|
||
|
|
name: cid
|
||
|
|
schema:
|
||
|
|
type: number
|
||
|
|
required: true
|
||
|
|
description: a valid category id
|
||
|
|
example: 1
|
||
|
|
requestBody:
|
||
|
|
required: true
|
||
|
|
content:
|
||
|
|
application/json:
|
||
|
|
schema:
|
||
|
|
type: object
|
||
|
|
properties: {}
|
||
|
|
additionalProperties: {}
|
||
|
|
responses:
|
||
|
|
'200':
|
||
|
|
description: category successfully updated
|
||
|
|
content:
|
||
|
|
application/json:
|
||
|
|
schema:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
status:
|
||
|
|
$ref: ../../components/schemas/Status.yaml#/Status
|
||
|
|
response:
|
||
|
|
allOf:
|
||
|
|
- $ref: ../../components/schemas/CategoryObject.yaml#/CategoryObject
|
||
|
|
- type: object
|
||
|
|
properties:
|
||
|
|
tagWhitelist:
|
||
|
|
type: array
|
||
|
|
items:
|
||
|
|
type: string
|
||
|
|
unread-class:
|
||
|
|
type: string
|
||
|
|
delete:
|
||
|
|
tags:
|
||
|
|
- topics
|
||
|
|
summary: delete a category
|
||
|
|
description: This operation deletes and purges a category and all of its topics and posts (careful, there is no confirmation!)
|
||
|
|
parameters:
|
||
|
|
- in: path
|
||
|
|
name: cid
|
||
|
|
schema:
|
||
|
|
type: number
|
||
|
|
required: true
|
||
|
|
description: a valid category id
|
||
|
|
example: 1
|
||
|
|
responses:
|
||
|
|
'200':
|
||
|
|
description: Category successfully deleted
|
||
|
|
content:
|
||
|
|
application/json:
|
||
|
|
schema:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
status:
|
||
|
|
$ref: ../../components/schemas/Status.yaml#/Status
|
||
|
|
response:
|
||
|
|
type: object
|
||
|
|
properties: {}
|