Update designation

PATCH

/api/v0/partner/designation/{designationCode}

Replaces the name, grade and departments of a designation. Send the full set of values, the same as for Create designation.
gradeId is a grade code. departmentIds are department codes in your company.
A department cannot be removed from the designation while active users hold this designation in that department, or while an approval flow uses that department and designation.
The name is saved in upper case.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "designationName": "Area Sales Manager",
    "gradeId": "GRADE003",
    "departmentIds": [
        "DEPT001",
        "DEPT002"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://ekpayout-uat.enkash.in/api/v0/partner/designation/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "designationName": "Area Sales Manager",
    "gradeId": "GRADE003",
    "departmentIds": [
        "DEPT001",
        "DEPT002"
    ]
}'

Responses

🟢200

application/json

Designation updated.

Bodyapplication/json

Example

{
    "response_code": 0,
    "response_message": "SUCCESS",
    "payload": {
        "designationId": "DESIG001",
        "designationName": "AREA SALES MANAGER",
        "status": "ACTIVE",
        "gradeId": "GRADE003",
        "gradeName": "L3",
        "seniorityLevel": 3,
        "departments": [
            {
                "code": "DEPT001",
                "name": "SALES"
            },
            {
                "code": "DEPT002",
                "name": "MARKETING"
            }
        ]
    }
}

🟠400

🟠401

🔴500

Modified at 2026-11-13 08:00:06

Update designation status

Update department status