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

> 경험에 속하며 챕터와 레슨으로 구성된 체계적인 학습 모듈입니다.

```json Example theme={null}
{
	"certificate_after_completion_enabled": true,
	"chapters": [
		{
			"id": "chap_xxxxxxxxxxxxx",
			"lessons": [
				{
					"id": "lesn_xxxxxxxxxxxxx",
					"lesson_type": "text",
					"order": 42,
					"thumbnail": {
						"url": "https://media.whop.com/abc123/optimized.jpg"
					},
					"title": "Understanding Candlestick Patterns",
					"video_asset": {
						"duration_seconds": 42,
						"signed_playback_id": "<string>",
						"signed_thumbnail_playback_token": "<string>"
					}
				}
			],
			"order": 42,
			"title": "Getting Started"
		}
	],
	"chapters_count": 42,
	"completed_lessons_count": 42,
	"cover_image": "https://assets.whop.com/images/course-cover.jpg",
	"created_at": "2023-12-01T05:00:00.401Z",
	"description": "Learn advanced trading strategies from industry experts.",
	"id": "cors_xxxxxxxxxxxxx",
	"language": "en",
	"latest_lesson_created_at": "2023-12-01T05:00:00.401Z",
	"lesson_unlock_days": [42],
	"order": "123.45",
	"require_completing_lessons_in_order": true,
	"resume_lesson": {
		"id": "lesn_xxxxxxxxxxxxx"
	},
	"started_at": "2023-12-01T05:00:00.401Z",
	"tagline": "Master the fundamentals in 30 days",
	"thumbnail": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"optimized_url": "https://media.whop.com/abc123/optimized.jpg",
		"source_url": "https://media.whop.com/abc123/original.jpg"
	},
	"title": "Introduction to Technical Analysis",
	"total_duration_seconds": 42,
	"total_lessons_count": 42,
	"updated_at": "2023-12-01T05:00:00.401Z",
	"visibility": "visible"
}
```

**certificate\_after\_completion\_enabled** `boolean | null` *required*

학생이 이 코스의 모든 레슨을 완료한 후 PDF 수료증을 받는지 여부입니다. 설정이 구성되지 않은 경우 Null입니다.

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

이 코스의 모든 챕터를 표시 위치순으로 정렬한 목록입니다.

**하위 속성**

**id** `string` *required*

챕터의 고유 식별자입니다.

예시: `chap_xxxxxxxxxxxxx`

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

이 챕터의 레슨을 표시 위치순으로 정렬한 목록입니다. 관리자가 아닌 사용자에게는 숨겨진 레슨이 제외됩니다.

**하위 속성**

**id** `string` *required*

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

예시: `lesn_xxxxxxxxxxxxx`

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

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

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

**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입니다.

**하위 속성**

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

동영상 길이(초)

예시: `42`

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

Mux 에셋의 서명된 재생 ID

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

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

**order** `integer` *required*

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

예시: `42`

**title** `string` *required*

학생에게 표시되는 챕터의 표시 이름입니다. 최대 150자입니다.

예시: `Getting Started`

**chapters\_count** `integer` *required*

현재 사용자에게 모든 레슨이 숨겨진 챕터를 포함한, 이 코스의 총 챕터 수입니다.

예시: `42`

**completed\_lessons\_count** `integer` *required*

현재 사용자가 이 코스에서 완료로 표시한 레슨 수입니다. 사용자를 대신하여 요청하지 않은 경우 0입니다.

예시: `42`

**cover\_image** `string | null` *required*

미리보기 카드에 표시되는 코스 커버 이미지의 URL입니다. 커버 이미지가 업로드되지 않은 경우 Null입니다.

예시: `https://assets.whop.com/images/course-cover.jpg`

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

코스가 생성된 일시입니다.

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

**description** `string | null` *required*

코스 콘텐츠와 목표에 대한 간략한 요약입니다. 설명이 설정되지 않은 경우 Null입니다.

예시: `Learn advanced trading strategies from industry experts.`

**id** `string` *required*

코스의 고유 식별자입니다.

예시: `cors_xxxxxxxxxxxxx`

**language** `Languages` *required*

정확한 자막 생성에 사용되는 동영상 콘텐츠의 음성 언어입니다. en, es, it, pt, de, fr, pl, ru, nl, ca, tr, sv, uk, no, fi, sk, el, cs, hr, da, ro, bg 중 하나입니다.

사용 가능한 옵션: `en`, `es`, `it`, `pt`, `de`, `fr`, `pl`, `ru`, `nl`, `ca`, `tr`, `sv`, `uk`, `no`, `fi`, `sk`, `el`, `cs`, `hr`, `da`, `ro`, `bg`

**latest\_lesson\_created\_at** `string\<date-time\> | null` *required*

현재 사용자에게 표시되는 가장 최근에 추가된 레슨의 생성 타임스탬프입니다. 코스에 레슨이 없으면 Null입니다.

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

**lesson\_unlock\_days** `array\<integer\>` *required*

현재 사용자에게 표시되는 레슨들의 고유한 드립 일정으로, 코스 시작 후 일수로 표시됩니다. startedAt과 함께 사용하여 어떤 레슨이 잠금 해제되었는지 확인하세요. 사용자가 코스를 시작하지 않았거나 일정이 지정된 레슨이 없으면 비어 있습니다.

**order** `string` *required*

상위 경험 내에서 이 코스의 정렬 위치로, 유연한 정렬을 위해 소수로 표시됩니다.

예시: `123.45`

**require\_completing\_lessons\_in\_order** `boolean` *required*

학생이 다음 레슨으로 넘어가기 전에 각 레슨을 순서대로 완료해야 하는지 여부입니다.

**resume\_lesson** `object | null` *required*

현재 사용자가 이어서 학습할 레슨입니다. 완료하지 않은 첫 번째 레슨이며, 코스를 완료했거나 시작하지 않았거나 편집할 수 있는 경우에는 첫 번째 레슨입니다. 코스에 레슨이 없으면 Null입니다.

**하위 속성**

**id** `string` *required*

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

예시: `lesn_xxxxxxxxxxxxx`

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

현재 사용자가 이 코스를 시작한 것으로 확인된 가장 이른 시각입니다. 시작하지 않은 경우 Null입니다. 드립 잠금 해제 일정은 이 시점부터 계산됩니다.

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

**tagline** `string | null` *required*

코스 제목 아래에 표시되는 짧은 마케팅 태그라인입니다. 태그라인이 설정되지 않은 경우 Null입니다.

예시: `Master the fundamentals in 30 days`

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

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

**하위 속성**

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

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

예시: `image/jpeg`

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

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

예시: `document.pdf`

**id** `string` *required*

**optimized\_url** `string | null` *required*

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

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

**source\_url** `string | null` *required*

첨부 파일의 원본 소스 URL입니다(예: S3 직접 링크). 클라이언트에 절대 표시해서는 안 되며, 항상 Imgproxy 변환기를 거쳐야 합니다.

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

**title** `string | null` *required*

학생에게 표시되는 코스의 표시 이름입니다. 제목이 설정되지 않은 경우 Null입니다.

예시: `Introduction to Technical Analysis`

**total\_duration\_seconds** `integer` *required*

현재 사용자에게 표시되는 레슨 전체에 걸친 모든 호스팅 동영상의 총 재생 시간(초)입니다.

예시: `42`

**total\_lessons\_count** `integer` *required*

현재 사용자에게 표시되는 이 코스의 레슨 수입니다.

예시: `42`

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

코스가 마지막으로 업데이트된 일시입니다.

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

**visibility** `CourseVisibilities` *required*

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

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


## Related topics

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