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