Skip to main content
PUT
/
designations
/
{id}
{
  "name": "Lead Software Engineer",
  "description": "Lead level software engineering position with team management responsibilities",
  "status": "active"
}

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "company_id": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Lead Software Engineer",
    "description": "Lead level software engineering position with team management responsibilities",
    "level_id": "550e8400-e29b-41d4-a716-446655440000",
    "department_id": "660e8400-e29b-41d4-a716-446655440000",
    "status": "active",
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T11:30:00Z"
  }
}
Update an existing designation by its unique identifier. All fields are optional and only provided fields will be updated. This endpoint requires Super Admin or HR Manager role.
This endpoint supports both PUT and PATCH methods.

​
Path Parameters

​
id
string
required
The unique identifier of the designation (UUID)

​
Request Body

​
name
string
The name of the designation (2-255 characters)
​
description
string
A description of the designation
​
level_id
string
UUID of the associated level
​
department_id
string
UUID of the associated department
​
status
string
Status of the designation. Must be either active or inactive

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The updated designation object
{
  "name": "Lead Software Engineer",
  "description": "Lead level software engineering position with team management responsibilities",
  "status": "active"
}

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "company_id": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Lead Software Engineer",
    "description": "Lead level software engineering position with team management responsibilities",
    "level_id": "550e8400-e29b-41d4-a716-446655440000",
    "department_id": "660e8400-e29b-41d4-a716-446655440000",
    "status": "active",
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T11:30:00Z"
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us