Posts
Topics
Private Messages
Creates a new topic, a new post, or a private message
post/posts.json
Request body
titlestring
Required if creating a new topic or new private message.
rawstring required
topic_idinteger
Required if creating a new post.
categoryinteger
Optional if creating a new topic, and ignored if creating a new post.
target_recipientsstring
Required for private message, comma separated.
target_usernamesstring
Deprecated. Use target_recipients instead.
archetypestring
Required for new private message.
created_atstring
reply_to_post_numberinteger
Optional, the post number to reply to inside a topic.
embed_urlstring
Provide a URL from a remote system to associate a forum topic with that URL, typically for using Discourse as a comments system for an external blog.
external_idstring
Provide an external_id from a remote system to associate a forum topic with that id.
auto_trackboolean
If false, the user will not track the topic. By default, the user will track the topic.
Example request
{
"target_recipients": "blake,sam",
"archetype": "private_message"
}Response
post created
idinteger required
namestring nullable required
usernamestring required
avatar_templatestring required
created_atstring required
rawstring
cookedstring required
post_numberinteger required
post_typeinteger required
posts_countinteger required
updated_atstring required
reply_countinteger required
reply_to_post_numberstring nullable required
quote_countinteger required
incoming_link_countinteger required
readsinteger required
readers_countinteger required
scorenumber required
yoursboolean required
topic_idinteger required
topic_slugstring required
display_usernamestring nullable required
primary_group_namestring nullable required
flair_namestring nullable required
flair_urlstring nullable required
flair_bg_colorstring nullable required
flair_colorstring nullable required
flair_group_idinteger nullable
versioninteger required
can_editboolean required
can_deleteboolean required
can_recoverboolean required
can_see_hidden_postboolean
can_wikiboolean required
user_titlestring nullable required
bookmarkedboolean required
moderatorboolean required
adminboolean required
staffboolean required
user_idinteger required
draft_sequenceinteger required
hiddenboolean required
trust_levelinteger required
deleted_atstring nullable required
user_deletedboolean required
edit_reasonstring nullable required
can_view_edit_historyboolean required
wikiboolean required
reviewable_idinteger nullable required
reviewable_score_countinteger required
reviewable_score_pending_countinteger required
post_urlstring required