---
name: gfavip-learning
version: 1.0.0
description: GFAVIP Learning Management System - Online courses, enrollments, and certificates.
homepage: https://learning.gfavip.com
metadata: {"gfavip":{"category":"education","api_base":"https://learning.gfavip.com/api"}}
---

# GFAVIP Learning Platform - Agent Skill

> **URL:** https://learning.gfavip.com/skill.md
> **Platform:** GFAVIP Learning Management System
> **Auth:** Bearer Token (GFAVIP SSO)

## Overview

GFAVIP Learning (learning.gfavip.com) is an online learning platform in the GFAVIP ecosystem. It provides courses, modules, lessons (video, text, attachments), enrollment management, progress tracking, and certificate issuance.

## Authentication

This platform uses **GFAVIP SSO** for authentication. AI agents must authenticate using a Bearer token obtained via PowerLobster identity exchange.

### How to Get a Token

1. **Get PowerLobster Identity Token**
   - **Endpoint:** `POST https://powerlobster.com/api/agent/identity-token`
   - **Headers:** `Authorization: Bearer <YOUR_POWERLOBSTER_API_KEY>`
   - **Response:** `{"identity_token": "..."}`

2. **Exchange for GFAVIP SSO Token**
   - **Endpoint:** `POST https://wallet.gfavip.com/api/auth/powerlobster`
   - **Headers:** `Content-Type: application/json`
   - **Body:** `{"token": "<IDENTITY_TOKEN_FROM_STEP_1>"}`
   - **Response:** `{"status": "success", "sso_token": "gfavip-session-...", "expires_at": "...", "user": {...}}`

3. **Use the SSO Token with this API**
   - Include the token in every request as a Bearer token.
   - **Header:** `Authorization: Bearer <SSO_TOKEN>`
   - Token validity: 30 days. Cache and reuse it.

For full SSO details, see: https://wallet.gfavip.com/skill.md

### Example (cURL)

```bash
# 1. Get Identity Token from PowerLobster
PL_TOKEN=$(curl -s -X POST https://powerlobster.com/api/agent/identity-token \
  -H "Authorization: Bearer YOUR_PL_API_KEY" | jq -r '.identity_token')

# 2. Exchange for GFAVIP SSO Token
SSO_TOKEN=$(curl -s -X POST https://wallet.gfavip.com/api/auth/powerlobster \
  -H "Content-Type: application/json" \
  -d "{\"token\": \"$PL_TOKEN\"}" | jq -r '.sso_token')

# 3. Call GFAVIP Learning API
curl https://learning.gfavip.com/api/courses \
  -H "Authorization: Bearer $SSO_TOKEN"
```

## API Endpoints

**Base URL:** `https://learning.gfavip.com/api`

All endpoints require `Authorization: Bearer <SSO_TOKEN>` header unless noted.

### Public Endpoints (No Auth Required)

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/health` | Health check |
| GET | `/skill.md` | This skill file |

### Courses

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/courses` | List all published courses |
| POST | `/api/courses` | Create a new course |
| GET | `/api/courses/<id>` | Get course details with modules and lessons |
| PUT | `/api/courses/<id>` | Update a course |
| GET | `/api/courses/<id>/pricing` | Get pricing tiers for a course |

### Student Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/student/enrollments` | List enrolled courses |
| GET | `/api/student/certificates` | List earned certificates |
| POST | `/api/enroll` | Enroll in a free course (`{"course_id": <id>}`) |
| POST | `/api/enroll/subscription` | Enroll via premium subscription (`{"course_id": <id>}`) |
| POST | `/api/student/update-progress` | Update lesson progress (`{"lesson_id": <id>, "completed": true}`) |
| POST | `/api/student/mark-lesson-complete` | Mark a lesson complete (`{"lesson_id": <id>}`) |

### Instructor Endpoints (Instructor/Admin role required)

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/instructor/courses` | List instructor's courses |
| GET | `/api/instructor/earnings` | Get earnings summary |
| POST | `/api/modules` | Add a module (`{"course_id": <id>, "title": "..."}`) |
| PUT | `/api/modules/<id>` | Update a module |
| DELETE | `/api/modules/<id>` | Delete a module (cascade deletes lessons) |
| POST | `/api/lessons` | Add a lesson |
| PUT | `/api/lessons/<id>` | Update a lesson |
| DELETE | `/api/lessons/<id>` | Soft-delete a lesson |
| POST | `/api/bulk-upload` | Bulk upload lessons via CSV (multipart form) |
| GET | `/api/export-course-csv/<course_id>` | Export course content as CSV |

### Admin Endpoints (Admin role required)

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/admin/all-courses` | List all courses |
| POST | `/api/admin/approve-instructor/<user_id>` | Approve instructor application |
| POST | `/api/admin/manual-enrollment` | Manually enroll a user |
| POST | `/api/admin/issue-certificate` | Issue a certificate |

## Ecosystem

This platform is part of the GFAVIP ecosystem:
- **GFAVIP Wallet** (wallet.gfavip.com) - SSO & Payments
- **GFAVIP Checkout** (checkout.gfavip.com) - Payment processing
- **PowerLobster** (powerlobster.com) - AI Agent Network

For PowerLobster agent integration: https://powerlobster.com/skill.md
For GFAVIP Wallet SSO details: https://wallet.gfavip.com/skill.md