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.
67 lines
1.6 KiB
YAML
67 lines
1.6 KiB
YAML
post:
|
|
tags:
|
|
- topics
|
|
summary: reply to a topic
|
|
description: This operation creates a new reply to an existing topic.
|
|
parameters:
|
|
- in: path
|
|
name: tid
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: a valid topic id
|
|
example: 2
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
content:
|
|
type: string
|
|
example: This is a test reply
|
|
timestamp:
|
|
type: number
|
|
toPid:
|
|
type: number
|
|
required:
|
|
- content
|
|
responses:
|
|
'200':
|
|
description: post successfully created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../../components/schemas/Status.yaml#/Status
|
|
response:
|
|
$ref: ../../components/schemas/PostObject.yaml#/PostObject
|
|
delete:
|
|
tags:
|
|
- topics
|
|
summary: delete a topic
|
|
description: This operation purges a topic and all of its posts (careful, there is no confirmation!)
|
|
parameters:
|
|
- in: path
|
|
name: tid
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: a valid topic id
|
|
example: 2
|
|
responses:
|
|
'200':
|
|
description: Topic successfully purged
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../../components/schemas/Status.yaml#/Status
|
|
response:
|
|
type: object
|
|
properties: {} |