mirror of
https://github.com/NodeBB/NodeBB.git
synced 2026-05-07 12:55:44 +02:00
e395fb0919
* **feat**: add support for setting watch state via category ID and member UID in route params * **feat**: update category watch/privilege routes and logic to use `member` param instead of `uid`/`member` body field * **feat**: add support for unfollowing via actor parameter in category routes * **feat**: add deprecation warnings for legacy category routes and refactor privilege fetching to inline async call * docs: add openapi specs for new category routes with path parameters Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * fix: some minor errors in file paths * feat: support path extraction from req.query in assert.path middleware Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: support message from both query and body in removeQueuedPost Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * fix: remove ai-added check that path is defined, it is not required * fix: send message as query param instead of in body, when rejecting queued post * lint: comma dangle * `feat(openapi): add optional query parameter support for topic delete endpoints` Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: add query parameter and make request body optional for topic thumbnail deletion Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: support query params for thumb path and crosspost id in topics endpoints Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: add query params for mute/unmute reason and timestamp Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * docs: update unmute API to support query params for reason and until timestamp Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * docs: update unmute endpoint to support reason via request body Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: add reason parameter support to users.unmute Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat> * feat: allow unban reason to be sent via req.query * fix: timestamps are unix timestamps not 8601 * docs: mute shouldn't have been updated * chore: remove deprecation warnings --------- Co-authored-by: aider (ollama/ministral-3:8b) <aider@aider.chat>
142 lines
3.7 KiB
YAML
142 lines
3.7 KiB
YAML
get:
|
|
tags:
|
|
- topics
|
|
summary: get topic thumbnails
|
|
description: This operation retrieves a topic's uploaded thumbnails
|
|
parameters:
|
|
- in: path
|
|
name: tid
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: a valid topic id
|
|
example: 1
|
|
- in: query
|
|
name: thumbsOnly
|
|
schema:
|
|
type: boolean
|
|
required: false
|
|
description: "(default: false) exclude post attachments, uploaded media, and those added by plugins"
|
|
example: 0
|
|
responses:
|
|
'200':
|
|
description: Thumbnails successfully retrieved
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../../../components/schemas/Status.yaml#/Status
|
|
response:
|
|
type: array
|
|
description: A list of the topic thumbnails that still remain
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: string
|
|
name:
|
|
type: string
|
|
path:
|
|
type: string
|
|
url:
|
|
type: string
|
|
description: Path to a topic thumbnail
|
|
post:
|
|
tags:
|
|
- topics
|
|
summary: add topic thumbnail
|
|
description: This operation adds a thumbnail to an existing topic or a draft (via a composer `uuid`)
|
|
parameters:
|
|
- in: path
|
|
name: tid
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: a valid topic id
|
|
example: 1
|
|
requestBody:
|
|
content:
|
|
multipart/form-data:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
files:
|
|
type: array
|
|
items:
|
|
type: string
|
|
format: binary
|
|
responses:
|
|
'200':
|
|
description: Thumbnail successfully added
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
url:
|
|
type: string
|
|
path:
|
|
type: string
|
|
name:
|
|
type: string
|
|
delete:
|
|
tags:
|
|
- topics
|
|
summary: remove topic thumbnail
|
|
description: This operation removes a topic thumbnail.
|
|
parameters:
|
|
- in: path
|
|
name: tid
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: a valid topic id
|
|
example: 1
|
|
- in: query
|
|
name: path
|
|
schema:
|
|
type: string
|
|
required: false
|
|
description: Relative path to the topic thumbnail (alternative to request body)
|
|
example: files/test.png
|
|
requestBody:
|
|
required: false
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
path:
|
|
type: string
|
|
description: Relative path to the topic thumbnail
|
|
example: files/test.png
|
|
responses:
|
|
'200':
|
|
description: Topic thumbnail removed
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../../../components/schemas/Status.yaml#/Status
|
|
response:
|
|
type: array
|
|
description: A list of the topic thumbnails that still remain
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: string
|
|
name:
|
|
type: string
|
|
path:
|
|
type: string
|
|
url:
|
|
type: string
|
|
description: Path to a topic thumbnail
|