iblai-course-create

name: iblai-course-create description: Programmatically generate, edit, and publish courses via the ibl.ai Course Creation API — create a task, generate an AI outline, run the full creation pipeline, then read the course outline, full structure, and draft unit content. Use to author courses from the API.

Generate, edit, and publish courses through the ibl.ai Course Creation API: spin up a task, let AI generate a course outline, run the full creation pipeline, then read the resulting outline, full structure, and draft unit content. Host root for every endpoint below is …/dm/api/ai-mentor/orgs/{org}/users/{username}/course-creation/.

Auth & conventions

Base URL: https://api.iblai.app
Header: Authorization: Api-Token $IBLAI_API_KEY on every request.
Path vars: {org} = $IBLAI_ORG, {username} = $IBLAI_USERNAME, {task_id} = a course-creation task's id, {course_id} = a created course's id.
Host root: …/dm/api/ai-mentor/orgs/{org}/users/{username}/course-creation/.
Not connected yet? Run /iblai-login first to populate IBLAI_ORG, IBLAI_USERNAME, and IBLAI_API_KEY.

Reads

Tasks

GET …/course-creation/tasks/ — list tasks.
GET …/course-creation/tasks/{task_id}/ — task detail / status (status flows Pending → Scheduled).
GET …/course-creation/tasks/{task_id}/start/ — start the full creation pipeline.
GET …/course-creation/tasks/{task_id}/cancel/ — cancel the pipeline.

Courses

GET …/course-creation/course/ — list courses (filter by task with ?task={task_id}).
GET …/course-creation/course/{course_id}/ — course detail.
GET …/course-creation/course/{course_id}/outline/ — outline (no component content).
GET …/course-creation/course/{course_id}/full-structure/ — full structure (add ?include_content=true for HTML).
GET …/course-creation/course/{course_id}/draft-content-for-all-units/ — draft content for all units.

Writes

Tasks

POST …/course-creation/tasks/ — create a task.
DELETE …/course-creation/tasks/{task_id}/ — delete a task. Destructive — confirm with the user first.
POST …/course-creation/tasks/{task_id}/create-course/ — create the course on the LMS.
POST …/course-creation/tasks/{task_id}/create-course-outline/ — generate the outline with AI.

Courses

DELETE …/course-creation/course/{course_id}/ — delete the course record. Destructive — confirm with the user first.
POST …/course-creation/course/{course_id}/draft-content-for-unit/ — draft content for one unit.

Example

Generate the AI outline for an existing task:

curl -X POST \
  "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/course-creation/tasks/$TASK_ID/create-course-outline/" \
  -H "Authorization: Api-Token $IBLAI_API_KEY"

Notes

Typical flow: create task → generate outline (AI) → start pipeline → read full-structure/ / draft content.
Task status flows Pending → Scheduled; poll …/tasks/{task_id}/ to track progress, and …/tasks/{task_id}/cancel/ to stop a running pipeline.
full-structure/ returns the structure without HTML by default — add ?include_content=true to include rendered component content.
List courses for a given task with …/course/?task={task_id}.