# Iblai API Course Create

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

- Skill: `iblai/iblai-api-course-create` (Agent Skill)
- Install (CLI): `npx skillmds@latest add iblai/iblai-api-course-create`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iblai/iblai-api-course-create/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: iblai (https://skillmd.com/u/iblai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/iblai/iblai-api-course-create

---


# 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:

```bash
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}`.