Community Replies

Create Reply

Authentication

This endpoint requires user authentication.

Authorization: Bearer <user_token>

Path Parameters

string

required

The unique identifier of the post to reply to

Request Body

string

required

Reply content (1-3000 characters, will be trimmed)

Response

boolean

Indicates whether the reply was created successfully

object

The newly created reply object

Show reply object

string

Unique identifier for the reply

string

The ID of the parent post

string

Reply content

string

Display name of the reply author

string

URL of the author’s profile image

boolean

Always true for newly created reply

number

Number of upvotes (0 for new reply)

boolean

Whether the authenticated user has upvoted (false for new reply)

boolean

Whether this reply is marked as the accepted answer

string

ISO 8601 timestamp of creation

string

Error message if success is false

Code Examples

const postId = '64a1b2c3d4e5f6789abcdef0';

const response = await fetch(
  `https://api.skillrise.com/api/community/posts/${postId}/replies`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN'
    },
    body: JSON.stringify({
      content: 'Great question! Here are some tips for optimizing React renders...'
    })
  }
);

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

import requests

post_id = '64a1b2c3d4e5f6789abcdef0'
url = f'https://api.skillrise.com/api/community/posts/{post_id}/replies'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
}
payload = {
    'content': 'Great question! Here are some tips for optimizing React renders...'
}

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

curl -X POST https://api.skillrise.com/api/community/posts/64a1b2c3d4e5f6789abcdef0/replies \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "content": "Great question! Here are some tips for optimizing React renders..."
  }'

Response Example

Success

{
  "success": true,
  "reply": {
    "_id": "64a1b2c3d4e5f6789abcdef5",
    "postId": "64a1b2c3d4e5f6789abcdef0",
    "content": "Great question! Here are some tips for optimizing React renders...",
    "authorName": "John Smith",
    "authorImage": "https://example.com/john-avatar.jpg",
    "isAuthor": true,
    "upvoteCount": 0,
    "isUpvoted": false,
    "isAcceptedAnswer": false,
    "createdAt": "2024-03-15T14:25:00.000Z"
  }
}

Post Not Found

{
  "success": false,
  "message": "Post not found"
}

Missing Content

{
  "success": false,
  "message": "Reply content is required"
}

Toggle Reply Upvote

Authentication

This endpoint requires user authentication.

Authorization: Bearer <user_token>

Path Parameters

string

required

The unique identifier of the post

string

required

The unique identifier of the reply

Response

boolean

Indicates whether the operation was successful

number

Updated upvote count

boolean

New upvote status (true if upvoted, false if removed)

string

Error message if success is false

Code Examples

const postId = '64a1b2c3d4e5f6789abcdef0';
const replyId = '64a1b2c3d4e5f6789abcdef5';

const response = await fetch(
  `https://api.skillrise.com/api/community/posts/${postId}/replies/${replyId}/upvote`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();
console.log(`Upvotes: ${data.upvoteCount}, Upvoted: ${data.isUpvoted}`);

import requests

post_id = '64a1b2c3d4e5f6789abcdef0'
reply_id = '64a1b2c3d4e5f6789abcdef5'
url = f'https://api.skillrise.com/api/community/posts/{post_id}/replies/{reply_id}/upvote'
headers = {'Authorization': 'Bearer YOUR_TOKEN'}

response = requests.post(url, headers=headers)
data = response.json()
print(f"Upvotes: {data['upvoteCount']}, Upvoted: {data['isUpvoted']}")

curl -X POST https://api.skillrise.com/api/community/posts/64a1b2c3d4e5f6789abcdef0/replies/64a1b2c3d4e5f6789abcdef5/upvote \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Example

Upvoted

{
  "success": true,
  "upvoteCount": 5,
  "isUpvoted": true
}

Removed Upvote

{
  "success": true,
  "upvoteCount": 4,
  "isUpvoted": false
}

Reply Not Found

{
  "success": false,
  "message": "Reply not found"
}

Accept Answer

Authentication

This endpoint requires user authentication. Only the post author can accept answers.

Authorization: Bearer <user_token>

Path Parameters

string

required

The unique identifier of the post

string

required

The unique identifier of the reply to accept

Response

boolean

Indicates whether the operation was successful

boolean

New acceptance status (true if accepted)

boolean

Whether the post is now marked as resolved

string

Error message if success is false

Code Examples

const postId = '64a1b2c3d4e5f6789abcdef0';
const replyId = '64a1b2c3d4e5f6789abcdef5';

const response = await fetch(
  `https://api.skillrise.com/api/community/posts/${postId}/replies/${replyId}/accept`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();
console.log('Answer accepted:', data.isAcceptedAnswer);

import requests

post_id = '64a1b2c3d4e5f6789abcdef0'
reply_id = '64a1b2c3d4e5f6789abcdef5'
url = f'https://api.skillrise.com/api/community/posts/{post_id}/replies/{reply_id}/accept'
headers = {'Authorization': 'Bearer YOUR_TOKEN'}

response = requests.patch(url, headers=headers)
data = response.json()
print(f"Answer accepted: {data['isAcceptedAnswer']}")

curl -X PATCH https://api.skillrise.com/api/community/posts/64a1b2c3d4e5f6789abcdef0/replies/64a1b2c3d4e5f6789abcdef5/accept \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Example

Answer Accepted

{
  "success": true,
  "isAcceptedAnswer": true,
  "postResolved": true
}

Not Post Author

{
  "success": false,
  "message": "Only the post author can accept an answer"
}

Reply Not Found

{
  "success": false,
  "message": "Reply not found"
}

Behavior Notes

Reply Creation

Reply content is limited to 3000 characters and will be trimmed
Creating a reply increments the post’s replyCount
The reply author’s name and image are automatically fetched from the user profile

Upvoting Replies

Upvoting is a toggle action - calling the endpoint again removes the upvote
Users can upvote their own replies
The response includes the updated upvote count and the user’s new upvote status

Accepting Answers

Only the post author can accept answers
Only one reply can be accepted at a time per post
Accepting a reply automatically marks the post as resolved
Calling the endpoint on an already-accepted reply unaccepts it (toggles)
When a reply is accepted, all other replies on that post are automatically unaccepted
Accepted answers appear first when retrieving replies (sorted by isAcceptedAnswer: true first)

Reply Sorting

When fetching a post with replies (via GET /api/community/posts/:postId):

Accepted answer appears first (if any)
Other replies sorted by creation date (oldest first)

Permissions

Action	Requirement
Create Reply	Authenticated user
Upvote Reply	Authenticated user
Accept Answer	Post author only

Error Responses

All endpoints return consistent error formats:

Authentication Required

{
  "success": false,
  "message": "Authentication required"
}

Not Authorized

{
  "success": false,
  "message": "Not authorized"
}

Server Error

{
  "success": false,
  "message": "An unexpected error occurred"
}

Overview

Course API

User API

AI Features API

Quiz API

Community API

Educator API

Admin API

Webhooks

Create Reply

Authentication

Path Parameters

Request Body

Response

Code Examples

Response Example

Toggle Reply Upvote

Authentication

Path Parameters

Response

Code Examples

Response Example

Accept Answer

Authentication

Path Parameters

Response

Code Examples

Response Example

Behavior Notes

Reply Creation

Upvoting Replies

Accepting Answers

Reply Sorting

Permissions

Error Responses

​Create Reply

​Authentication

​Path Parameters

​Request Body

​Response

​Code Examples

​Response Example

​Toggle Reply Upvote

​Authentication

​Path Parameters

​Response

​Code Examples

​Response Example

​Accept Answer

​Authentication

​Path Parameters

​Response

​Code Examples

​Response Example

​Behavior Notes

​Reply Creation

​Upvoting Replies

​Accepting Answers

​Reply Sorting

​Permissions

​Error Responses

Create Reply

Authentication

Path Parameters

Request Body

Response

Code Examples

Response Example

Toggle Reply Upvote

Authentication

Path Parameters

Response

Code Examples

Response Example

Accept Answer

Authentication

Path Parameters

Response

Code Examples

Response Example

Behavior Notes

Reply Creation

Upvoting Replies

Accepting Answers

Reply Sorting

Permissions

Error Responses