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

# VClasses Documentation

> Welcome to VClasses — the online education platform for managing courses, PDF assignments, quizzes, and student grading.

VClasses is an online education platform that helps instructors and administrators deliver PDF-based homework and quizzes, collect student submissions, and provide detailed feedback — all through a simple REST API. Whether you're building an integration, automating grading workflows, or exploring what's possible, this documentation has you covered.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/docs/quickstart">
    Make your first API call in minutes and see VClasses in action.
  </Card>

  <Card title="Authentication" icon="key" href="/docs/authentication">
    Learn how to obtain and use your Bearer token for all API requests.
  </Card>

  <Card title="PDF Homework" icon="file-pdf" href="/docs/guides/managing-homework">
    Manage homework assignments, view submissions, and grade student work.
  </Card>

  <Card title="PDF Quizzes" icon="circle-question" href="/docs/guides/managing-quizzes">
    Distribute PDF quizzes, collect answers, and track student progress.
  </Card>
</CardGroup>

## What You Can Do with VClasses

VClasses gives admins and students a full workflow around PDF-based learning content:

* **Assign homework** — attach a PDF to any class, set a deadline and description, and students receive it automatically.
* **Collect submissions** — students upload their completed work as PDF files; submissions are stored with timestamps and downloadable as a zip.
* **Grade with feedback** — admins assign a numeric rating (1–10) and write comments on each submission. Grading is idempotent, so you can update grades any time.
* **Run PDF quizzes** — distribute PDF question sheets, track how many questions are included and the total grade, and collect student answer PDFs.
* **Review quiz submissions** — see each student's answer PDF alongside their awarded and total grade.

## Explore the API

<CardGroup cols={3}>
  <Card title="API Overview" icon="book" href="/docs/api-reference/overview">
    Base URL, versioning, and request format.
  </Card>

  <Card title="Homework Endpoints" icon="list-check" href="/docs/api-reference/homework/list">
    List, retrieve, and grade homework submissions.
  </Card>

  <Card title="Quiz Endpoints" icon="pen-to-square" href="/docs/api-reference/quizzes/list">
    List, retrieve, submit, and grade PDF quizzes.
  </Card>
</CardGroup>

<Steps>
  <Step title="Get your API token">
    Log in to VClasses and retrieve your Bearer token from your account settings. See [Authentication](/docs/authentication) for details.
  </Step>

  <Step title="Make your first request">
    Call `GET /api/v3/admin/homeworks` to list all homework classes with student submissions.
  </Step>

  <Step title="Grade a submission">
    Post a rating and comment to `POST /api/v3/admin/homeworks/grade/{id}` to provide feedback.
  </Step>

  <Step title="Explore the full API">
    Dive into the [API Reference](/docs/api-reference/overview) for every endpoint, parameter, and response schema.
  </Step>
</Steps>