meta {
  name: List Users
  type: http
  seq: 5
}

get {
  url: {{base_url}}/api/auth/users
  body: none
  auth: inherit
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## List Users
  
  Retrieves a list of all users with complete user information.
  
  **Method:** GET
  
  **Endpoint:** /api/auth/users
  
  **Authentication:** Required (Admin only)
  
  **Response:** Array of user objects with complete information:
  - `id` (string): User ID (UUID)
  - `email` (string): Email address
  - `username` (string): Username
  - `first_name` (string): First name (empty if not set)
  - `last_name` (string): Last name (empty if not set)
  - `role` (string): User role ("user" or "admin")
  - `theme` (string): Theme preference (empty if default)
  - `created_at` (string): Creation timestamp (ISO 8601)
  - `updated_at` (string): Last update timestamp (ISO 8601)
  
  **Status Codes:**
  - 200: Success
  - 401: Unauthorized
  - 403: Forbidden (admin access required)
  
  **Features:**
  - Admin-only endpoint with complete user information
  - Returns first_name, last_name, role, theme fields
  - Useful for user management interfaces
}

get {
  url: {{base_url}}/api/auth/users
  body: none
  auth: inherit
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## List Users (Admin)
  
  Retrieves a list of all users with complete user information.
  
  **Method:** GET
  
   **Endpoint:** /api/auth/users
  
  **Authentication:** Required (Admin only)
  
  **Response:** Array of user objects with complete information:
  - `id` (string): User ID (UUID)
  - `email` (string): Email address
  - `username` (string): Username
  - `first_name` (string): First name (empty if not set)
  - `last_name` (string): Last name (empty if not set)
  - `role` (string): User role ("user" or "admin")
  - `theme` (string): Theme preference (empty if default)
  - `created_at` (string): Creation timestamp (ISO 8601)
  - `updated_at` (string): Last update timestamp (ISO 8601)
  
  **Status Codes:**
  - 200: Success
  - 401: Unauthorized
  - 403: Forbidden (admin access required)
  
  **Enhanced Features:**
  - Now admin-only endpoint (moved from public to protected admin group)
  - Returns complete user profile information including names and role
  - Useful for comprehensive admin user management
}