Community Groups

Get All Groups

Authentication

Authentication is optional. If authenticated, the response includes membership status for each group.

Response

boolean

Indicates whether the request was successful

array

Array of community group objects

Show group object

string

Unique identifier for the group

string

Display name of the group (max 60 characters)

string

URL-friendly identifier for the group

string

Brief description of the group (max 200 characters)

string

Emoji or icon representing the group (default: 💬)

boolean

Whether this is an official platform group

number

Total number of members in the group

number

Total number of posts in the group

boolean

Whether the authenticated user is a member (only if authenticated)

Code Example

const response = await fetch('https://api.skillrise.com/api/community/groups', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN' // Optional
  }
});

const data = await response.json();
console.log(data.groups);

import requests

url = 'https://api.skillrise.com/api/community/groups'
headers = {'Authorization': 'Bearer YOUR_TOKEN'}  # Optional

response = requests.get(url, headers=headers)
data = response.json()
print(data['groups'])

curl https://api.skillrise.com/api/community/groups \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Example

{
  "success": true,
  "groups": [
    {
      "_id": "64a1b2c3d4e5f6789abcdef0",
      "name": "JavaScript Learners",
      "slug": "javascript-learners",
      "description": "A community for everyone learning JavaScript",
      "icon": "🚀",
      "isOfficial": true,
      "memberCount": 1247,
      "postCount": 856,
      "isMember": true
    },
    {
      "_id": "64a1b2c3d4e5f6789abcdef1",
      "name": "Python Developers",
      "slug": "python-developers",
      "description": "Share Python projects, tips, and ask questions",
      "icon": "🐍",
      "isOfficial": false,
      "memberCount": 892,
      "postCount": 543,
      "isMember": false
    }
  ]
}

Create Group

Authentication

This endpoint requires user authentication.

Authorization: Bearer <user_token>

Request Body

string

required

Name of the group (1-60 characters, will be trimmed)

string

Description of the group (max 200 characters, will be trimmed)

string

Emoji or icon for the group (default: 💬)

Response

boolean

Indicates whether the group was created successfully

object

The newly created group object (same structure as Get Groups response)

string

Error message if success is false

Code Example

const response = await fetch('https://api.skillrise.com/api/community/groups', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    name: 'React Enthusiasts',
    description: 'Discuss React patterns, hooks, and best practices',
    icon: '⚛️'
  })
});

const data = await response.json();
console.log(data.group);

import requests

url = 'https://api.skillrise.com/api/community/groups'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
}
payload = {
    'name': 'React Enthusiasts',
    'description': 'Discuss React patterns, hooks, and best practices',
    'icon': '⚛️'
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data['group'])

curl -X POST https://api.skillrise.com/api/community/groups \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "name": "React Enthusiasts",
    "description": "Discuss React patterns, hooks, and best practices",
    "icon": "⚛️"
  }'

Response Example

Success

{
  "success": true,
  "group": {
    "_id": "64a1b2c3d4e5f6789abcdef2",
    "name": "React Enthusiasts",
    "slug": "react-enthusiasts",
    "description": "Discuss React patterns, hooks, and best practices",
    "icon": "⚛️",
    "isOfficial": false,
    "memberCount": 1,
    "postCount": 0,
    "isMember": true
  }
}

Duplicate Name

{
  "success": false,
  "message": "A group with this name already exists"
}

Toggle Group Membership

Authentication

This endpoint requires user authentication.

Authorization: Bearer <user_token>

Path Parameters

string

required

The unique identifier of the group

Response

boolean

Indicates whether the operation was successful

boolean

New membership status (true if joined, false if left)

Code Example

const groupId = '64a1b2c3d4e5f6789abcdef0';

const response = await fetch(
  `https://api.skillrise.com/api/community/groups/${groupId}/membership`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();
console.log(`Now ${data.isMember ? 'member' : 'not a member'}`);

import requests

group_id = '64a1b2c3d4e5f6789abcdef0'
url = f'https://api.skillrise.com/api/community/groups/{group_id}/membership'
headers = {'Authorization': 'Bearer YOUR_TOKEN'}

response = requests.post(url, headers=headers)
data = response.json()
print(f"Now {'member' if data['isMember'] else 'not a member'}")

curl -X POST https://api.skillrise.com/api/community/groups/64a1b2c3d4e5f6789abcdef0/membership \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Example

Joined

{
  "success": true,
  "isMember": true
}

Left

{
  "success": true,
  "isMember": false
}

Notes

Groups are sorted by official status first, then by member count (descending)
The slug is automatically generated from the group name
Group creators are automatically made members of the group
Toggling membership is idempotent - calling it multiple times toggles between joined/left states
Official groups can only be created by platform administrators
Group names must be unique (case-insensitive)

Overview

Course API

User API

AI Features API

Quiz API

Community API

Educator API

Admin API

Webhooks

Get All Groups

Authentication

Response

Code Example

Response Example

Create Group

Authentication

Request Body

Response

Code Example

Response Example

Toggle Group Membership

Authentication

Path Parameters

Response

Code Example

Response Example

Notes

​Get All Groups

​Authentication

​Response

​Code Example

​Response Example

​Create Group

​Authentication

​Request Body

​Response

​Code Example

​Response Example

​Toggle Group Membership

​Authentication

​Path Parameters

​Response

​Code Example

​Response Example

​Notes

Get All Groups

Authentication

Response

Code Example

Response Example

Create Group

Authentication

Request Body

Response

Code Example

Response Example

Toggle Group Membership

Authentication

Path Parameters

Response

Code Example

Response Example

Notes