User Management

User management endpoints require admin authentication. These endpoints allow you to manage user accounts within your Infomaxim application.

GET/users

Retrieves a list of all users in the application.

Request Headers

Authorization: Bearer <admin_access_token>

Query Parameters

page number
Page number for pagination (default: 1)
perPage number
Results per page (default: 20, max: 100)

Success Response (200 OK)

{
  "status": "Success",
  "data": {
    "users": [
      {
        "id": 123,
        "email": "user@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "role": "admin",
        "createdAt": "2024-01-01T12:00:00Z",
        "lastLogin": "2024-01-15T09:30:00Z"
      }
    ],
    "pagination": {
      "total": 150,
      "page": 1,
      "perPage": 20,
      "totalPages": 8
    }
  }
}

POST/users

Creates a new user account (admin only).

Request Body

{
  "email": "newadmin@example.com",
  "password": "SecurePass123!",
  "firstName": "Admin",
  "lastName": "User",
  "role": "admin"
}

GET/users/current

Retrieves the currently authenticated user's profile.

Request Headers

Authorization: Bearer <access_token>

Success Response (200 OK)

{
  "status": "Success",
  "data": {
    "id": 123,
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "role": "admin",
    "preferences": {
      "language": "en",
      "timezone": "UTC"
    }
  }
}

PUT/users/:id

Updates a user's information.

Request Body

{
  "firstName": "Updated",
  "lastName": "Name",
  "email": "updated@example.com"
}

DELETE/users/:id

Deletes a user account (admin only).

Success Response (200 OK)

{
  "status": "Success",
  "message": "User deleted successfully"
}