---
title: "Update employee employment details"
method: PATCH
path: "/v1/employees/{employeeId}/employment"
tags: ["Employee Employment Details"]
---

# Update employee employment details

`PATCH /v1/employees/{employeeId}/employment`

Update employment details for a specific employee.

This endpoint allows partial updates to employment information. Only the fields
provided in the request body will be updated; other fields remain unchanged.

**Important:** At least one field must be provided in the request body.
Empty requests (no-op operations) are not allowed and will return a 400 Bad Request.

**Currently Supported Fields (Phase 1):**
- `employeeCode` - The employee's unique identifier code within the organization

**Future Fields (Planned):**
- `designation` - Job title or position
- `department` - Department name
- `workEmail` - Work email address
- `noticePeriod` - Notice period details

**Read-Only Fields (Not Updatable):**
Fields such as `entity`, `startDate`, `endDate`, `status`, `type`, and `term`
are managed through other processes and cannot be updated via this endpoint.

## Path parameters

- `employeeId` string, uuid, required

## Request body

- V1EmployeesEmployeeIdEmploymentPatchRequest — Request body for updating employee employment details. Currently supports updating employeeCode only (Phase 1). Additional fields will be added in future phases. At least one field must be provided; empty requests are not allowed.
  - `employeeCode` string — The employee's unique identifier code within the organization. Must be alphanumeric with hyphens and underscores allowed.

## Response `200`

Employee employment details updated successfully

- V1EmployeesEmployeeIdEmploymentPatchResponse — Response after successfully updating employee employment details.
  - `employeeId` string, uuid, required — Unique identifier for the employee (employment public ID)
  - `employeeCode` string, required — The updated employee code

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `409` — Conflict - resource already exists or state conflict
- `422` — Unprocessable entity - validation error
- `500` — Internal server error
- `503` — Service unavailable - upstream dependency error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)