Topic APIs

Get unread topics

This api allow the user to get all the unread topics in nodebb

The endpoint for Topics is /unread
The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
Backend Route: http://nodebb-service:4567/discussions/api/unread

GEThttps://staging.sunbirded.org/api/discussion/unread

Header parameters

Response

successful operation

Body

nextStartinteger

topicCountinteger

topicsarray of discussionForumTopicResponse_topics (object)

tidsarray of string

canPostboolean

showSelectboolean

showTopicToolsboolean

categoriesarray of discussionForumTopicResponse_categories (object)

allCategoriesUrlstring

selectedCategoryobject

selectedCidsarray of string

feeds:disableRSSinteger

rssFeedUrlstring

titlestring

filtersarray of object

selectedFilterobject

termsarray of object

selectedTermobject

paginationobject

breadcrumbsarray of object

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

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

Response

{
  "template": {},
  "pagination": {},
  "_header": {},
  "nextStart": 0,
  "selectedTerm": {},
  "title": "title",
  "widgets": {},
  "showSelect": true,
  "canPost": true,
  "selectedCids": [
    "selectedCids",
    "selectedCids"
  ],
  "terms": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "topicCount": 6,
  "rssFeedUrl": "rssFeedUrl",
  "categories": [
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    },
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    }
  ],
  "showTopicTools": true,
  "topics": [
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    },
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    }
  ],
  "filters": [
    {},
    {}
  ],
  "allCategoriesUrl": "allCategoriesUrl",
  "url": "url",
  "selectedFilter": {},
  "tids": [
    "tids",
    "tids"
  ],
  "feeds:disableRSS": 9,
  "loggedIn": true,
  "selectedCategory": {},
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ]
}

Get recent topics

This api allow the user to get all the recent topics in nodebb

The endpoint for Topics is /recent
The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
Backend Route: http://nodebb-service:4567/discussions/api/recent

GEThttps://staging.sunbirded.org/api/discussion/recent

Header parameters

Response

successful operation

Body

nextStartinteger

topicCountinteger

topicsarray of discussionForumTopicResponse_topics (object)

tidsarray of string

canPostboolean

showSelectboolean

showTopicToolsboolean

categoriesarray of discussionForumTopicResponse_categories (object)

allCategoriesUrlstring

selectedCategoryobject

selectedCidsarray of string

feeds:disableRSSinteger

rssFeedUrlstring

titlestring

filtersarray of object

selectedFilterobject

termsarray of object

selectedTermobject

paginationobject

breadcrumbsarray of object

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

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

Response

{
  "template": {},
  "pagination": {},
  "_header": {},
  "nextStart": 0,
  "selectedTerm": {},
  "title": "title",
  "widgets": {},
  "showSelect": true,
  "canPost": true,
  "selectedCids": [
    "selectedCids",
    "selectedCids"
  ],
  "terms": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "topicCount": 6,
  "rssFeedUrl": "rssFeedUrl",
  "categories": [
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    },
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    }
  ],
  "showTopicTools": true,
  "topics": [
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    },
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    }
  ],
  "filters": [
    {},
    {}
  ],
  "allCategoriesUrl": "allCategoriesUrl",
  "url": "url",
  "selectedFilter": {},
  "tids": [
    "tids",
    "tids"
  ],
  "feeds:disableRSS": 9,
  "loggedIn": true,
  "selectedCategory": {},
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ]
}

Get popular topics

This api allow the user to get all the popular topics in nodebb

The endpoint for Topics is /recent
The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
Backend Route: http://nodebb-service:4567/discussions/api/popular

GEThttps://staging.sunbirded.org/api/discussion/popular

Header parameters

Response

successful operation

Body

nextStartinteger

topicCountinteger

topicsarray of discussionForumTopicResponse_topics (object)

tidsarray of string

canPostboolean

showSelectboolean

showTopicToolsboolean

categoriesarray of discussionForumTopicResponse_categories (object)

allCategoriesUrlstring

selectedCategoryobject

selectedCidsarray of string

feeds:disableRSSinteger

rssFeedUrlstring

titlestring

filtersarray of object

selectedFilterobject

termsarray of object

selectedTermobject

paginationobject

breadcrumbsarray of object

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

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

Response

{
  "template": {},
  "pagination": {},
  "_header": {},
  "nextStart": 0,
  "selectedTerm": {},
  "title": "title",
  "widgets": {},
  "showSelect": true,
  "canPost": true,
  "selectedCids": [
    "selectedCids",
    "selectedCids"
  ],
  "terms": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "topicCount": 6,
  "rssFeedUrl": "rssFeedUrl",
  "categories": [
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    },
    {
      "parentCid": 5,
      "color": "color",
      "bgColor": "bgColor",
      "level": "level",
      "name": "name",
      "icon": "icon",
      "selected": true,
      "cid": 4,
      "imageClass": "imageClass"
    }
  ],
  "showTopicTools": true,
  "topics": [
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    },
    {
      "pinned": 1,
      "lastposttime": 5,
      "upvotes": 1,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 3,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 5,
      "locked": 7,
      "slug": "slug",
      "timestamp": 9,
      "ignored": true,
      "index": 1,
      "downvotes": 1,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 4,
      "postcount": 2,
      "viewcount": 2,
      "titleRaw": "titleRaw",
      "votes": 7,
      "category": {
        "parentCid": 6,
        "bgColor": "bgColor",
        "color": "color",
        "backgroundImage": {},
        "name": "name",
        "icon": "icon",
        "slug": "slug",
        "cid": 2,
        "imageClass": "imageClass"
      },
      "user": {
        "uid": 6,
        "icon:bgColor": "icon:bgColor",
        "icon:text": "icon:text",
        "userslug": "userslug",
        "picture": {},
        "username": "username",
        "status": "status"
      },
      "cid": 1,
      "teaser": {}
    }
  ],
  "filters": [
    {},
    {}
  ],
  "allCategoriesUrl": "allCategoriesUrl",
  "url": "url",
  "selectedFilter": {},
  "tids": [
    "tids",
    "tids"
  ],
  "feeds:disableRSS": 9,
  "loggedIn": true,
  "selectedCategory": {},
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ]
}

Get teaser of topic

This api allow the user to get teaser details of topic in nodebb

The endpoint for Topics is /topic/teaser/{topic_id}
The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
Backend Route: http://nodebb-service:4567/discussions/api/topic/teaser/{topic_id}

GEThttps://staging.sunbirded.org/api/discussion/topic/teaser/{topic_id}

Path parameters

topic_id*integer

Header parameters

Response

successful operation

Body

pidinteger

tidinteger

contentstring

uidinteger

timestampinteger

deletedobject

upvotesinteger

downvotesinteger

repliesinteger

votesinteger

timestampISOstring

userobject

topicobject

categoryobject

isMainPostobject

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/topic/teaser/{topic_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "content": "text",
  "timestampISO": "text",
  "user": {
    "username": "text",
    "userslug": "text",
    "status": "text",
    "displayname": "text",
    "icon:text": "text",
    "icon:bgColor": "text"
  },
  "topic": {
    "title": "text",
    "slug": "text",
    "titleRaw": "text"
  },
  "category": {
    "name": "text",
    "icon": "text",
    "slug": "text",
    "bgColor": "text",
    "color": "text",
    "imageClass": "text"
  }
}

Get topics details

This api allow the user to get topics details by using topicId ad slug from nodebb

The endpoint for Topics is /topic/{topic_id}/{slug}
The fields marked with an asterisk (*) are mandatory. They cannot be null or empty.
Backend Route: http://nodebb-service:4567/discussions/api/topic/{topic_id}/{slug}

GEThttps://staging.sunbirded.org/api/discussion/topic/{topic_id}/{slug}

Path parameters

topic_id*integer

slug*string

Header parameters

Response

successful operation

Body

cidinteger

lastposttimeinteger

mainPidinteger

postcountinteger

slugstring

tidinteger

timestampinteger

titlestring

uidinteger

viewcountinteger

deletedinteger

lockedinteger

pinnedinteger

upvotesinteger

downvotesinteger

deleterUidinteger

titleRawstring

timestampISOstring

lastposttimeISOstring

votesinteger

teaserPidinteger

tagsarray of string

postsarray of object

categoryarray of object

tagWhitelistarray of string

minTagsinteger

maxTagsinteger

thread_toolsarray of string

isFollowingboolean

isNotFollowingboolean

isIgnoringboolean

bookmarkobject

postSharingarray of object

deleterobject

mergerobject

relatedarray of object

unrepliedboolean

iconsarray of object

privilegesobject

topicStaleDaysinteger

reputation:disabledinteger

downvote:disabledinteger

feeds:disableRSSinteger

bookmarkThresholdinteger

necroThresholdinteger

postEditDurationinteger

postDeleteDurationinteger

scrollToMyPostboolean

allowMultipleBadgesboolean

privateUploadsboolean

rssFeedUrlstring

postIndexinteger

breadcrumbsarray of object

paginationobject

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

loggedInUserobject

_headerobject

widgetsobject

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/topic/{topic_id}/{slug}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "privileges": {},
  "upvotes": 7,
  "unreplied": true,
  "privateUploads": true,
  "postDeleteDuration": 6,
  "_header": {},
  "topicStaleDays": 4,
  "teaserPid": 6,
  "loggedInUser": {},
  "posts": [
    {},
    {}
  ],
  "tid": 5,
  "postEditDuration": 9,
  "deleterUid": 1,
  "necroThreshold": 8,
  "mainPid": 1,
  "rssFeedUrl": "rssFeedUrl",
  "locked": 2,
  "slug": "slug",
  "reputation:disabled": 5,
  "downvotes": 1,
  "tags": [
    "tags",
    "tags"
  ],
  "bookmark": {},
  "feeds:disableRSS": 9,
  "isNotFollowing": true,
  "loggedIn": true,
  "downvote:disabled": 9,
  "postIndex": 3,
  "titleRaw": "titleRaw",
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ],
  "cid": 0,
  "allowMultipleBadges": true,
  "template": {},
  "pinned": 4,
  "pagination": {},
  "lastposttime": 6,
  "bookmarkThreshold": 6,
  "postSharing": [
    {},
    {}
  ],
  "timestampISO": "timestampISO",
  "title": "title",
  "widgets": {},
  "deleter": {},
  "uid": 7,
  "lastposttimeISO": "lastposttimeISO",
  "maxTags": 1,
  "related": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "tagWhitelist": [
    "tagWhitelist",
    "tagWhitelist"
  ],
  "timestamp": 2,
  "minTags": 7,
  "isIgnoring": true,
  "isFollowing": true,
  "scrollToMyPost": true,
  "icons": [
    {},
    {}
  ],
  "url": "url",
  "deleted": 3,
  "postcount": 5,
  "thread_tools": [
    "thread_tools",
    "thread_tools"
  ],
  "viewcount": 9,
  "votes": 1,
  "category": [
    {},
    {}
  ],
  "merger": {}
}

Create new topic

This api allow the user to create new topic in nodebb

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

POSThttps://staging.sunbirded.org/api/discussion/v2/topics

Header parameters

Body

cid*integer

title*string

content*string

Response

successful operation

Body

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "cid": 1,
      "title": "Learning",
      "content": "All Javascript frameworks"
    }),
});
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 topic (Soft delete)

This api allow the user to delete a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/state
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}/state

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloadobject

Request

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

Response

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

Follow a topic

This api allow the user to follow a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/state
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}/follow

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloadobject

Request

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

Response

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

UnFollow a Post

This api allow the user to unfollow a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/state
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}/follow

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloadobject

Request

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

Response

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

Add tags for a topic

This api allow the user to add tags to a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/tags
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}/tags

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

Path parameters

tid*integer

Header parameters

Body

itemsstring

Response

successful operation

Body

codestring

payloadobject

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}/tags', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      "text"
    ]),
});
const data = await response.json();

Response

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

Delete tags for a topic

This api allow the user to delete tags for a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/tags
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}/tags

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloadobject

Request

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

Response

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

Pin a topic

This api allow the user to pin to a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/pin
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}/pin

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

Path parameters

tid*integer

Header parameters

Body

itemsstring

Response

successful operation

Body

codestring

payloadobject

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}/pin', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      "text"
    ]),
});
const data = await response.json();

Response

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

Unpin a topic

This api allow the user to unpin a topic in nodebb

The endpoint for Topics is /v2/topics/{tid}/pin
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}/pin

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloadobject

Request

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

Response

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

Updates topic details

This api allow the user to update topic details in nodebb

The endpoint for Topics 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}

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

Path parameters

tid*integer

Header parameters

Body

pid*integer

content*string

handlestring

titlestring

topic_thumbinteger

tagsarray of string

Response

successful operation

Body

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "content": "Example content",
      "pid": 1,
      "handle": "example",
      "title": "Topic title",
      "topic_thumb": 0,
      "tags": [
        "Angular"
      ]
    }),
});
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 new reply to topic

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

The endpoint for Topics 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

content*string

toPidinteger

Response

successful operation

Body

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

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 topic

This api allow the user to delete topic in nodebb

The endpoint for Topics 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}

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

Path parameters

tid*integer

Header parameters

Response

successful operation

Body

codestring

payloaddiscussionForumCreateTopicResponse_payload (object)

Request

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/topics/{tid}', {
    method: 'DELETE',
    headers: {},
});
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
    }
  }
}

PreviousPost APIs NextForum APIs

Last updated 1 year ago