Create post​
Create a new post
Request Body required
- Array [
- ]
- Array [
- ]
post object required
Possible values: [0, 1, 2]
The room post status, defaults to publicly: 1. As Room: 0, Publicly: 1, Only Members: 2
Possible values: >= 6 characters
references object[] required
Possible values: >= 1
Default value: 0
Default value: 0
mentions object[] required
Possible values: Value must match regular expression /{{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}}}/
- 201
- 400
Post created successfully
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
post object required
tags object[]
references object[]
recentComment object
author object required
avatarUrls object required
Default value: false
room object nullable
Default value: false
mentions object[]
avatarUrls object required
Default value: false
Default value: false
Default value: false
Default value: false
Default value: false
Possible values: [0, 1, 2]
Default value: 0
@description 0: OnlyMembers, 1: Publicly, 2: AsRoom
Default value: false
Default value: 0
Default value: 0
Default value: 0
Possible values: [1, 2, 3, 4, 5, 6, 30]
featured = 1, // Like Sticky posts, will be featured for a time period.Shown at top in feed and partner apps
promoted = 2, // High quality content.Shown at top(after featured) in feed and partner apps
normal = 3, // Default status, available in search, latest and popular tabs.In feed(if you're following the author)
hidden = 4, // Visible only to author or moderators, or via private share link.
private_note = 5, // Private notes, only visible to author or via private share link.These are the posts made "private" by moderators.
requested_review = 6, // User requested the review, treat them has hidden.Only visible to author and moderators
deleted = 30,
Default value: 0
{
"post": {
"tags": [
{
"language": "string",
"id": 0,
"name": "string"
}
],
"references": [
{
"id": "string",
"from": 0,
"to": 0,
"chapterId": 0
}
],
"author": {},
"recentComment": {
"id": 0,
"author": {
"postsCount": 0,
"avatarUrls": {
"small": "string",
"medium": "string",
"large": "string"
},
"id": "string",
"username": "string",
"verified": false,
"firstName": "string",
"lastName": "string",
"memberType": 0
},
"body": "string",
"createdAt": "2025-11-17T03:28:52.432Z"
},
"room": {
"isAdmin": {},
"isOwner": {},
"isPublic": {},
"id": 0,
"subdomain": "string",
"roomType": "string",
"verified": false,
"name": "string",
"_group": "string"
},
"mentions": [
{
"postsCount": 0,
"avatarUrls": {
"small": "string",
"medium": "string",
"large": "string"
},
"id": "string",
"username": "string",
"verified": false,
"firstName": "string",
"lastName": "string",
"memberType": 0,
"locations": {},
"followersCount": 0,
"displayName": "string"
}
],
"isLiked": true,
"isByFollowedUser": true,
"isCommentedOn": true,
"isSaved": true,
"id": 0,
"authorId": "string",
"body": "string",
"discussionId": 0,
"draft": false,
"createdAt": "2025-11-17T03:28:52.433Z",
"updatedAt": "2025-11-17T03:28:52.433Z",
"publishedAt": "2025-11-17T03:28:52.433Z",
"global": true,
"toxicityScore": 0,
"reported": false,
"views": 0,
"removed": false,
"verified": false,
"roomPostStatus": 0,
"hidden": false,
"commentsCount": 0,
"likesCount": 0,
"viewsCount": 0,
"languageId": 0,
"languageName": "string",
"moderationStatus": 1,
"reviewedAt": "2025-11-17T03:28:52.433Z",
"featuredAt": "2025-11-17T03:28:52.433Z",
"estimatedReadingTime": 0,
"roomId": 0,
"postTypeId": 0,
"postTypeName": "string"
},
"success": true
}
Invalid post