info:
  name: List Users
  type: http
  seq: 5
http:
  method: GET
  url: '{{base_url}}/api/auth/users'
  auth: inherit
  body:
    type: none

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)
    - `max_devices` (integer): Maximum number of devices allowed
    - `device_count` (integer): Current number of registered devices
    - `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
    - Includes device limits and current device count
    - Useful for user management interfaces
