name	course-content
description	Get or add homeworks and projects to courses via API using curl

Course Content API

Overview

This skill provides commands to get and create homeworks and projects for courses via the API endpoint. All items are created with state=CLOSED (not visible to students).

Configuration

Production instance: https://courses.datatalks.club
Dev instance: https://dev.courses.datatalks.club
Auth token: Available as AUTH_TOKEN environment variable

API Endpoint

GET /data/<course_slug>/content - Get all homeworks and projects
POST /data/<course_slug>/content - Create new homeworks and projects

Full URLs:

Production: https://courses.datatalks.club/data/<course_slug>/content
Dev: https://dev.courses.datatalks.club/data/<course_slug>/content

Authentication

# Get auth token from env
TOKEN=${AUTH_TOKEN}

# Or set it manually
TOKEN="your-token-here"

Getting Course Content (GET)

curl -X GET "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}"

Response:

{
  "success": true,
  "course": "course-slug",
  "homeworks": [
    {
      "id": 123,
      "slug": "hw-1",
      "title": "Homework 1",
      "due_date": "2025-03-15T23:59:59Z",
      "state": "CL",
      "questions_count": 5
    }
  ],
  "projects": [
    {
      "id": 456,
      "slug": "project-1",
      "title": "Project 1",
      "submission_due_date": "2025-03-20T23:59:59Z",
      "peer_review_due_date": "2025-03-27T23:59:59Z",
      "state": "CL"
    }
  ]
}

Creating Homeworks

Basic Homework (No Questions)

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "homeworks": [
      {
        "name": "Homework 1",
        "slug": "hw-1",
        "due_date": "2025-03-15T23:59:59Z",
        "description": "Optional description"
      }
    ]
  }'

Homework With Questions

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "homeworks": [
      {
        "name": "Homework: SQL Basics",
        "slug": "hw-sql-basics",
        "due_date": "2025-03-15T23:59:59Z",
        "description": "Practice SQL queries",
        "questions": [
          {
            "text": "What does SQL stand for?",
            "question_type": "MC",
            "answer_type": "EXS",
            "possible_answers": ["Structured Query Language", "Simple Query Language", "Standard Query Language"],
            "correct_answer": "1",
            "scores_for_correct_answer": 1
          },
          {
            "text": "Write a SELECT statement to get all users from the 'users' table",
            "question_type": "FF",
            "answer_type": "CTS",
            "correct_answer": "SELECT",
            "scores_for_correct_answer": 2
          }
        ]
      }
    ]
  }'

Multiple Homeworks

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "homeworks": [
      {
        "name": "Week 1: Introduction",
        "due_date": "2025-03-01T23:59:59Z"
      },
      {
        "name": "Week 2: Data Types",
        "due_date": "2025-03-08T23:59:59Z"
      },
      {
        "name": "Week 3: Functions",
        "due_date": "2025-03-15T23:59:59Z"
      }
    ]
  }'

Creating Projects

Basic Project

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "projects": [
      {
        "name": "Project 1: Build a Dashboard",
        "slug": "project-1-dashboard",
        "submission_due_date": "2025-03-20T23:59:59Z",
        "peer_review_due_date": "2025-03-27T23:59:59Z",
        "description": "Create an interactive dashboard"
      }
    ]
  }'

Multiple Projects

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "projects": [
      {
        "name": "Project 1: ETL Pipeline",
        "submission_due_date": "2025-03-20T23:59:59Z",
        "peer_review_due_date": "2025-03-27T23:59:59Z"
      },
      {
        "name": "Project 2: ML Model",
        "submission_due_date": "2025-04-10T23:59:59Z",
        "peer_review_due_date": "2025-04-17T23:59:59Z"
      }
    ]
  }'

Creating Both Homeworks and Projects

curl -X POST "https://courses.datatalks.club/data/<course_slug>/content" \
  -H "Authorization: Token ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "homeworks": [
      {
        "name": "Homework 1",
        "due_date": "2025-03-15T23:59:59Z"
      }
    ],
    "projects": [
      {
        "name": "Project 1",
        "submission_due_date": "2025-03-20T23:59:59Z",
        "peer_review_due_date": "2025-03-27T23:59:59Z"
      }
    ]
  }'

Field Reference

Homework Fields

Field	Required	Description
`name`	Yes	Homework title
`slug`	No	URL-friendly identifier (auto-generated from name if omitted)
`due_date`	Yes	Due date in ISO 8601 format (e.g., `2025-03-15T23:59:59Z`)
`description`	No	Homework description (defaults to empty string)
`questions`	No	Array of question objects

Question Fields

Field	Required	Description
`text`	No	Question text
`question_type`	No	`MC`, `FF`, `FL`, or `CB` (defaults to `FF`)
`answer_type`	No	`ANY`, `FLT`, `INT`, `EXS`, or `CTS`
`possible_answers`	No	Array of answer options (for MC/CB)
`correct_answer`	No	Correct answer (index for MC/CB, value for others)
`scores_for_correct_answer`	No	Points for correct answer (default: 1)

Project Fields

Field	Required	Description
`name`	Yes	Project title
`slug`	No	URL-friendly identifier (auto-generated from name if omitted)
`submission_due_date`	Yes	Submission deadline in ISO 8601 format
`peer_review_due_date`	Yes	Peer review deadline in ISO 8601 format
`description`	No	Project description (defaults to empty string)

Question Types

Code	Name	Description
`MC`	Multiple Choice	Single correct answer from a list of options
`FF`	Free Form	Short text answer (1-2 sentences)
`FL`	Free Form Long	Long text answer (essays, explanations)
`CB`	Checkboxes	Multiple correct answers from a list of options

Answer Types

Code	Name	Description
`ANY`	Any	Any input is accepted (no validation)
`FLT`	Float	Decimal number validation (e.g., 3.14, -0.5)
`INT`	Integer	Whole number validation (e.g., 1, 42, -7)
`EXS`	Exact String	Answer must match exactly (case-sensitive)
`CTS`	Contains String	Answer must contain the specified text

Date Formats

Both ISO formats are supported:

2025-03-15T23:59:59Z (UTC with Z)
2025-03-15T23:59:59+00:00 (UTC with offset)

Response Format

GET Response

{
  "success": true,
  "course": "course-slug",
  "homeworks": [
    {
      "id": 123,
      "slug": "hw-1",
      "title": "Homework 1",
      "due_date": "2025-03-15T23:59:59Z",
      "state": "CL",
      "questions_count": 5
    }
  ],
  "projects": [
    {
      "id": 456,
      "slug": "project-1",
      "title": "Project 1",
      "submission_due_date": "2025-03-20T23:59:59Z",
      "peer_review_due_date": "2025-03-27T23:59:59Z",
      "state": "CL"
    }
  ]
}

POST Response

{
  "success": true,
  "course": "course-slug",
  "created_homeworks": [
    {
      "id": 123,
      "slug": "hw-1",
      "title": "Homework 1",
      "due_date": "2025-03-15T23:59:59Z",
      "state": "CL",
      "questions_count": 2
    }
  ],
  "created_projects": [
    {
      "id": 456,
      "slug": "project-1",
      "title": "Project 1",
      "submission_due_date": "2025-03-20T23:59:59Z",
      "peer_review_due_date": "2025-03-27T23:59:59Z",
      "state": "CL"
    }
  ],
  "errors": []
}

Error Handling

Partial success is supported - if some items fail, others are still created:

{
  "success": true,
  "course": "ml-zoomcamp",
  "created_homeworks": [
    {"id": 123, "slug": "hw-1", ...}
  ],
  "created_projects": [],
  "errors": [
    {"homework": "Duplicate", "error": "Homework with this slug already exists"}
  ]
}

Common Errors

Error	Cause	Solution
`Authentication token required`	Missing/invalid token	Check `AUTH_TOKEN` env var
`Course not found`	Invalid course slug	Verify course exists
`already exists`	Slug conflict	Use a different slug
`Invalid date format`	Malformed date	Use ISO 8601 format

course-content

Install Skill

SKILL.md