---
name: activities-routes
description: Handle 20 OpenAPI operation(s) under /api/v1/activities for the activities route group.
---

# activities API Routes

Handle 20 OpenAPI operation(s) under /api/v1/activities for the activities route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

For visible lesson content, prefer `POST /api/v1/activities/` with
`activity_type=TYPE_DYNAMIC`, `activity_sub_type=SUBTYPE_DYNAMIC_MARKDOWN`,
markdown stored in `content`/`details`, `lock_type=public`, and `published=true`
unless the user asks for drafts. Always use the target chapter's own
`chapter_id`; do not attach every activity to the first chapter. On
`PUT /api/v1/activities/{activity_uuid}`, do not send `published_version`;
this LearnHouse backend rejects that field.

## Operations

### api_create_activity_api_v1_activities_post

- Operation ID: `api_create_activity_api_v1_activities_post`
- Route: `POST /api/v1/activities/`
- Mode: WRITE
- Summary: Create activity
- Body: JSON request body accepted.

### api_get_chapter_activities_api_v1_activities_chapter_663ab6bde2

- Operation ID: `api_get_chapter_activities_api_v1_activities_chapter_chapter_id_get`
- Route: `GET /api/v1/activities/chapter/{chapter_id}`
- Mode: READ
- Summary: List chapter activities
- Parameters:
  - `chapter_id` in `path` required

### api_create_documentpdf_activity_api_v1_activities_doc_0fa3c707b3

- Operation ID: `api_create_documentpdf_activity_api_v1_activities_documentpdf_post`
- Route: `POST /api/v1/activities/documentpdf`
- Mode: WRITE
- Summary: Create PDF document activity
- Body: JSON request body accepted.

### api_update_documentpdf_activity_api_v1_activities_doc_a4d82f2474

- Operation ID: `api_update_documentpdf_activity_api_v1_activities_documentpdf_activity_uuid_put`
- Route: `PUT /api/v1/activities/documentpdf/{activity_uuid}`
- Mode: WRITE
- Summary: Update PDF document activity
- Parameters:
  - `activity_uuid` in `path` required
- Body: JSON request body accepted.

### api_create_external_video_activity_api_v1_activities_6fccc29f5e

- Operation ID: `api_create_external_video_activity_api_v1_activities_external_video_post`
- Route: `POST /api/v1/activities/external_video`
- Mode: WRITE
- Summary: Create external video activity
- Body: JSON request body accepted.

### api_update_external_video_activity_api_v1_activities_231ea2dcf8

- Operation ID: `api_update_external_video_activity_api_v1_activities_external_video_activity_uui`
- Route: `PUT /api/v1/activities/external_video/{activity_uuid}`
- Mode: WRITE
- Summary: Update external video activity
- Parameters:
  - `activity_uuid` in `path` required
- Body: JSON request body accepted.

### api_get_activityby_id_api_v1_activities_id_activity_id_get

- Operation ID: `api_get_activityby_id_api_v1_activities_id_activity_id_get`
- Route: `GET /api/v1/activities/id/{activity_id}`
- Mode: READ
- Summary: Get activity by ID
- Parameters:
  - `activity_id` in `path` required

### api_create_video_activity_api_v1_activities_video_post

- Operation ID: `api_create_video_activity_api_v1_activities_video_post`
- Route: `POST /api/v1/activities/video`
- Mode: WRITE
- Summary: Create video activity
- Body: JSON request body accepted.

### api_update_video_activity_api_v1_activities_video_act_053ebe48d1

- Operation ID: `api_update_video_activity_api_v1_activities_video_activity_uuid_put`
- Route: `PUT /api/v1/activities/video/{activity_uuid}`
- Mode: WRITE
- Summary: Update hosted video activity
- Parameters:
  - `activity_uuid` in `path` required
- Body: JSON request body accepted.

### api_delete_activity_api_v1_activities_activity_uuid_delete

- Operation ID: `api_delete_activity_api_v1_activities_activity_uuid_delete`
- Route: `DELETE /api/v1/activities/{activity_uuid}`
- Mode: WRITE
- Summary: Delete activity
- Parameters:
  - `activity_uuid` in `path` required

### api_get_activity_api_v1_activities_activity_uuid_get

- Operation ID: `api_get_activity_api_v1_activities_activity_uuid_get`
- Route: `GET /api/v1/activities/{activity_uuid}`
- Mode: READ
- Summary: Get activity by UUID
- Parameters:
  - `activity_uuid` in `path` required

### api_update_activity_api_v1_activities_activity_uuid_put

- Operation ID: `api_update_activity_api_v1_activities_activity_uuid_put`
- Route: `PUT /api/v1/activities/{activity_uuid}`
- Mode: WRITE
- Summary: Update activity
- Parameters:
  - `activity_uuid` in `path` required
- Body: JSON request body accepted.

### api_get_editor_bootstrap_api_v1_activities_activity_u_05beca7477

- Operation ID: `api_get_editor_bootstrap_api_v1_activities_activity_uuid_editor_bootstrap_get`
- Route: `GET /api/v1/activities/{activity_uuid}/editor-bootstrap`
- Mode: READ
- Summary: Editor bootstrap payload
- Parameters:
  - `activity_uuid` in `path` required

### api_get_activity_state_api_v1_activities_activity_uuid_state_get

- Operation ID: `api_get_activity_state_api_v1_activities_activity_uuid_state_get`
- Route: `GET /api/v1/activities/{activity_uuid}/state`
- Mode: READ
- Summary: Get activity state
- Parameters:
  - `activity_uuid` in `path` required

### api_list_activity_usergroups_api_v1_activities_activi_cc7f8f474c

- Operation ID: `api_list_activity_usergroups_api_v1_activities_activity_uuid_usergroups_get`
- Route: `GET /api/v1/activities/{activity_uuid}/usergroups`
- Mode: READ
- Summary: List user groups assigned to a locked activity
- Parameters:
  - `activity_uuid` in `path` required

### api_remove_activity_usergroup_api_v1_activities_activ_413d0bb7de

- Operation ID: `api_remove_activity_usergroup_api_v1_activities_activity_uuid_usergroups_usergro`
- Route: `DELETE /api/v1/activities/{activity_uuid}/usergroups/{usergroup_uuid}`
- Mode: WRITE
- Summary: Revoke a user group's access to a locked activity
- Parameters:
  - `activity_uuid` in `path` required
  - `usergroup_uuid` in `path` required

### api_add_activity_usergroup_api_v1_activities_activity_07e359d60e

- Operation ID: `api_add_activity_usergroup_api_v1_activities_activity_uuid_usergroups_usergroup_`
- Route: `POST /api/v1/activities/{activity_uuid}/usergroups/{usergroup_uuid}`
- Mode: WRITE
- Summary: Grant a user group access to a locked activity
- Parameters:
  - `activity_uuid` in `path` required
  - `usergroup_uuid` in `path` required

### api_get_activity_versions_api_v1_activities_activity_d2be4ccb83

- Operation ID: `api_get_activity_versions_api_v1_activities_activity_uuid_versions_get`
- Route: `GET /api/v1/activities/{activity_uuid}/versions`
- Mode: READ
- Summary: List activity versions
- Parameters:
  - `activity_uuid` in `path` required
  - `limit` in `query`
  - `offset` in `query`

### api_get_activity_version_api_v1_activities_activity_u_f066c45e54

- Operation ID: `api_get_activity_version_api_v1_activities_activity_uuid_versions_version_number`
- Route: `GET /api/v1/activities/{activity_uuid}/versions/{version_number}`
- Mode: READ
- Summary: Get activity version
- Parameters:
  - `activity_uuid` in `path` required
  - `version_number` in `path` required

### api_restore_activity_version_api_v1_activities_activi_0e908d5dc6

- Operation ID: `api_restore_activity_version_api_v1_activities_activity_uuid_versions_version_nu`
- Route: `POST /api/v1/activities/{activity_uuid}/versions/{version_number}/restore`
- Mode: WRITE
- Summary: Restore activity version
- Parameters:
  - `activity_uuid` in `path` required
  - `version_number` in `path` required