---
title: "Update Employee"
method: PUT
path: "/hr/employee"
---

# Update Employee

`PUT /hr/employee`

This  API functionality is used at the time of adding a new employee. This is used in add employee page of HR Ledgers

## Headers

- `api-token` string
- `x-api-key` string

## Request body

- object
  - `name` string, required — Employee name
  - `branch` integer, required — Branch of an employee for PT calculation
  - `doj` string, date, required — Date of joining of an employee
  - `personal_mobile` integer, required — Personal mobile number of an employee to do checkin and checkout
  - `employee_id` string — Employee Identification number(Alphanumeric)
  - `designation` string — Designation of an employee(Alphanumeric)
  - `department` string — Employee Department
  - `personal_email` string — Personal email id of an employee
  - `office_email` string, required — Official email id of an employee
  - `pan` string — pan number of an employee
  - `employee_status` 'inactive' | 'active' | 'absconded' | 'resigned' | 'terminated' | 'furloughed' | 'informed long leave' | 'uninformed absence' | 'discipline improvement plan', required — Status of an employee
  - `office_mobile` integer — The official mobile number associated with the employee
  - `reporting_to` string — The person to whom the employee directly reports
  - `father_name` string — The name of the employee's father.
  - `employment_type` 'Full Time' | 'Part Time' | 'Contractual' | 'Apprentice' | 'Intern' — The type of employment.
  - `dob` string, required — Date of birth of the employee
  - `blood_group` string — The blood group of the employee.
  - `marital_status` 'Unmarried or Single' | 'Married' | 'Divorced' | 'Widowed' | 'Others' — The marital status of the employee.
  - `emergency_contact` integer — Emergency contact number for the employee
  - `gender` 'Male' | 'Female' | 'Others', required — Gender of the employee.
  - `aadhar` integer — Aadhar number of an employee
  - `religion` string — The religion of the employee.
  - `employee_account_name` string — Name associated with the employee's bank account.
  - `employee_account_number` integer — Bank account number of the employee.
  - `employee_bank_branch` string — The branch of the bank where the employee holds an account.
  - `employee_bank_name` string — The name of the bank where the employee holds an account.
  - `employee_ifsc_code` string — IFSC (Indian Financial System Code) of the employee's bank.
  - `employee_account_type` 'Please Select' | 'Current Account' | 'Savings Account' — The type of bank account.
  - `uan_number` integer — Universal Account Number.
  - `esi_number` integer — Employee State Insurance (ESI) number.
  - `present_address` object[] — Present residential address details, including city, state, country, pincode, and address lines.
    - `city` string
    - `state` string
    - `country` string
    - `pincode` string
    - `address_line1` string
    - `address_line2` string
  - `permanent_address` object[] — Permanent residential address details, including city, state, country, pincode, and address lines.
    - `city` string
    - `state` string
    - `country` string
    - `pincode` string
    - `address_line1` string
    - `address_line2` string
  - `shift` string, date-time — Shift Timing of an employee
  - `dateofexit` string, date-time, required — This field is mandatory when employee status is [inactive, absconded, resigned, terminated, furloughed, informed long leave, uninformed absence, discipline improvement plan]
  - `exit_description` string, required — This field is mandatory when employee status is [inactive, absconded, resigned, terminated, furloughed, informed long leave, uninformed absence, discipline improvement plan]
  - `gid` string, required — Reference code of the employee. This is generated when the employee is added to the system and is used to link salary details with that employee.

## Response `200`

200

- object
  - `status` integer
  - `msg` string
  - `data` string
  - `statusCode` string

## Other responses

- `401` — 401
- `500` — 500
- `502` — 502
- `503` — 503

---

[API](https://skmtc.dev/ledgers/apis/authentication.md) · [All operations](https://skmtc.dev/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ledgers/authentication/revisions/605f28ef08ef/schema)