Post APIs

Create new post

This api allow the user to create new post to topic in nodebb

• The endpoint for Post is /v2/topics/{tid}
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/topics/{tid}

POSThttps://staging.sunbirded.org/api/discussion/v2/topics/{tid}

Path parameters

tid*integer

Header parameters

Body

application/json

content*string

toPidinteger

Response

200400

successful operation

Body

application/json

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "content": "Example reply to topic",
      "toPid": 1
    }),
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {
    "topicData": {
      "pinned": 4,
      "lastposttime": 6,
      "upvotes": 7,
      "unreplied": 6,
      "mainPost": {},
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 5,
      "uid": 7,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 1,
      "isOwner": true,
      "mainPid": 1,
      "locked": 2,
      "slug": "slug",
      "timestamp": 2,
      "ignored": true,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 3,
      "postcount": 5,
      "viewcount": 9,
      "titleRaw": "titleRaw",
      "votes": 1,
      "category": {},
      "user": {},
      "cid": 0,
      "teaser": {}
    },
    "postData": {
      "isMain": true,
      "bookmarked": true,
      "selfPost": true,
      "index": 9,
      "pid": 7,
      "timestampISO": "timestampISO",
      "display_edit_tools": true,
      "tid": 4,
      "content": "content",
      "uid": 1,
      "display_moderator_tools": true,
      "display_move_tools": true,
      "topic": {},
      "votes": 6,
      "display_delete_tools": true,
      "user": {},
      "timestamp": 5,
      "cid": 9
    }
  }
}

Create reply to post

This api allow the user to create reply to post in nodebb

• The endpoint for Post is /v2/topics/{tid}
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/topics/{tid}

POSThttps://staging.sunbirded.org/api/discussion/v2/topics/{tid}

Path parameters

tid*integer

Header parameters

Body

application/json

content*string

toPid*integer

Response

200400

successful operation

Body

application/json

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "content": "Example reply to topic",
      "toPid": 1
    }),
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {
    "topicData": {
      "pinned": 4,
      "lastposttime": 6,
      "upvotes": 7,
      "unreplied": 6,
      "mainPost": {},
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 5,
      "uid": 7,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 1,
      "isOwner": true,
      "mainPid": 1,
      "locked": 2,
      "slug": "slug",
      "timestamp": 2,
      "ignored": true,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 3,
      "postcount": 5,
      "viewcount": 9,
      "titleRaw": "titleRaw",
      "votes": 1,
      "category": {},
      "user": {},
      "cid": 0,
      "teaser": {}
    },
    "postData": {
      "isMain": true,
      "bookmarked": true,
      "selfPost": true,
      "index": 9,
      "pid": 7,
      "timestampISO": "timestampISO",
      "display_edit_tools": true,
      "tid": 4,
      "content": "content",
      "uid": 1,
      "display_moderator_tools": true,
      "display_move_tools": true,
      "topic": {},
      "votes": 6,
      "display_delete_tools": true,
      "user": {},
      "timestamp": 5,
      "cid": 9
    }
  }
}

Delete a post by postID

This api allows the user to delete post in the nodebb

• The endpoint for Post is /v2/posts/{pid}
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}

DELETEhttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Vote a post by postID

This api allows the user to vote(Up/down) to post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/vote
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/vote

POSThttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/vote

Path parameters

pid*integer

Header parameters

Body

application/json

The delta must be a number. If delta is > 0, it's considered an upvote; if delta is < 0, it's considered a downvote; otherwise, it's an unvote.

delta*integer

delta must be a number. If delta > 0, it's considered an upvote; if delta < 0, it's considered a downvote; otherwise, it's an unvote.

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/vote', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "delta": 1
    }),
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Remove votes for a post by postID

This api allows the user to delete vote(Up/down) to post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/vote
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/vote

DELETEhttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/vote

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/vote', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Bookmarks a post by postID

This api allows the user to bookmarks a post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/bookmark
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/bookmark

POSThttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/bookmark

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/bookmark', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Removes bookmarks for a post by postID

This api allows the user to Unbookmarks a post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/bookmark
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/bookmark

DELETEhttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/bookmark

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/bookmark', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Restores a post

This api allows the user to Restores a post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/state
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/state

PUThttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/state

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/state', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}

Deletes a post (Soft-delete)

This api allows the user to Deletes a post in the nodebb

• The endpoint for Post is /v2/posts/{pid}/state
• The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
• Backend Route: http://nodebb-service:4567/discussions/api/v2/posts/{pid}/state

DELETEhttps://staging.sunbirded.org/api/discussion/v2/posts/{pid}/state

Path parameters

pid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurl

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/posts/{pid}/state', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "code",
  "payload": {}
}