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

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

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

- 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_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_restore_activity_version_api_v1_activities_activity_uuid_versions_version_nu

- 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

### api_get_editor_bootstrap_api_v1_activities_activity_uuid_editor_bootstrap_get

- 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_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_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_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_get_chapter_activities_api_v1_activities_chapter_chapter_id_get

- 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_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_create_external_video_activity_api_v1_activities_external_video_post

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

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

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

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

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

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

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

- 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