Category APIs

Add a new category

This api allows the user to create a new category in nodebb

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

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

Header parameters

Body

application/json

name*string

description*string

bgColor*string

color*string

parentCid*integer

class*string

Response

200400

successful operation

Body

application/json

codestring

payloaddiscussionForumCategoryResponse_payload (object)

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/categories', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "NodeJS Tutorial"
    }),
});
const data = await response.json();

Response

200400

{
  "code": "code",
  "payload": {
    "color": "color",
    "numRecentReplies": "numRecentReplies",
    "icon": "icon",
    "link": "link",
    "description": "<p>description</p>",
    "topic_count": "topic_count",
    "imageClass": "imageClass",
    "parentCid": 6,
    "descriptionParsed": "descriptionParsed",
    "bgColor": "bgColor",
    "name": "name",
    "disabled": "disabled",
    "post_count": "post_count",
    "isSection": "isSection",
    "class": "class",
    "slug": "slug",
    "cid": 0,
    "order": "order",
    "__$markdownParsed": true
  }
}

Get category details

This api allows the user to get all details of a category by using categoryId and slug from nodebb.

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

GEThttps://staging.sunbirded.org/api/discussion/category/{category_id}/{slug}

Path parameters

category_id*string

slug*string

Header parameters

Response

200400

successful operation

Body

application/json

bgColorstring

cidinteger

classstring

colorstring

descriptionstring

descriptionParsedstring

disabledinteger

iconstring

imageClassstring

isSectioninteger

linkstring

namestring

numRecentRepliesinteger

orderinteger

parentCidinteger

post_countinteger

slugstring

topic_countinteger

minTagsinteger

maxTagsinteger

totalPostCountinteger

totalTopicCountinteger

tagWhitelistarray of string

unread-classstring

childrenarray of object

topicsarray of discussionForumCategoryDetails_topics (object)

isWatchedboolean

isNotWatchedboolean

isIgnoredboolean

breadcrumbsarray of object

titlestring

privilegesobject

showSelectboolean

showTopicToolsboolean

rssFeedUrlstring

feeds:disableRSSinteger

reputation:disabledinteger

paginationobject

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/category/{category_id}/{slug}', {
    method: 'GET',
    headers: {
      "Authorization": "text"
    },
});
const data = await response.json();

Response

200400

{
  "unread-class": "unread-class",
  "template": {},
  "privileges": {},
  "pagination": {},
  "color": "color",
  "numRecentReplies": 5,
  "icon": "icon",
  "link": "link",
  "_header": {},
  "description": "<p>description</p>",
  "title": "title",
  "widgets": {},
  "showSelect": true,
  "totalTopicCount": 7,
  "parentCid": 2,
  "maxTags": 2,
  "totalPostCount": 4,
  "bgColor": "bgColor",
  "descriptionParsed": "descriptionParsed",
  "children": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "disabled": 6,
  "rssFeedUrl": "rssFeedUrl",
  "tagWhitelist": [
    "tagWhitelist",
    "tagWhitelist"
  ],
  "class": "class",
  "slug": "slug",
  "order": 5,
  "minTags": 3,
  "showTopicTools": true,
  "topics": [
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "category": {},
      "user": {},
      "cid": 1,
      "teaser": {}
    },
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "category": {},
      "user": {},
      "cid": 1,
      "teaser": {}
    }
  ],
  "isNotWatched": true,
  "reputation:disabled": 2,
  "isWatched": true,
  "isIgnored": true,
  "topic_count": 9,
  "url": "url",
  "imageClass": "imageClass",
  "feeds:disableRSS": 1,
  "loggedIn": true,
  "name": "name",
  "isSection": 1,
  "post_count": 7,
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ],
  "cid": 0,
  "__$markdownParsed": true
}

Get the category details by category id

This api allow the user to get all the details of categories using categoryId from nodebb

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

GEThttps://staging.sunbirded.org/api/discussion/category/{cid}

Path parameters

cid*string

Header parameters

Response

200400

successful operation

Body

application/json

bgColorstring

cidinteger

classstring

colorstring

descriptionstring

descriptionParsedstring

disabledinteger

iconstring

imageClassstring

isSectioninteger

linkstring

namestring

numRecentRepliesinteger

orderinteger

parentCidinteger

post_countinteger

slugstring

topic_countinteger

minTagsinteger

maxTagsinteger

totalPostCountinteger

totalTopicCountinteger

tagWhitelistarray of string

unread-classstring

childrenarray of object

topicsarray of discussionForumCategoryDetails_topics (object)

isWatchedboolean

isNotWatchedboolean

isIgnoredboolean

breadcrumbsarray of object

titlestring

privilegesobject

showSelectboolean

showTopicToolsboolean

rssFeedUrlstring

feeds:disableRSSinteger

reputation:disabledinteger

paginationobject

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

JavaScriptCurlPython

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

Response

200400

{
  "unread-class": "unread-class",
  "template": {},
  "privileges": {},
  "pagination": {},
  "color": "color",
  "numRecentReplies": 5,
  "icon": "icon",
  "link": "link",
  "_header": {},
  "description": "<p>description</p>",
  "title": "title",
  "widgets": {},
  "showSelect": true,
  "totalTopicCount": 7,
  "parentCid": 2,
  "maxTags": 2,
  "totalPostCount": 4,
  "bgColor": "bgColor",
  "descriptionParsed": "descriptionParsed",
  "children": [
    {},
    {}
  ],
  "bodyClass": "bodyClass",
  "disabled": 6,
  "rssFeedUrl": "rssFeedUrl",
  "tagWhitelist": [
    "tagWhitelist",
    "tagWhitelist"
  ],
  "class": "class",
  "slug": "slug",
  "order": 5,
  "minTags": 3,
  "showTopicTools": true,
  "topics": [
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "category": {},
      "user": {},
      "cid": 1,
      "teaser": {}
    },
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "teaserPid": {},
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "icons": {},
      "tags": {},
      "bookmark": {},
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "category": {},
      "user": {},
      "cid": 1,
      "teaser": {}
    }
  ],
  "isNotWatched": true,
  "reputation:disabled": 2,
  "isWatched": true,
  "isIgnored": true,
  "topic_count": 9,
  "url": "url",
  "imageClass": "imageClass",
  "feeds:disableRSS": 1,
  "loggedIn": true,
  "name": "name",
  "isSection": 1,
  "post_count": 7,
  "relative_path": "relative_path",
  "breadcrumbs": [
    {},
    {}
  ],
  "cid": 0,
  "__$markdownParsed": true
}

Get List of category details

This api allow the user to get all the details of categories based on cid mentioned in array from nodebb

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

POSThttps://staging.sunbirded.org/api/discussion/category/list

Header parameters

Body

application/json

requestobject

Response

200400

successful operation

Body

application/json

bgColorstring

cidinteger

classstring

colorstring

descriptionstring

descriptionParsedstring

disabledinteger

iconstring

imageClassstring

isSectioninteger

linkstring

namestring

numRecentRepliesinteger

orderinteger

parentCidinteger

post_countinteger

slugstring

topic_countinteger

minTagsinteger

maxTagsinteger

totalPostCountinteger

totalTopicCountinteger

tagWhitelistarray of string

unread-classstring

childrenarray of object

topicsarray of discussionForumCategoryDetails_topics (object)

isWatchedboolean

isNotWatchedboolean

isIgnoredboolean

breadcrumbsarray of object

titlestring

privilegesobject

showSelectboolean

showTopicToolsboolean

rssFeedUrlstring

feeds:disableRSSinteger

reputation:disabledinteger

paginationobject

loggedInboolean

relative_pathstring

templateobject

urlstring

bodyClassstring

_headerobject

widgetsobject

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/category/list', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "request": {
        "cids": [
          2,
          3
        ]
      }
    }),
});
const data = await response.json();

Response

200400

[
  {
    "unread-class": "unread-class",
    "template": {},
    "privileges": {},
    "pagination": {},
    "color": "color",
    "numRecentReplies": 5,
    "icon": "icon",
    "link": "link",
    "_header": {},
    "description": "<p>description</p>",
    "title": "title",
    "widgets": {},
    "showSelect": true,
    "totalTopicCount": 7,
    "parentCid": 2,
    "maxTags": 2,
    "totalPostCount": 4,
    "bgColor": "bgColor",
    "descriptionParsed": "descriptionParsed",
    "children": [
      {},
      {}
    ],
    "bodyClass": "bodyClass",
    "disabled": 6,
    "rssFeedUrl": "rssFeedUrl",
    "tagWhitelist": [
      "tagWhitelist",
      "tagWhitelist"
    ],
    "class": "class",
    "slug": "slug",
    "order": 5,
    "minTags": 3,
    "showTopicTools": true,
    "topics": [
      {
        "pinned": 6,
        "lastposttime": 1,
        "upvotes": 8,
        "unreplied": true,
        "unread": true,
        "timestampISO": "timestampISO",
        "title": "title",
        "teaserPid": {},
        "tid": 7,
        "uid": 4,
        "lastposttimeISO": "lastposttimeISO",
        "deleterUid": 6,
        "isOwner": true,
        "mainPid": 1,
        "locked": 9,
        "slug": "slug",
        "timestamp": 1,
        "ignored": true,
        "index": 6,
        "downvotes": 9,
        "icons": {},
        "tags": {},
        "bookmark": {},
        "deleted": 9,
        "postcount": 6,
        "viewcount": 5,
        "titleRaw": "titleRaw",
        "votes": 3,
        "category": {},
        "user": {},
        "cid": 1,
        "teaser": {}
      },
      {
        "pinned": 6,
        "lastposttime": 1,
        "upvotes": 8,
        "unreplied": true,
        "unread": true,
        "timestampISO": "timestampISO",
        "title": "title",
        "teaserPid": {},
        "tid": 7,
        "uid": 4,
        "lastposttimeISO": "lastposttimeISO",
        "deleterUid": 6,
        "isOwner": true,
        "mainPid": 1,
        "locked": 9,
        "slug": "slug",
        "timestamp": 1,
        "ignored": true,
        "index": 6,
        "downvotes": 9,
        "icons": {},
        "tags": {},
        "bookmark": {},
        "deleted": 9,
        "postcount": 6,
        "viewcount": 5,
        "titleRaw": "titleRaw",
        "votes": 3,
        "category": {},
        "user": {},
        "cid": 1,
        "teaser": {}
      }
    ],
    "isNotWatched": true,
    "reputation:disabled": 2,
    "isWatched": true,
    "isIgnored": true,
    "topic_count": 9,
    "url": "url",
    "imageClass": "imageClass",
    "feeds:disableRSS": 1,
    "loggedIn": true,
    "name": "name",
    "isSection": 1,
    "post_count": 7,
    "relative_path": "relative_path",
    "breadcrumbs": [
      {},
      {}
    ],
    "cid": 0,
    "__$markdownParsed": true
  }
]

Updates already existing catrgory details

This api can updated the category details based on the category id which we created previously

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

PUThttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}

Path parameters

cid*integer

Header parameters

Body

application/json

name*string

description*string

bgColor*string

color*string

parentCid*integer

class*string

Response

200400

successful operation

Body

application/json

codestring

payloaddiscussionForumCategoryResponse_payload (object)

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/categories/{cid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "description": "<p>Nodejs Tutorial</p>",
      "bgColor": "White",
      "color": "black",
      "parentCid": 1,
      "class": "category",
      "__$markdownParsed": true
    }),
});
const data = await response.json();

Response

200400

{
  "code": "code",
  "payload": {
    "color": "color",
    "numRecentReplies": "numRecentReplies",
    "icon": "icon",
    "link": "link",
    "description": "<p>description</p>",
    "topic_count": "topic_count",
    "imageClass": "imageClass",
    "parentCid": 6,
    "descriptionParsed": "descriptionParsed",
    "bgColor": "bgColor",
    "name": "name",
    "disabled": "disabled",
    "post_count": "post_count",
    "isSection": "isSection",
    "class": "class",
    "slug": "slug",
    "cid": 0,
    "order": "order",
    "__$markdownParsed": true
  }
}

Delete the Category

This api allows the user to delete the existing category by using categoryID from nodebb

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

DELETEhttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}

Path parameters

cid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurlPython

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

Response

200400

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

Get the moderators list for a category

This api can get the list of category moderators based on the category ID that we created previously

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

GEThttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}/moderators

Path parameters

cid*integer

Header parameters

Response

200400

successful operation

Body

application/json

uidinteger

usernamestring

userslugstring

picturestring

displaynamestring

icon:textstring

icon:bgColorstring

Request

JavaScriptCurlPython

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

Response

200400

{
  "uid": 0,
  "username": "text",
  "userslug": "text",
  "picture": "text",
  "displayname": "text",
  "icon:text": "text",
  "icon:bgColor": "text"
}

Enable category

This api allow the user to enable the category(If the category is in disable state)

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

PUThttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}/state

Path parameters

cid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurlPython

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

Response

200400

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

Add privileges to category

This api allow the user to add privilages for category in nodebb.

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

PUThttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges

Path parameters

cid*integer

Header parameters

Body

application/json

itemsstring

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges', {
    method: 'PUT',
    headers: {
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify("groups:topics:create"),
});
const data = await response.json();

Response

200400

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

Remove privileges for a category

This api allow user to remove privileges for a category in nodebb.

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

DELETEhttps://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges

Path parameters

cid*integer

Header parameters

Response

200400

successful operation

Body

application/json

codestring

payloadobject

Request

JavaScriptCurlPython

const response = await fetch('https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges', {
    method: 'DELETE',
    headers: {
      "Authorization": "text"
    },
});
const data = await response.json();

Response

200400

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