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

post

/discussion/v2/categories

Header parameters

Authorizationstringrequired

Body

namestringrequired

descriptionstringrequired

bgColorstringrequired

colorstringrequired

parentCidintegerrequired

classstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{"name":"NodeJS Tutorial"}'

200

400

200

{
  "code": "code",
  "payload": {
    "color": "color",
    "numRecentReplies": "numRecentReplies",
    "icon": "icon",
    "link": "link",
    "description": "description",
    "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"
  }
}

successful operation

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}

get

/discussion/category/{category_id}//{slug}

Path parameters

category_idstringrequired

slugstringrequired

Header parameters

Authorizationstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://staging.sunbirded.org/api/discussion/category/{category_id}/{slug}' \
  --header 'Authorization: text'

200

400

200

{
  "unread-class": "unread-class",
  "color": "color",
  "numRecentReplies": 5,
  "icon": "icon",
  "link": "link",
  "description": "description",
  "title": "title",
  "showSelect": true,
  "totalTopicCount": 7,
  "parentCid": 2,
  "maxTags": 2,
  "totalPostCount": 4,
  "bgColor": "bgColor",
  "descriptionParsed": "descriptionParsed",
  "bodyClass": "bodyClass",
  "disabled": 6,
  "rssFeedUrl": "rssFeedUrl",
  "class": "class",
  "slug": "slug",
  "order": 5,
  "minTags": 3,
  "showTopicTools": true,
  "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",
  "cid": 0,
  "tagWhitelist": [
    "tagWhitelist",
    "tagWhitelist"
  ],
  "template": {},
  "privileges": {},
  "pagination": {},
  "_header": {},
  "widgets": {},
  "children": [
    {},
    {}
  ],
  "breadcrumbs": [
    {},
    {}
  ],
  "topics": [
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "cid": 1,
      "teaserPid": {},
      "icons": {},
      "tags": {},
      "bookmark": {},
      "category": {},
      "user": {},
      "teaser": {}
    },
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "cid": 1,
      "teaserPid": {},
      "icons": {},
      "tags": {},
      "bookmark": {},
      "category": {},
      "user": {},
      "teaser": {}
    }
  ]
}

successful operation

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}

get

/discussion/category/{cid}

Path parameters

cidstringrequired

Header parameters

Authorizationstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://staging.sunbirded.org/api/discussion/category/{cid}' \
  --header 'Authorization: text'

200

400

200

{
  "unread-class": "unread-class",
  "color": "color",
  "numRecentReplies": 5,
  "icon": "icon",
  "link": "link",
  "description": "description",
  "title": "title",
  "showSelect": true,
  "totalTopicCount": 7,
  "parentCid": 2,
  "maxTags": 2,
  "totalPostCount": 4,
  "bgColor": "bgColor",
  "descriptionParsed": "descriptionParsed",
  "bodyClass": "bodyClass",
  "disabled": 6,
  "rssFeedUrl": "rssFeedUrl",
  "class": "class",
  "slug": "slug",
  "order": 5,
  "minTags": 3,
  "showTopicTools": true,
  "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",
  "cid": 0,
  "tagWhitelist": [
    "tagWhitelist",
    "tagWhitelist"
  ],
  "template": {},
  "privileges": {},
  "pagination": {},
  "_header": {},
  "widgets": {},
  "children": [
    {},
    {}
  ],
  "breadcrumbs": [
    {},
    {}
  ],
  "topics": [
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "cid": 1,
      "teaserPid": {},
      "icons": {},
      "tags": {},
      "bookmark": {},
      "category": {},
      "user": {},
      "teaser": {}
    },
    {
      "pinned": 6,
      "lastposttime": 1,
      "upvotes": 8,
      "unreplied": true,
      "unread": true,
      "timestampISO": "timestampISO",
      "title": "title",
      "tid": 7,
      "uid": 4,
      "lastposttimeISO": "lastposttimeISO",
      "deleterUid": 6,
      "isOwner": true,
      "mainPid": 1,
      "locked": 9,
      "slug": "slug",
      "timestamp": 1,
      "ignored": true,
      "index": 6,
      "downvotes": 9,
      "deleted": 9,
      "postcount": 6,
      "viewcount": 5,
      "titleRaw": "titleRaw",
      "votes": 3,
      "cid": 1,
      "teaserPid": {},
      "icons": {},
      "tags": {},
      "bookmark": {},
      "category": {},
      "user": {},
      "teaser": {}
    }
  ]
}

successful operation

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

post

/discussion/category/list

Header parameters

Authorizationstringrequired

Body

requestobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://staging.sunbirded.org/api/discussion/category/list' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{"request":{"cids":[2,3]}}'

200

400

200

[
  {
    "unread-class": "unread-class",
    "color": "color",
    "numRecentReplies": 5,
    "icon": "icon",
    "link": "link",
    "description": "description",
    "title": "title",
    "showSelect": true,
    "totalTopicCount": 7,
    "parentCid": 2,
    "maxTags": 2,
    "totalPostCount": 4,
    "bgColor": "bgColor",
    "descriptionParsed": "descriptionParsed",
    "bodyClass": "bodyClass",
    "disabled": 6,
    "rssFeedUrl": "rssFeedUrl",
    "class": "class",
    "slug": "slug",
    "order": 5,
    "minTags": 3,
    "showTopicTools": true,
    "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",
    "cid": 0,
    "tagWhitelist": [
      "tagWhitelist",
      "tagWhitelist"
    ],
    "template": {},
    "privileges": {},
    "pagination": {},
    "_header": {},
    "widgets": {},
    "children": [
      {},
      {}
    ],
    "breadcrumbs": [
      {},
      {}
    ],
    "topics": [
      {
        "pinned": 6,
        "lastposttime": 1,
        "upvotes": 8,
        "unreplied": true,
        "unread": true,
        "timestampISO": "timestampISO",
        "title": "title",
        "tid": 7,
        "uid": 4,
        "lastposttimeISO": "lastposttimeISO",
        "deleterUid": 6,
        "isOwner": true,
        "mainPid": 1,
        "locked": 9,
        "slug": "slug",
        "timestamp": 1,
        "ignored": true,
        "index": 6,
        "downvotes": 9,
        "deleted": 9,
        "postcount": 6,
        "viewcount": 5,
        "titleRaw": "titleRaw",
        "votes": 3,
        "cid": 1,
        "teaserPid": {},
        "icons": {},
        "tags": {},
        "bookmark": {},
        "category": {},
        "user": {},
        "teaser": {}
      },
      {
        "pinned": 6,
        "lastposttime": 1,
        "upvotes": 8,
        "unreplied": true,
        "unread": true,
        "timestampISO": "timestampISO",
        "title": "title",
        "tid": 7,
        "uid": 4,
        "lastposttimeISO": "lastposttimeISO",
        "deleterUid": 6,
        "isOwner": true,
        "mainPid": 1,
        "locked": 9,
        "slug": "slug",
        "timestamp": 1,
        "ignored": true,
        "index": 6,
        "downvotes": 9,
        "deleted": 9,
        "postcount": 6,
        "viewcount": 5,
        "titleRaw": "titleRaw",
        "votes": 3,
        "cid": 1,
        "teaserPid": {},
        "icons": {},
        "tags": {},
        "bookmark": {},
        "category": {},
        "user": {},
        "teaser": {}
      }
    ]
  }
]

successful operation

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}

put

/discussion/v2/categories/{cid}

Path parameters

cidintegerrequired

Header parameters

Authorizationstring

Body

namestringrequired

descriptionstringrequired

bgColorstringrequired

colorstringrequired

parentCidintegerrequired

classstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}' \
  --header 'Content-Type: application/json' \
  --data '{"description":"Nodejs Tutorial","bgColor":"White","color":"black","parentCid":1,"class":"category"}'

200

400

200

{
  "code": "code",
  "payload": {
    "color": "color",
    "numRecentReplies": "numRecentReplies",
    "icon": "icon",
    "link": "link",
    "description": "description",
    "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"
  }
}

successful operation

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}

delete

/discussion/v2/categories/{cid}

Path parameters

cidintegerrequired

Header parameters

Authorizationstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}'

200

400

200

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

successful operation

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

get

/discussion/v2/categories/{cid}/moderators

Path parameters

cidintegerrequired

Header parameters

Authorizationstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/moderators'

200

400

200

{
  "uid": 8,
  "username": "content_reviewer_tn1970",
  "userslug": "content_reviewer_tn1970",
  "picture": null,
  "displayname": "content_reviewer_tn1970",
  "icon:text": "C",
  "icon:bgColor": null
}

successful operation

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

put

/discussion/v2/categories/{cid}/state

Path parameters

cidintegerrequired

Header parameters

Authorizationstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/state' \
  --header 'Authorization: text'

200

400

200

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

successful operation

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

put

/discussion/v2/categories/{cid}/privileges

Path parameters

cidintegerrequired

Header parameters

Authorizationstringrequired

Body

itemsstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '"groups:topics:create"'

200

400

200

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

successful operation

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

delete

/discussion/v2/categories/{cid}/privileges

Path parameters

cidintegerrequired

Header parameters

Authorizationstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://staging.sunbirded.org/api/discussion/v2/categories/{cid}/privileges' \
  --header 'Authorization: text'

200

400

200

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

successful operation