---
name: admin-routes
description: Handle 37 OpenAPI operation(s) under /api/v1/admin/{org_slug} for the admin route group.
---

# admin API Routes

Handle 37 OpenAPI operation(s) under /api/v1/admin/{org_slug} for the admin 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_admin_issue_token_api_v1_admin_org_slug_auth_token_post

- Operation ID: `api_admin_issue_token_api_v1_admin_org_slug_auth_token_post`
- Route: `POST /api/v1/admin/{org_slug}/auth/token`
- Mode: WRITE
- Summary: Issue a user token
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_check_course_access_api_v1_admin_org_slug_courses_course_uuid_access_u

- Operation ID: `api_admin_check_course_access_api_v1_admin_org_slug_courses_course_uuid_access_u`
- Route: `GET /api/v1/admin/{org_slug}/courses/{course_uuid}/access/{user_id}`
- Mode: READ
- Summary: Check user course access
- Parameters:
  - `org_slug` in `path` required
  - `course_uuid` in `path` required
  - `user_id` in `path` required

### api_admin_bulk_unenroll_api_v1_admin_org_slug_enrollments_bulk_unenroll_post

- Operation ID: `api_admin_bulk_unenroll_api_v1_admin_org_slug_enrollments_bulk_unenroll_post`
- Route: `POST /api/v1/admin/{org_slug}/enrollments/bulk/unenroll`
- Mode: WRITE
- Summary: Bulk unenroll users from a course
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_enroll_user_api_v1_admin_org_slug_enrollments_user_id_course_uuid_post

- Operation ID: `api_admin_enroll_user_api_v1_admin_org_slug_enrollments_user_id_course_uuid_post`
- Route: `POST /api/v1/admin/{org_slug}/enrollments/{user_id}/{course_uuid}`
- Mode: WRITE
- Summary: Enroll user in course
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_unenroll_user_api_v1_admin_org_slug_enrollments_user_id_course_uuid_de

- Operation ID: `api_admin_unenroll_user_api_v1_admin_org_slug_enrollments_user_id_course_uuid_de`
- Route: `DELETE /api/v1/admin/{org_slug}/enrollments/{user_id}/{course_uuid}`
- Mode: WRITE
- Summary: Unenroll user from course
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_get_user_enrollments_api_v1_admin_org_slug_enrollments_user_id_get

- Operation ID: `api_admin_get_user_enrollments_api_v1_admin_org_slug_enrollments_user_id_get`
- Route: `GET /api/v1/admin/{org_slug}/enrollments/{user_id}`
- Mode: READ
- Summary: Get user enrollments
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_get_user_progress_api_v1_admin_org_slug_progress_user_id_course_uuid_g

- Operation ID: `api_admin_get_user_progress_api_v1_admin_org_slug_progress_user_id_course_uuid_g`
- Route: `GET /api/v1/admin/{org_slug}/progress/{user_id}/{course_uuid}`
- Mode: READ
- Summary: Get user progress in course
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_complete_activity_api_v1_admin_org_slug_progress_user_id_activities_ac

- Operation ID: `api_admin_complete_activity_api_v1_admin_org_slug_progress_user_id_activities_ac`
- Route: `POST /api/v1/admin/{org_slug}/progress/{user_id}/activities/{activity_uuid}/complete`
- Mode: WRITE
- Summary: Mark activity as completed
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `activity_uuid` in `path` required

### api_admin_uncomplete_activity_api_v1_admin_org_slug_progress_user_id_activities_

- Operation ID: `api_admin_uncomplete_activity_api_v1_admin_org_slug_progress_user_id_activities_`
- Route: `DELETE /api/v1/admin/{org_slug}/progress/{user_id}/activities/{activity_uuid}/complete`
- Mode: WRITE
- Summary: Undo activity completion
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `activity_uuid` in `path` required

### api_admin_complete_course_api_v1_admin_org_slug_progress_user_id_course_uuid_com

- Operation ID: `api_admin_complete_course_api_v1_admin_org_slug_progress_user_id_course_uuid_com`
- Route: `POST /api/v1/admin/{org_slug}/progress/{user_id}/{course_uuid}/complete`
- Mode: WRITE
- Summary: Mark entire course as completed
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_get_all_user_progress_api_v1_admin_org_slug_progress_user_id_get

- Operation ID: `api_admin_get_all_user_progress_api_v1_admin_org_slug_progress_user_id_get`
- Route: `GET /api/v1/admin/{org_slug}/progress/{user_id}`
- Mode: READ
- Summary: Get all user progress
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_get_user_trail_detail_api_v1_admin_org_slug_trails_user_id_get

- Operation ID: `api_admin_get_user_trail_detail_api_v1_admin_org_slug_trails_user_id_get`
- Route: `GET /api/v1/admin/{org_slug}/trails/{user_id}`
- Mode: READ
- Summary: Get user trail with full progress breakdown
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_get_user_course_trail_detail_api_v1_admin_org_slug_trails_user_id_cour

- Operation ID: `api_admin_get_user_course_trail_detail_api_v1_admin_org_slug_trails_user_id_cour`
- Route: `GET /api/v1/admin/{org_slug}/trails/{user_id}/courses/{course_uuid}`
- Mode: READ
- Summary: Get user trail breakdown for a single course
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_get_user_certificates_api_v1_admin_org_slug_certifications_user_id_get

- Operation ID: `api_admin_get_user_certificates_api_v1_admin_org_slug_certifications_user_id_get`
- Route: `GET /api/v1/admin/{org_slug}/certifications/{user_id}`
- Mode: READ
- Summary: Get user certificates
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_provision_user_api_v1_admin_org_slug_users_post

- Operation ID: `api_admin_provision_user_api_v1_admin_org_slug_users_post`
- Route: `POST /api/v1/admin/{org_slug}/users`
- Mode: WRITE
- Summary: Provision a user
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_remove_user_api_v1_admin_org_slug_users_user_id_delete

- Operation ID: `api_admin_remove_user_api_v1_admin_org_slug_users_user_id_delete`
- Route: `DELETE /api/v1/admin/{org_slug}/users/{user_id}`
- Mode: WRITE
- Summary: Remove a user from the organization
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_update_user_profile_api_v1_admin_org_slug_users_user_id_patch

- Operation ID: `api_admin_update_user_profile_api_v1_admin_org_slug_users_user_id_patch`
- Route: `PATCH /api/v1/admin/{org_slug}/users/{user_id}`
- Mode: WRITE
- Summary: Update a user's profile
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
- Body: JSON request body accepted.

### api_admin_get_user_by_email_api_v1_admin_org_slug_users_by_email_email_get

- Operation ID: `api_admin_get_user_by_email_api_v1_admin_org_slug_users_by_email_email_get`
- Route: `GET /api/v1/admin/{org_slug}/users/by-email/{email}`
- Mode: READ
- Summary: Look up a user by email
- Parameters:
  - `org_slug` in `path` required
  - `email` in `path` required

### api_admin_issue_magic_link_api_v1_admin_org_slug_auth_magic_link_post

- Operation ID: `api_admin_issue_magic_link_api_v1_admin_org_slug_auth_magic_link_post`
- Route: `POST /api/v1/admin/{org_slug}/auth/magic-link`
- Mode: WRITE
- Summary: Issue a magic sign-in link
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_magic_consume_api_v1_admin_org_slug_auth_magic_consume_get

- Operation ID: `api_admin_magic_consume_api_v1_admin_org_slug_auth_magic_consume_get`
- Route: `GET /api/v1/admin/{org_slug}/auth/magic-consume`
- Mode: READ
- Summary: Consume a magic sign-in link (browser-facing)
- Parameters:
  - `org_slug` in `path` required
  - `token` in `query` required

### api_admin_bulk_enroll_api_v1_admin_org_slug_enrollments_bulk_post

- Operation ID: `api_admin_bulk_enroll_api_v1_admin_org_slug_enrollments_bulk_post`
- Route: `POST /api/v1/admin/{org_slug}/enrollments/bulk`
- Mode: WRITE
- Summary: Bulk enroll users in a course
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_list_course_enrollments_api_v1_admin_org_slug_courses_course_uuid_enro

- Operation ID: `api_admin_list_course_enrollments_api_v1_admin_org_slug_courses_course_uuid_enro`
- Route: `GET /api/v1/admin/{org_slug}/courses/{course_uuid}/enrollments`
- Mode: READ
- Summary: List users enrolled in a course
- Parameters:
  - `org_slug` in `path` required
  - `course_uuid` in `path` required
  - `page` in `query`
  - `limit` in `query`

### api_admin_reset_user_progress_api_v1_admin_org_slug_progress_user_id_course_uuid

- Operation ID: `api_admin_reset_user_progress_api_v1_admin_org_slug_progress_user_id_course_uuid`
- Route: `POST /api/v1/admin/{org_slug}/progress/{user_id}/{course_uuid}/reset`
- Mode: WRITE
- Summary: Reset a user's progress in a course
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_award_certificate_api_v1_admin_org_slug_certifications_user_id_course_

- Operation ID: `api_admin_award_certificate_api_v1_admin_org_slug_certifications_user_id_course_`
- Route: `POST /api/v1/admin/{org_slug}/certifications/{user_id}/{course_uuid}/award`
- Mode: WRITE
- Summary: Manually award a certificate
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `course_uuid` in `path` required

### api_admin_revoke_certificate_api_v1_admin_org_slug_certifications_user_id_user_c

- Operation ID: `api_admin_revoke_certificate_api_v1_admin_org_slug_certifications_user_id_user_c`
- Route: `DELETE /api/v1/admin/{org_slug}/certifications/{user_id}/{user_certification_uuid}`
- Mode: WRITE
- Summary: Revoke a user's certificate
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
  - `user_certification_uuid` in `path` required

### api_admin_add_usergroup_member_api_v1_admin_org_slug_usergroups_usergroup_uuid_m

- Operation ID: `api_admin_add_usergroup_member_api_v1_admin_org_slug_usergroups_usergroup_uuid_m`
- Route: `POST /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}/members/{user_id}`
- Mode: WRITE
- Summary: Add a user to a user group
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required
  - `user_id` in `path` required

### api_admin_remove_usergroup_member_api_v1_admin_org_slug_usergroups_usergroup_uui

- Operation ID: `api_admin_remove_usergroup_member_api_v1_admin_org_slug_usergroups_usergroup_uui`
- Route: `DELETE /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}/members/{user_id}`
- Mode: WRITE
- Summary: Remove a user from a user group
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required
  - `user_id` in `path` required

### api_admin_change_user_role_api_v1_admin_org_slug_users_user_id_role_patch

- Operation ID: `api_admin_change_user_role_api_v1_admin_org_slug_users_user_id_role_patch`
- Route: `PATCH /api/v1/admin/{org_slug}/users/{user_id}/role`
- Mode: WRITE
- Summary: Change a user's org role
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required
- Body: JSON request body accepted.

### api_admin_create_usergroup_api_v1_admin_org_slug_usergroups_post

- Operation ID: `api_admin_create_usergroup_api_v1_admin_org_slug_usergroups_post`
- Route: `POST /api/v1/admin/{org_slug}/usergroups`
- Mode: WRITE
- Summary: Create a user group
- Parameters:
  - `org_slug` in `path` required
- Body: JSON request body accepted.

### api_admin_delete_usergroup_api_v1_admin_org_slug_usergroups_usergroup_uuid_delet

- Operation ID: `api_admin_delete_usergroup_api_v1_admin_org_slug_usergroups_usergroup_uuid_delet`
- Route: `DELETE /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}`
- Mode: WRITE
- Summary: Delete a user group
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required

### api_admin_list_usergroup_members_api_v1_admin_org_slug_usergroups_usergroup_uuid

- Operation ID: `api_admin_list_usergroup_members_api_v1_admin_org_slug_usergroups_usergroup_uuid`
- Route: `GET /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}/members`
- Mode: READ
- Summary: List members of a user group
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required
  - `page` in `query`
  - `limit` in `query`

### api_admin_get_user_groups_api_v1_admin_org_slug_users_user_id_groups_get

- Operation ID: `api_admin_get_user_groups_api_v1_admin_org_slug_users_user_id_groups_get`
- Route: `GET /api/v1/admin/{org_slug}/users/{user_id}/groups`
- Mode: READ
- Summary: List user groups a user belongs to
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_add_course_to_usergroup_api_v1_admin_org_slug_usergroups_usergroup_uui

- Operation ID: `api_admin_add_course_to_usergroup_api_v1_admin_org_slug_usergroups_usergroup_uui`
- Route: `POST /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}/courses/{course_uuid}`
- Mode: WRITE
- Summary: Grant a cohort access to a course
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required
  - `course_uuid` in `path` required

### api_admin_remove_course_from_usergroup_api_v1_admin_org_slug_usergroups_usergrou

- Operation ID: `api_admin_remove_course_from_usergroup_api_v1_admin_org_slug_usergroups_usergrou`
- Route: `DELETE /api/v1/admin/{org_slug}/usergroups/{usergroup_uuid}/courses/{course_uuid}`
- Mode: WRITE
- Summary: Revoke a cohort's access to a course
- Parameters:
  - `org_slug` in `path` required
  - `usergroup_uuid` in `path` required
  - `course_uuid` in `path` required

### api_admin_export_user_data_api_v1_admin_org_slug_users_user_id_export_get

- Operation ID: `api_admin_export_user_data_api_v1_admin_org_slug_users_user_id_export_get`
- Route: `GET /api/v1/admin/{org_slug}/users/{user_id}/export`
- Mode: READ
- Summary: Full GDPR data export for a user
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_anonymize_user_api_v1_admin_org_slug_users_user_id_anonymize_post

- Operation ID: `api_admin_anonymize_user_api_v1_admin_org_slug_users_user_id_anonymize_post`
- Route: `POST /api/v1/admin/{org_slug}/users/{user_id}/anonymize`
- Mode: WRITE
- Summary: GDPR right-to-be-forgotten
- Parameters:
  - `org_slug` in `path` required
  - `user_id` in `path` required

### api_admin_get_course_analytics_api_v1_admin_org_slug_courses_course_uuid_analyti

- Operation ID: `api_admin_get_course_analytics_api_v1_admin_org_slug_courses_course_uuid_analyti`
- Route: `GET /api/v1/admin/{org_slug}/courses/{course_uuid}/analytics`
- Mode: READ
- Summary: Aggregate stats for a course
- Parameters:
  - `org_slug` in `path` required
  - `course_uuid` in `path` required