POST/api/v1/classes

Create Class

Create a new live classroom session.

Authentication required: All requests must include the X-API-Key header. Manage your keys from the Developer API page.

Required Headers

Header	Value
X-API-Key	your_api_key_here
Content-Type	application/json

Request Body

json

{
  "title": "Introduction to Calculus",
  "startTime": "2026-03-20T10:00:00Z",
  "duration": 60,
  "strict": true,
  "teacherId": "teacher_123"
}

Example Response200 OK

json

{
  "status": "success",
  "data": {
    "sessionId": "session_abc123",
    "teacherLink": "https://board.tutorarc.com/board?id=session_abc123&role=teacher",
    "studentLink": "https://board.tutorarc.com/join?id=session_abc123"
  }
}

cURL Example

bash

curl -X POST \
  https://api.tutorarc.cloud/api/v1/classes \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"
  -d '{"title":"Introduction to Calculus","startTime":"2026-03-20T10:00:00Z","duration":60,"strict":true,"teacherId":"teacher_123"}'

Pro Tip: Use your API Key directly in the X-API-Key header. No Bearer token or OAuth is required.

Try it out

cURL

bash

curl -X POST "https://api.tutorarc.cloud/api/v1/classes" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Introduction to Calculus",
    "startTime": "2026-03-20T10:00:00Z",
    "duration": 60,
    "strict": true,
    "teacherId": "teacher_123"
  }'

Javascript

javascript

fetch("https://api.tutorarc.cloud/api/v1/classes", {
  method: "POST",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    title: "Introduction to Calculus",
    startTime: "2026-03-20T10:00:00Z",
    duration: 60,
    strict: true,
    teacherId: "teacher_123"
  })
})
.then(response => response.json())
.then(data => console.log(data));

TypeScript

typescript

interface CreateClassData {
  title: string;
  startTime: string;
  duration: number;
  strict: boolean;
  teacherId: string;
}

const createClass = async (data: CreateClassData) => {
  const response = await fetch("https://api.tutorarc.cloud/api/v1/classes", {
    method: "POST",
    headers: {
      "X-API-Key": "your_api_key_here",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(data)
  });
  return response.json();
};

Python

python

import requests

url = "https://api.tutorarc.cloud/api/v1/classes"
headers = {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
}
payload = {
    "title": "Introduction to Calculus",
    "startTime": "2026-03-20T10:00:00Z",
    "duration": 60,
    "strict": True,
    "teacherId": "teacher_123"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())