Skip to main content
POST
/
courses
Create
curl --request POST \
  --url https://api.mapademics.com/v1/courses \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "name": "Introduction to Computer Science",
  "code": "CS101",
  "description": "<string>",
  "sections": [
    {
      "name": "Fall 2024 - Section A",
      "description": "<string>",
      "instructorId": "<string>",
      "syllabusHref": "<string>"
    }
  ]
}'
{
  "id": "<string>",
  "organizationId": "<string>",
  "name": "<string>",
  "code": "<string>",
  "description": "<string>",
  "defaultSectionId": "<string>",
  "sections": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

extractSkills
boolean
default:false

Whether to automatically trigger skills extraction for all sections

Body

application/json
name
string
required

Course name

Example:

"Introduction to Computer Science"

code
string
required

Course code

Example:

"CS101"

sections
object[]
required

Array of sections to create with the course

Minimum length: 1
description
string | null

Course description

Response

Course created successfully

id
string
required
organizationId
string
required
name
string
required
code
string
required
sections
object[]
required

Array of section references

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
description
string | null
defaultSectionId
string
deletedAt
string<date-time> | null