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.
55 lines
2.0 KiB
YAML
55 lines
2.0 KiB
YAML
post:
|
|
tags:
|
|
- topics
|
|
summary: create a new topic
|
|
description: This operation creates a new topic with a post. Topic creation without a post is not allowed via the Write API as it is an internal-only method.
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
cid:
|
|
type: number
|
|
example: 1
|
|
title:
|
|
type: string
|
|
example: Test topic
|
|
content:
|
|
type: string
|
|
example: This is the test topic's content
|
|
timestamp:
|
|
type: number
|
|
description: |
|
|
A UNIX timestamp of the topic's creation date (i.e. when it will be posted).
|
|
Specifically, this value can only be set to a value in the future if the calling user has the `topics:schedule` privilege for the passed-in category.
|
|
Otherwise, the current date and time are always assumed.
|
|
In some scenarios (e.g. forum migrations), you may want to backdate topics and posts.
|
|
Please see [this Developer FAQ topic](https://community.nodebb.org/topic/16983/how-can-i-backdate-topics-and-posts-for-migration-purposes) for more information.
|
|
example: 556084800000
|
|
tags:
|
|
type: array
|
|
items:
|
|
type: string
|
|
example: [test, topic]
|
|
required:
|
|
- cid
|
|
- title
|
|
- content
|
|
responses:
|
|
'200':
|
|
description: topic successfully created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../components/schemas/Status.yaml#/Status
|
|
response:
|
|
allOf:
|
|
- $ref: ../components/schemas/TopicObject.yaml#/TopicObject
|
|
- type: object
|
|
properties:
|
|
mainPost: {} |