> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learnway.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin Guide

> Administrative operations: course management, user moderation, translations, revenue controls, and system monitoring.

# Admin Guide

This guide covers operational workflows for administrators utilizing the LearnWay Admin API (`/api/v2/admin/*`).

***

## 1. Creating and Publishing Courses

1. **Create Learning Path**: `POST /api/v2/admin/learning-path`
2. **Create Course**: `POST /api/v2/admin/course` (assign `learningPathId`, difficulty, title, description).
3. **Upload Course Cover**: `POST /api/v2/admin/course/:id/cover-image`
4. **Add Lessons & Slides**: `POST /api/v2/admin/lesson` and `POST /api/v2/admin/lesson-slide`
5. **Publish Course**: `PATCH /api/v2/admin/course/:id/publish` (sets `isPublished = true`).

***

## 2. On-Chain Course Registration

For courses granting blockchain-verifiable completion certificates:

```http theme={null}
POST /api/v2/certificates/admin/register-course
Authorization: Bearer <admin_token>
Content-Type: application/json

{
  "courseId": "550e8400-e29b-41d4-a716-446655440000",
  "onChainCourseId": 101,
  "instructorName": "Dr. Satoshi"
}
```

***

## 3. User Moderation & Suspensions

Admins can manage abusive accounts via:

* **Suspend Account**: `POST /api/v2/admin/users/:id/suspend`
* **Unsuspend Account**: `POST /api/v2/admin/users/:id/unsuspend`
* **Grant Promotional Subscription**: `POST /api/v2/admin/users/:id/grant-subscription`