Update Designation

Update an existing designation

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

Show Designation Object

id · string

Unique identifier of the designation

company_id · string

The company ID this designation belongs to

name · string

The name of the designation

description · string

Description of the designation

level_id · string

UUID of the associated level (nullable)

department_id · string

UUID of the associated department (nullable)

status · string

Status of the designation (active/inactive)

created_at · string

Timestamp when the designation was created

updated_at · string

Timestamp when the designation was last updated

{
  "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"
  }
}