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

# Cours

> Un module d'apprentissage structuré contenant des chapitres et des leçons, appartenant à une expérience.

```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*

Indique si les étudiants reçoivent un certificat PDF après avoir terminé toutes les leçons de ce cours. Null si le paramètre n'a pas été configuré.

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

Une liste ordonnée de tous les chapitres de ce cours, triés selon leur position d'affichage.

**attributs enfants**

**id** `string` *required*

L'identifiant unique du chapitre.

Exemple : `chap_xxxxxxxxxxxxx`

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

Une liste ordonnée des leçons de ce chapitre, triées par position d'affichage. Les leçons masquées sont exclues pour les utilisateurs non administrateurs.

**attributs enfants**

**id** `string` *required*

L'identifiant unique de la leçon.

Exemple : `lesn_xxxxxxxxxxxxx`

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

Le format de contenu de cette leçon. L'une des valeurs : text, video, pdf, multi, quiz, knowledge\_check.

Options disponibles : `text`, `video`, `pdf`, `multi`, `quiz`, `knowledge_check`

**order** `integer` *required*

La position de tri de cette leçon au sein de son chapitre parent, en commençant à zéro.

Exemple : `42`

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

L'image miniature affichée sur les cartes et aperçus de leçon. Null si aucune miniature n'a été téléversée.

**attributs enfants**

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

Une URL pré-optimisée pour afficher cette pièce jointe côté client. Elle doit être utilisée pour afficher les pièces jointes dans les applications.

Exemple : `https://media.whop.com/abc123/optimized.jpg`

**title** `string` *required*

Le nom d'affichage de la leçon présenté aux étudiants. 120 caractères maximum.

Exemple : `Understanding Candlestick Patterns`

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

L'asset vidéo Mux des leçons de type vidéo, utilisé pour la lecture en streaming. Null si cette leçon n'a pas de vidéo hébergée.

**attributs enfants**

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

La durée de la vidéo en secondes

Exemple : `42`

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

L'ID de lecture signé de l'asset Mux

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

Le jeton de lecture signé de la miniature de l'asset Mux

**order** `integer` *required*

La position de tri de ce chapitre au sein de son cours parent, en commençant à zéro.

Exemple : `42`

**title** `string` *required*

Le nom d'affichage du chapitre présenté aux étudiants. 150 caractères maximum.

Exemple : `Getting Started`

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

Le nombre total de chapitres de ce cours, y compris les chapitres dont toutes les leçons sont masquées pour l'utilisateur actuel.

Exemple : `42`

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

Le nombre de leçons de ce cours que l'utilisateur actuel a marquées comme terminées. Zéro lorsque la requête n'est pas effectuée au nom d'un utilisateur.

Exemple : `42`

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

L'URL de l'image de couverture du cours affichée sur les cartes d'aperçu. Null si aucune image de couverture n'a été téléversée.

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

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

La date et l'heure de création du cours.

Exemple : `2023-12-01T05:00:00.401Z`

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

Un bref résumé du contenu et des objectifs du cours. Null si aucune description n'a été définie.

Exemple : `Learn advanced trading strategies from industry experts.`

**id** `string` *required*

L'identifiant unique du cours.

Exemple : `cors_xxxxxxxxxxxxx`

**language** `Languages` *required*

La langue parlée du contenu vidéo, utilisée pour générer des sous-titres précis. L'une des valeurs : en, es, it, pt, de, fr, pl, ru, nl, ca, tr, sv, uk, no, fi, sk, el, cs, hr, da, ro, bg.

Options disponibles : `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*

L'horodatage de création de la leçon la plus récemment ajoutée visible par l'utilisateur actuel. Null si le cours n'a aucune leçon.

Exemple : `2023-12-01T05:00:00.401Z`

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

Les calendriers de diffusion progressive distincts, en jours après le début du cours, des leçons visibles par l'utilisateur actuel. Combinez-les avec startedAt pour déterminer lesquelles sont déverrouillées. Vide lorsque l'utilisateur n'a pas commencé le cours ou qu'aucune leçon n'est soumise à un calendrier.

**order** `string` *required*

La position de tri de ce cours au sein de son expérience parente, sous forme de nombre décimal pour un ordonnancement flexible.

Exemple : `123.45`

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

Indique si les étudiants doivent terminer chaque leçon dans l'ordre avant de passer à la suivante.

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

La leçon à partir de laquelle l'utilisateur actuel doit reprendre : sa première leçon non terminée, ou la première leçon s'il a terminé le cours, ne l'a pas commencé ou peut le modifier. Null si le cours n'a aucune leçon.

**attributs enfants**

**id** `string` *required*

L'identifiant unique de la leçon.

Exemple : `lesn_xxxxxxxxxxxxx`

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

Le moment le plus ancien auquel l'utilisateur actuel est connu pour avoir commencé ce cours. Null s'il ne l'a pas commencé. Les calendriers de déverrouillage progressif sont calculés à partir de ce moment.

Exemple : `2023-12-01T05:00:00.401Z`

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

Un court slogan marketing affiché sous le titre du cours. Null si aucun slogan n'a été défini.

Exemple : `Master the fundamentals in 30 days`

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

L'image miniature affichée sur les cartes et aperçus de cours. Null si aucune miniature n'a été téléversée.

**attributs enfants**

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

Type MIME du fichier téléversé, comme image/jpeg, video/mp4 ou audio/mpeg.

Exemple : `image/jpeg`

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

Le nom de fichier d'origine de la pièce jointe téléversée, extension comprise.

Exemple : `document.pdf`

**id** `string` *required*

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

Une URL pré-optimisée pour afficher cette pièce jointe côté client. Elle doit être utilisée pour afficher les pièces jointes dans les applications.

Exemple : `https://media.whop.com/abc123/optimized.jpg`

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

L'URL source d'origine de la pièce jointe, comme un lien direct vers S3. Elle ne doit jamais être affichée côté client et doit toujours passer par un transformateur Imgproxy.

Exemple : `https://media.whop.com/abc123/original.jpg`

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

Le nom d'affichage du cours présenté aux étudiants. Null si aucun titre n'a été défini.

Exemple : `Introduction to Technical Analysis`

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

La durée cumulée en secondes de toutes les vidéos hébergées dans les leçons visibles par l'utilisateur actuel.

Exemple : `42`

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

Le nombre de leçons de ce cours visibles par l'utilisateur actuel.

Exemple : `42`

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

La date et l'heure de la dernière mise à jour du cours.

Exemple : `2023-12-01T05:00:00.401Z`

**visibility** `CourseVisibilities` *required*

Le paramètre de visibilité qui détermine si ce cours est affiché aux étudiants. L'une des valeurs : visible, hidden.

Options disponibles : `visible`, `hidden`


## Related topics

- [Chapitre de cours](https://docs.whop.com/fr/api-reference/legacy/course-chapters/course-chapter.md)
- [Leçon de cours](https://docs.whop.com/fr/api-reference/legacy/course-lessons/course-lesson.md)
- [Étudiant d'un cours](https://docs.whop.com/fr/api-reference/legacy/course-students/course-student.md)
