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

# users API Routes

Handle 22 OpenAPI operation(s) under /api/v1/users for the users 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_get_current_user_api_v1_users_profile_get

- Operation ID: `api_get_current_user_api_v1_users_profile_get`
- Route: `GET /api/v1/users/profile`
- Mode: READ
- Summary: Get current user profile

### api_get_current_user_session_api_v1_users_session_get

- Operation ID: `api_get_current_user_session_api_v1_users_session_get`
- Route: `GET /api/v1/users/session`
- Mode: READ
- Summary: Get current user session

### api_get_authorization_status_api_v1_users_authorize_ressource_ressource_uuid_act

- Operation ID: `api_get_authorization_status_api_v1_users_authorize_ressource_ressource_uuid_act`
- Route: `GET /api/v1/users/authorize/ressource/{ressource_uuid}/action/{action}`
- Mode: READ
- Summary: Check authorization for resource action
- Parameters:
  - `ressource_uuid` in `path` required
  - `action` in `path` required

### api_create_user_with_orgid_api_v1_users_org_id_post

- Operation ID: `api_create_user_with_orgid_api_v1_users_org_id_post`
- Route: `POST /api/v1/users/{org_id}`
- Mode: WRITE
- Summary: Create user in organization
- Parameters:
  - `org_id` in `path` required
- Body: JSON request body accepted.

### api_create_user_with_orgid_and_invite_api_v1_users_org_id_invite_invite_code_pos

- Operation ID: `api_create_user_with_orgid_and_invite_api_v1_users_org_id_invite_invite_code_pos`
- Route: `POST /api/v1/users/{org_id}/invite/{invite_code}`
- Mode: WRITE
- Summary: Create user with invite code
- Parameters:
  - `invite_code` in `path` required
  - `org_id` in `path` required
- Body: JSON request body accepted.

### api_create_user_without_org_api_v1_users_post

- Operation ID: `api_create_user_without_org_api_v1_users_post`
- Route: `POST /api/v1/users/`
- Mode: WRITE
- Summary: Create user without organization
- Body: JSON request body accepted.

### api_get_user_by_id_api_v1_users_id_user_id_get

- Operation ID: `api_get_user_by_id_api_v1_users_id_user_id_get`
- Route: `GET /api/v1/users/id/{user_id}`
- Mode: READ
- Summary: Get user by ID
- Parameters:
  - `user_id` in `path` required

### api_get_user_by_uuid_api_v1_users_uuid_user_uuid_get

- Operation ID: `api_get_user_by_uuid_api_v1_users_uuid_user_uuid_get`
- Route: `GET /api/v1/users/uuid/{user_uuid}`
- Mode: READ
- Summary: Get user by UUID
- Parameters:
  - `user_uuid` in `path` required

### api_get_user_by_username_api_v1_users_username_username_get

- Operation ID: `api_get_user_by_username_api_v1_users_username_username_get`
- Route: `GET /api/v1/users/username/{username}`
- Mode: READ
- Summary: Get user by username
- Parameters:
  - `username` in `path` required

### api_update_user_api_v1_users_user_id_put

- Operation ID: `api_update_user_api_v1_users_user_id_put`
- Route: `PUT /api/v1/users/{user_id}`
- Mode: WRITE
- Summary: Update user
- Parameters:
  - `user_id` in `path` required
- Body: JSON request body accepted.

### api_update_avatar_user_api_v1_users_update_avatar_user_id_put

- Operation ID: `api_update_avatar_user_api_v1_users_update_avatar_user_id_put`
- Route: `PUT /api/v1/users/update_avatar/{user_id}`
- Mode: WRITE
- Summary: Update user avatar
- Parameters:
  - `user_id` in `path` required
- Body: JSON request body accepted.

### api_update_user_password_api_v1_users_change_password_user_id_put

- Operation ID: `api_update_user_password_api_v1_users_change_password_user_id_put`
- Route: `PUT /api/v1/users/change_password/{user_id}`
- Mode: WRITE
- Summary: Change user password
- Parameters:
  - `user_id` in `path` required
- Body: JSON request body accepted.

### api_change_password_with_reset_code_v2_api_v1_users_reset_password_change_passwo

- Operation ID: `api_change_password_with_reset_code_v2_api_v1_users_reset_password_change_passwo`
- Route: `POST /api/v1/users/reset_password/change_password`
- Mode: WRITE
- Summary: Change password with reset code
- Body: JSON request body accepted.

### api_change_password_with_reset_code_api_v1_users_reset_password_change_password_

- Operation ID: `api_change_password_with_reset_code_api_v1_users_reset_password_change_password_`
- Route: `POST /api/v1/users/reset_password/change_password/{email}`
- Mode: WRITE
- Summary: Change password with reset code (legacy path)
- Parameters:
  - `email` in `path` required
- Body: JSON request body accepted.

### api_send_password_reset_email_v2_api_v1_users_reset_password_send_reset_code_pos

- Operation ID: `api_send_password_reset_email_v2_api_v1_users_reset_password_send_reset_code_pos`
- Route: `POST /api/v1/users/reset_password/send_reset_code`
- Mode: WRITE
- Summary: Send password reset code
- Body: JSON request body accepted.

### api_send_password_reset_email_api_v1_users_reset_password_send_reset_code_email_

- Operation ID: `api_send_password_reset_email_api_v1_users_reset_password_send_reset_code_email_`
- Route: `POST /api/v1/users/reset_password/send_reset_code/{email}`
- Mode: WRITE
- Summary: Send password reset code (legacy path)
- Parameters:
  - `email` in `path` required
  - `org_id` in `query` required

### api_send_password_reset_email_platform_v2_api_v1_users_reset_password_platform_s

- Operation ID: `api_send_password_reset_email_platform_v2_api_v1_users_reset_password_platform_s`
- Route: `POST /api/v1/users/reset_password/platform/send_reset_code`
- Mode: WRITE
- Summary: Send platform password reset code
- Body: JSON request body accepted.

### api_send_password_reset_email_platform_api_v1_users_reset_password_platform_send

- Operation ID: `api_send_password_reset_email_platform_api_v1_users_reset_password_platform_send`
- Route: `POST /api/v1/users/reset_password/platform/send_reset_code/{email}`
- Mode: WRITE
- Summary: Send platform password reset code (legacy path)
- Parameters:
  - `email` in `path` required

### api_change_password_with_reset_code_platform_v2_api_v1_users_reset_password_plat

- Operation ID: `api_change_password_with_reset_code_platform_v2_api_v1_users_reset_password_plat`
- Route: `POST /api/v1/users/reset_password/platform/change_password`
- Mode: WRITE
- Summary: Change platform password with reset code
- Body: JSON request body accepted.

### api_change_password_with_reset_code_platform_api_v1_users_reset_password_platfor

- Operation ID: `api_change_password_with_reset_code_platform_api_v1_users_reset_password_platfor`
- Route: `POST /api/v1/users/reset_password/platform/change_password/{email}`
- Mode: WRITE
- Summary: Change platform password with reset code (legacy path)
- Parameters:
  - `email` in `path` required
- Body: JSON request body accepted.

### api_delete_user_api_v1_users_user_id_user_id_delete

- Operation ID: `api_delete_user_api_v1_users_user_id_user_id_delete`
- Route: `DELETE /api/v1/users/user_id/{user_id}`
- Mode: WRITE
- Summary: Delete user
- Parameters:
  - `user_id` in `path` required

### api_get_user_courses_api_v1_users_user_id_courses_get

- Operation ID: `api_get_user_courses_api_v1_users_user_id_courses_get`
- Route: `GET /api/v1/users/{user_id}/courses`
- Mode: READ
- Summary: List courses for user
- Parameters:
  - `user_id` in `path` required
  - `page` in `query`
  - `limit` in `query`