Profile API

Access and update user profile information through the CitoHR API.

Get Profile

Retrieve the current user's profile information.

GET /api/profile

Returns comprehensive profile information including:

  • Personal information (name, email, phone, image)
  • Employee benefits
  • Department and manager information
  • Salary information
  • Bank account details
  • Employee details and emergency contacts
  • Working pattern configuration
  • Job history
  • Leave balance and statistics
  • Leave approvers

Authorization: Requires valid session. Returns the current user's profile.

Update Profile

Update the current user's profile information.

PUT /api/profile

Request body (only these fields can be updated):

{
  "phone": "+44 1234 567890",
  "image": "https://example.com/avatar.jpg",
  "emergencyContacts": [
    {
      "name": "John Doe",
      "relationship": "Spouse",
      "phone": "+44 1234 567891",
      "email": "john@example.com"
    }
  ]
}

Get Profile by ID

Retrieve profile information for a specific user. Requires appropriate permissions.

GET /api/profile/{id}

Update Emergency Contact

Update a specific emergency contact.

PUT /api/profile/emergencycontacts/{id}