Creating & Configuring Classes

Before You Start

Understanding Class Components

Each UALS class consists of:

Step-by-Step: Creating a Class via UI

You are a software engineer at TechCorp working on a mission-critical
e-commerce platform. Your team needs to implement new features while
maintaining high code quality, security, and performance standards.

Creating Classes via API

Programmatic class creation is useful for bulk operations, integrations, and automated provisioning.

API Endpoint

POST /api/school/classes
Authorization: Bearer {token}
Content-Type: application/json

Request Body

{
  "title": "AP Computer Science A - Fall 2025",
  "description": "Advanced placement course covering Java programming, data structures, and algorithms.",
  "subject": "Computer Science",
  "gradeLevel": "High School",
  "dscId": "dsc-comp-prog",
  "language": "en",
  "scenarioContext": "You are a software engineering intern at a tech startup...",
  "itsAnalysisLevel": 3
}

Success Response

{
  "success": true,
  "class": {
    "id": "class-prog-abc123",
    "title": "AP Computer Science A - Fall 2025",
    "description": "Advanced placement course...",
    "subject": "Computer Science",
    "gradeLevel": "High School",
    "dscId": "dsc-comp-prog",
    "enrollmentCode": "ENROLL-XYZ789",
    "teacherEmail": "teacher@school.edu",
    "teacherName": "Dr. Jane Smith",
    "creatorEmail": "teacher@school.edu",
    "creatorName": "Dr. Jane Smith",
    "contentExperts": [],
    "createdAt": "2025-11-23T10:30:00.000Z"
  }
}

JavaScript Example

async function createClass(classData) {
  const response = await fetch('/api/school/classes', {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(classData)
  });

  if (!response.ok) {
    throw new Error('Failed to create class');
  }

  const result = await response.json();
  console.log('Class created:', result.class);
  return result.class;
}

const newClass = await createClass({
  title: "Introduction to AI Literacy",
  description: "Learn fundamental AI concepts and ethical considerations",
  subject: "Computer Science",
  gradeLevel: "College",
  dscId: "dsc-comp-ailc",
  language: "en"
});

Advanced Configuration Options

ITS Analysis Levels

The ITS (Intelligent Tutoring System) provides 10 levels of adaptive learning analysis, from lightweight (Level 1) to comprehensive (Level 10). Higher levels use more agents and provide deeper insights, but take longer to process.

Scenario Contexts for SBCAT

Scenario-Based Computer Adaptive Testing (SBCAT) uses narrative contexts to make assessments more engaging and authentic. Effective scenarios:

• Provide a clear role for the student (e.g., "You are a data analyst...")
• Establish realistic constraints and goals
• Connect to real-world applications
• Maintain consistency across all assessment items

You are a policy advisor for a city government evaluating AI systems
for public services. Your role is to assess AI proposals for fairness,
transparency, and ethical compliance. You need to understand AI capabilities,
limitations, and societal impacts to make informed recommendations.

You are a data scientist at a healthcare analytics company analyzing
patient outcomes to improve treatment protocols. Your work requires statistical
rigor, ethical data handling, clear visualization, and actionable insights
for medical professionals.

Managing Enrollment Codes

How Enrollment Codes Work

Each class has a unique enrollment code generated automatically at creation. Students use this code to join your class without needing manual approval.

Sharing Enrollment Codes

Recommended methods for distributing codes to students:

1. Learning Management System (LMS): Post in course announcements or syllabus
2. Email: Send directly to enrolled students
3. Printed Materials: Include in course handouts or syllabus
4. Class Website: Display on password-protected class page

Regenerating Enrollment Codes

If a code is compromised or you want to restrict new enrollments, you can regenerate the enrollment code through the class details modal.

PATCH /api/school/class/{classId}
{
  "enrollmentCode": "ENROLL-NEWCODE1"
}

Editing Class Details

What Can Be Modified

After creation, you can edit most class properties except the class ID:

• Class title
• Description
• Subject and grade level
• Scenario context
• ITS analysis level
• Language preference
• Enrollment code
• Class ID (immutable)
• DSC/Curriculum selection (requires new class)
• Original creator (immutable)

UI Workflow

API Workflow

async function updateClass(classId, updates) {
  const response = await fetch(`/api/school/class/${classId}`, {
    method: 'PATCH',
    credentials: 'include',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(updates)
  });

  const result = await response.json();
  console.log('Class updated:', result.class);
  return result.class;
}

await updateClass('class-ailc-abc123', {
  title: "Advanced AI Literacy - Spring 2026",
  itsAnalysisLevel: 4
});

Class Versioning & History

All class modifications are tracked in xAPI statements, creating a complete audit trail. This enables:

• Viewing who made changes and when
• Reverting to previous configurations if needed
• Compliance with educational record-keeping requirements
• Analytics on class evolution over time