iblai-api-course-create

name	iblai-api-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.

iblai-api-course-create

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-api-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}.