Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
spaces
/
{space_id}
/
courseworks
Create a new coursework item (lesson, quiz, or section)
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id}/courseworks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "<string>",
  "parent_id": 123,
  "title": "<string>",
  "description": "<string>",
  "status": "<string>",
  "completion_criteria": "<string>",
  "unlocking_criteria": "<string>"
}'
{
  "id": "1234",
  "created_at": "2025-11-21T21:15:34+00:00",
  "updated_at": "2025-11-21T21:15:34+00:00",
  "space_id": 123,
  "type": "<string>",
  "parent_id": 123,
  "parent_type": "<string>",
  "title": "<string>",
  "description": "<string>",
  "status": "<string>",
  "position": 123,
  "completion_criteria": "<string>",
  "unlocking_criteria": "<string>",
  "children_count": 123,
  "permalink": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
space_id
integer
required

The ID of the course (space) to create coursework in

​
network_id
required

The Network's unique integer ID, or subdomain Unique numeric network ID

Body

application/json

Submit results as JSON

Coursework items (lessons, quizzes, sections) within a course

​
type
string
required

The type of coursework to create (lesson, quiz, or section)

​
parent_id
integer

The ID of the parent coursework item (section or overview). If omitted, defaults to course overview

​
title
string

The title of the coursework item

​
description
string

The description/body content of the coursework item

​
status
string

The visibility status (posted, hidden, pending). Defaults to hidden

​
completion_criteria
string

How completion is tracked (none, visited, button, video, minimum_correct_percentage)

​
unlocking_criteria
string

When content becomes available (none, sequential, time_from_course_join, scheduled_date)

Response

Returns the newly created coursework item

Coursework items (lessons, quizzes, sections) within a course

​
id
integer
required

The record's integer ID

Example:

"1234"

​
created_at
string<date-time>
required

The date and time the record was created

Example:

"2025-11-21T21:15:34+00:00"

​
updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2025-11-21T21:15:34+00:00"

​
space_id
integer
required

The ID of the course (space) this coursework belongs to

​
type
string
required

The type of coursework (lesson, quiz, section, or overview)

​
title
string
required

The title of the coursework item

​
status
string
required

The visibility status (posted, hidden, pending)

​
position
integer
required

The position within siblings (for ordering)

​
completion_criteria
string
required

How completion is tracked

​
unlocking_criteria
string
required

When content becomes available

​
children_count
integer
required

Number of direct children (for sections)

​
permalink
string<url>
required

The coursework item's unique address within the network

​
parent_id
integer

The ID of the parent coursework item (section or overview)

​
parent_type
string

The type of the parent (section or overview)

​
description
string

The description/body content of the coursework item