> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Course Lesson

> 챕터 내 개별 학습 단위로, 텍스트, 동영상, PDF 또는 평가 콘텐츠를 포함할 수 있습니다.

```json Example theme={null}
{
	"assessment_questions": [
		{
			"correct_answer": "<string>",
			"created_at": "2023-12-01T05:00:00.401Z",
			"id": "crsaq_xxxxxxxxxxxx",
			"image": {
				"content_type": "image/jpeg",
				"filename": "document.pdf",
				"id": "<string>",
				"url": "https://media.whop.com/abc123/optimized.jpg"
			},
			"options": [
				{
					"id": "crsaqo_xxxxxxxxxxx",
					"is_correct": true,
					"option_text": "<string>",
					"order": 42
				}
			],
			"order": 42,
			"question_text": "<string>",
			"question_type": "short_answer"
		}
	],
	"attachments": [
		{
			"content_type": "image/jpeg",
			"filename": "document.pdf",
			"id": "<string>",
			"url": "https://media.whop.com/abc123/optimized.jpg"
		}
	],
	"content": "In this lesson, we will cover the basics of technical analysis...",
	"created_at": "2023-12-01T05:00:00.401Z",
	"days_from_course_start_until_unlock": 42,
	"embed_id": "dQw4w9WgXcQ",
	"embed_type": "youtube",
	"id": "lesn_xxxxxxxxxxxxx",
	"lesson_type": "text",
	"main_pdf": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"order": 42,
	"thumbnail": {
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"title": "Understanding Candlestick Patterns",
	"video_asset": {
		"asset_id": "<string>",
		"audio_only": true,
		"created_at": "2023-12-01T05:00:00.401Z",
		"duration_seconds": 42,
		"finished_uploading_at": "2023-12-01T05:00:00.401Z",
		"id": "mux_xxxxxxxxxxxxxx",
		"playback_id": "<string>",
		"signed_playback_id": "<string>",
		"signed_storyboard_playback_token": "<string>",
		"signed_thumbnail_playback_token": "<string>",
		"signed_video_playback_token": "<string>",
		"status": "uploading",
		"updated_at": "2023-12-01T05:00:00.401Z"
	},
	"visibility": "visible"
}
```

**assessment\_questions** `array\<object\>` *required*

퀴즈 또는 지식 확인 레슨의 질문 목록입니다. 평가 유형이 아닌 레슨에서는 비어 있습니다.

**하위 속성**

**correct\_answer** `string | null` *required*

질문의 정답입니다. 단답형 질문에 사용됩니다. 관리자(courses:update 권한이 있는 사용자)에게만 표시됩니다

**created\_at** `string\<date-time\>` *required*

평가 질문이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

평가 질문의 고유 식별자입니다.

예시: `crsaq_xxxxxxxxxxxx`

**image** `object | null` *required*

질문에 대한 선택적 이미지 첨부 파일

**하위 속성**

**content\_type** `string | null` *required*

업로드된 파일의 MIME 유형입니다(예: image/jpeg, video/mp4, audio/mpeg).

예시: `image/jpeg`

**filename** `string | null` *required*

파일 확장자를 포함한 업로드된 첨부 파일의 원본 파일 이름입니다.

예시: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**options** `array\<object\>` *required*

객관식/다중 선택 질문의 답변 옵션

**하위 속성**

**id** `string` *required*

평가 질문 옵션의 고유 식별자입니다.

예시: `crsaqo_xxxxxxxxxxx`

**is\_correct** `boolean | null` *required*

이 옵션이 정답인지 여부입니다. 관리자(courses:update 권한이 있는 사용자)에게만 표시됩니다

**option\_text** `string` *required*

답변 옵션의 텍스트

**order** `integer` *required*

질문 내에서 이 옵션의 순서

예시: `42`

**order** `integer` *required*

레슨 내에서 질문의 순서

예시: `42`

**question\_text** `string` *required*

질문의 텍스트

**question\_type** `CoursesAssessmentQuestionTypes` *required*

질문의 유형

사용 가능한 옵션: `short_answer`, `true_false`, `multiple_choice`, `multiple_select`

**attachments** `array\<object\>` *required*

이 레슨에 첨부된 모든 보조 파일로, 페이지네이션된 연결이 아닌 평면 배열로 반환됩니다.

**하위 속성**

**content\_type** `string | null` *required*

업로드된 파일의 MIME 유형입니다(예: image/jpeg, video/mp4, audio/mpeg).

예시: `image/jpeg`

**filename** `string | null` *required*

파일 확장자를 포함한 업로드된 첨부 파일의 원본 파일 이름입니다.

예시: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**content** `string | null` *required*

레슨의 Markdown 콘텐츠 본문입니다. 레슨에 텍스트 콘텐츠가 없으면 Null입니다.

예시: `In this lesson, we will cover the basics of technical ana…`

**created\_at** `string\<date-time\>` *required*

레슨이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**days\_from\_course\_start\_until\_unlock** `integer | null` *required*

학생이 코스를 시작한 후 이 레슨에 접근할 수 있게 되기까지의 일수입니다. 레슨을 즉시 이용할 수 있으면 Null입니다.

예시: `42`

**embed\_id** `string | null` *required*

임베드된 동영상 레슨의 외부 동영상 식별자입니다(예: YouTube 동영상 ID 또는 Loom 공유 ID). 레슨에 임베드가 없으면 Null입니다.

예시: `dQw4w9WgXcQ`

**embed\_type** `EmbedTypes | null` *required*

임베드된 동영상의 플랫폼 유형입니다. youtube, loom 중 하나입니다. 레슨에 임베드가 없으면 Null입니다.

사용 가능한 옵션: `youtube`, `loom`

**id** `string` *required*

레슨의 고유 식별자입니다.

예시: `lesn_xxxxxxxxxxxxx`

**lesson\_type** `LessonTypes` *required*

이 레슨의 콘텐츠 형식입니다. text, video, pdf, multi, quiz, knowledge\_check 중 하나입니다.

사용 가능한 옵션: `text`, `video`, `pdf`, `multi`, `quiz`, `knowledge_check`

**main\_pdf** `object | null` *required*

PDF 유형 레슨의 기본 PDF 문서입니다. 이 레슨이 PDF 레슨이 아니거나 PDF가 업로드되지 않은 경우 Null입니다.

**하위 속성**

**content\_type** `string | null` *required*

업로드된 파일의 MIME 유형입니다(예: image/jpeg, video/mp4, audio/mpeg).

예시: `image/jpeg`

**filename** `string | null` *required*

파일 확장자를 포함한 업로드된 첨부 파일의 원본 파일 이름입니다.

예시: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**order** `integer` *required*

상위 챕터 내에서 이 레슨의 정렬 위치이며, 0부터 시작합니다.

예시: `42`

**thumbnail** `object | null` *required*

레슨 카드와 미리보기에 표시되는 썸네일 이미지입니다. 썸네일이 업로드되지 않은 경우 Null입니다.

**하위 속성**

**url** `string | null` *required*

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**title** `string` *required*

학생에게 표시되는 레슨의 표시 이름입니다. 최대 120자입니다.

예시: `Understanding Candlestick Patterns`

**video\_asset** `object | null` *required*

동영상 유형 레슨의 Mux 동영상 에셋으로, 스트리밍 재생에 사용됩니다. 이 레슨에 호스팅된 동영상이 없으면 Null입니다.

**하위 속성**

**asset\_id** `string | null` *required*

Mux에서 제공한 에셋 ID

**audio\_only** `boolean` *required*

이 에셋이 오디오만 포함하는지 여부

**created\_at** `string\<date-time\>` *required*

Mux 에셋이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**duration\_seconds** `integer | null` *required*

동영상 길이(초)

예시: `42`

**finished\_uploading\_at** `string\<date-time\> | null` *required*

동영상 업로드가 완료된 시각

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

Mux 에셋의 고유 식별자입니다.

예시: `mux_xxxxxxxxxxxxxx`

**playback\_id** `string | null` *required*

Mux 에셋의 공개 재생 ID

**signed\_playback\_id** `string | null` *required*

Mux 에셋의 서명된 재생 ID

**signed\_storyboard\_playback\_token** `string | null` *required*

Mux 에셋의 서명된 스토리보드 재생 토큰

**signed\_thumbnail\_playback\_token** `string | null` *required*

Mux 에셋의 서명된 썸네일 재생 토큰

**signed\_video\_playback\_token** `string | null` *required*

Mux 에셋의 서명된 동영상 재생 토큰

**status** `MuxAssetStatuses` *required*

Mux 에셋의 상태

사용 가능한 옵션: `uploading`, `created`, `ready`

**updated\_at** `string\<date-time\>` *required*

Mux 에셋이 마지막으로 업데이트된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**visibility** `LessonVisibilities` *required*

이 레슨이 학생에게 표시되는지 여부를 제어하는 공개 설정입니다. visible, hidden 중 하나입니다.

사용 가능한 옵션: `visible`, `hidden`


## Related topics

- [Create course lesson](https://docs.whop.com/ko/api-reference/legacy/course-lessons/create-course-lesson.md)
- [Retrieve course lesson](https://docs.whop.com/ko/api-reference/legacy/course-lessons/retrieve-course-lesson.md)
- [List course lessons](https://docs.whop.com/ko/api-reference/legacy/course-lessons/list-course-lessons.md)
