# Users

## List users

 - [GET /rest/v2/users](https://apidocs.rhythms.ai/rest/v2/users/get_rest_v2_users.md): Retrieves all users via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, display_name, status, manager_uuid, license_type, display_name, status, manager_uuid, license_type.

Available ransackable associations and their attributes:
- teams: teams_uuid, teams_display_name, teams_parent_uuid, teams_status, teams_name, teams_is_org, teams_parent_uuid
- team_memberships: team_memberships_uuid, team_memberships_user_uuid
- profile: profile_uuid, profile_first_name, profile_last_name, profile_job_title, profile_employee_type, profile_department_name, profile_division_name, profile_cost_center_name, profile_custom_field_1, profile_custom_field_2, profile_custom_field_3, profile_custom_field_4, profile_custom_field_5
- manager: manager_uuid, manager_display_name, manager_status, manager_manager_uuid, manager_license_type, manager_display_name, manager_status, manager_manager_uuid, manager_license_type

## Create a new user

 - [POST /rest/v2/users](https://apidocs.rhythms.ai/rest/v2/users/post_rest_v2_users.md): Creates a new user with the provided attributes. Email is required and must be unique within the tenant.

## Get a specific user

 - [GET /rest/v2/users/{id}](https://apidocs.rhythms.ai/rest/v2/users/get_rest_v2_users_id.md): Retrieves detailed information about a specific user by their UUID

## Update a user

 - [PUT /rest/v2/users/{id}](https://apidocs.rhythms.ai/rest/v2/users/put_rest_v2_users_id.md): Updates an existing user with the specified attributes.