Educator Applications

{
  "success": true,
  "applications": [
    {
      "_id": "65a1b2c3d4e5f6789abcdef0",
      "userId": "user_2abc123def456",
      "professionalTitle": "Senior Full-Stack Developer",
      "bio": "I have 8 years of experience in web development and have been teaching programming for the past 3 years. I'm passionate about helping others learn to code and build amazing applications.",
      "expertise": [
        "JavaScript",
        "React",
        "Node.js",
        "MongoDB",
        "Web Development"
      ],
      "linkedinUrl": "https://linkedin.com/in/johnsmith",
      "status": "pending",
      "rejectionReason": "",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "_id": "65a1b2c3d4e5f6789abcdef1",
      "userId": "user_3xyz789ghi012",
      "professionalTitle": "Data Science Consultant",
      "bio": "PhD in Computer Science with specialization in Machine Learning. I've worked with Fortune 500 companies on AI solutions and love making complex topics accessible.",
      "expertise": [
        "Python",
        "Machine Learning",
        "Data Science",
        "TensorFlow",
        "Statistics"
      ],
      "linkedinUrl": "https://linkedin.com/in/sarahjohnson",
      "status": "approved",
      "rejectionReason": "",
      "createdAt": "2024-01-14T14:20:00.000Z",
      "updatedAt": "2024-01-14T16:45:00.000Z"
    },
    {
      "_id": "65a1b2c3d4e5f6789abcdef2",
      "userId": "user_4mno345pqr678",
      "professionalTitle": "Freelance Developer",
      "bio": "I build websites.",
      "expertise": [
        "HTML",
        "CSS"
      ],
      "linkedinUrl": "",
      "status": "rejected",
      "rejectionReason": "Application does not demonstrate sufficient teaching experience or depth of expertise. Please provide more details about your background and expand your expertise areas.",
      "createdAt": "2024-01-13T09:15:00.000Z",
      "updatedAt": "2024-01-13T11:30:00.000Z"
    }
  ]
}

Get All Applications

Retrieve all educator applications with optional filtering by status.

Authentication

string

required

Bearer token with admin role required

Query Parameters

string

Filter applications by status. Available values:

pending - Applications awaiting review
approved - Approved applications
rejected - Rejected applications

If not specified, returns all applications regardless of status

Response

boolean

Indicates if the request was successful

array

Array of applications sorted by submission date (newest first)

Show Application object

string

Application unique identifier (MongoDB ObjectId)

string

Clerk user ID of the applicant

string

Applicant’s professional title (e.g., “Senior Software Engineer”)

string

Applicant’s biography and teaching background

array

Array of expertise areas/topics the applicant can teach

string

LinkedIn profile URL (optional, can be empty string)

string

Current status of the application:

pending - Under review
approved - Approved, educator role granted
rejected - Rejected with optional reason

string

Reason for rejection (empty if not rejected)

string

ISO 8601 timestamp when the application was submitted

string

ISO 8601 timestamp when the application was last updated

{
  "success": true,
  "applications": [
    {
      "_id": "65a1b2c3d4e5f6789abcdef0",
      "userId": "user_2abc123def456",
      "professionalTitle": "Senior Full-Stack Developer",
      "bio": "I have 8 years of experience in web development and have been teaching programming for the past 3 years. I'm passionate about helping others learn to code and build amazing applications.",
      "expertise": [
        "JavaScript",
        "React",
        "Node.js",
        "MongoDB",
        "Web Development"
      ],
      "linkedinUrl": "https://linkedin.com/in/johnsmith",
      "status": "pending",
      "rejectionReason": "",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "_id": "65a1b2c3d4e5f6789abcdef1",
      "userId": "user_3xyz789ghi012",
      "professionalTitle": "Data Science Consultant",
      "bio": "PhD in Computer Science with specialization in Machine Learning. I've worked with Fortune 500 companies on AI solutions and love making complex topics accessible.",
      "expertise": [
        "Python",
        "Machine Learning",
        "Data Science",
        "TensorFlow",
        "Statistics"
      ],
      "linkedinUrl": "https://linkedin.com/in/sarahjohnson",
      "status": "approved",
      "rejectionReason": "",
      "createdAt": "2024-01-14T14:20:00.000Z",
      "updatedAt": "2024-01-14T16:45:00.000Z"
    },
    {
      "_id": "65a1b2c3d4e5f6789abcdef2",
      "userId": "user_4mno345pqr678",
      "professionalTitle": "Freelance Developer",
      "bio": "I build websites.",
      "expertise": [
        "HTML",
        "CSS"
      ],
      "linkedinUrl": "",
      "status": "rejected",
      "rejectionReason": "Application does not demonstrate sufficient teaching experience or depth of expertise. Please provide more details about your background and expand your expertise areas.",
      "createdAt": "2024-01-13T09:15:00.000Z",
      "updatedAt": "2024-01-13T11:30:00.000Z"
    }
  ]
}

Approve Application

Approve an educator application and grant the user educator role in Clerk.

Authentication

string

required

Bearer token with admin role required

Path Parameters

string

required

Application ID (MongoDB ObjectId)

Response

boolean

Indicates if the approval was successful

string

Confirmation message

{
  "success": true,
  "message": "Application approved. Educator role granted."
}

{
  "success": false,
  "message": "Application not found."
}

Side Effects

Updates application status to approved
Clears any existing rejectionReason
Updates user’s Clerk public metadata with role: 'educator'
User can now create and publish courses

Example Request

curl -X PATCH "https://api.skillrise.com/api/admin/educator-applications/65a1b2c3d4e5f6789abcdef0/approve" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN"

const response = await fetch(
  'https://api.skillrise.com/api/admin/educator-applications/65a1b2c3d4e5f6789abcdef0/approve',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_ADMIN_TOKEN'
    }
  }
);

const data = await response.json();

Reject Application

Reject an educator application with an optional reason.

Authentication

string

required

Bearer token with admin role required

Path Parameters

string

required

Application ID (MongoDB ObjectId)

Request Body

string

Reason for rejection (will be visible to the applicant)

Response

boolean

Indicates if the rejection was successful

string

Confirmation message

{
  "success": true,
  "message": "Application rejected."
}

{
  "success": false,
  "message": "Application not found."
}

Side Effects

Updates application status to rejected
Stores the rejection reason (if provided)
User can resubmit a new application later
Previous rejection reason will be cleared upon resubmission

Example Requests

curl -X PATCH "https://api.skillrise.com/api/admin/educator-applications/65a1b2c3d4e5f6789abcdef0/reject" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Application does not demonstrate sufficient teaching experience. Please provide more details about your background and reapply."
  }'

curl -X PATCH "https://api.skillrise.com/api/admin/educator-applications/65a1b2c3d4e5f6789abcdef0/reject" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

const response = await fetch(
  'https://api.skillrise.com/api/admin/educator-applications/65a1b2c3d4e5f6789abcdef0/reject',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_ADMIN_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      reason: 'Insufficient teaching experience demonstrated.'
    })
  }
);

const data = await response.json();

Notes

Applications can only be approved or rejected once they are in pending status
Rejected users can resubmit applications, which will overwrite their previous submission
Approving an application automatically grants the educator role in Clerk
The reason field is optional but recommended to provide feedback to applicants
All admin endpoints require the protectAdmin middleware authentication

Overview

Course API

User API

AI Features API

Quiz API

Community API

Educator API

Admin API

Webhooks

Educator Applications

Get All Applications

Authentication

Query Parameters

Response

Approve Application

Authentication

Path Parameters

Response

Side Effects

Example Request

Reject Application

Authentication

Path Parameters

Request Body

Response

Side Effects

Example Requests

Notes

​Get All Applications

​Authentication

​Query Parameters

​Response

​Approve Application

​Authentication

​Path Parameters

​Response

​Side Effects

​Example Request

​Reject Application

​Authentication

​Path Parameters

​Request Body

​Response

​Side Effects

​Example Requests

​Notes

Get All Applications

Authentication

Query Parameters

Response

Approve Application

Authentication

Path Parameters

Response

Side Effects

Example Request

Reject Application

Authentication

Path Parameters

Request Body

Response

Side Effects

Example Requests

Notes