User Flows / Employee Lifecycle / Management

Employee Management

Manage active employee records, contracts, and data updates

Overview

Once an employee is active, you use the Directory API to manage their lifecycle events: promotions, salary changes, department transfers, and personal data updates.

Get Employee Details

GET/api/v1/accounts/directory/employees/{id}

Returns full profile: personal info, job details, bank data, and social security info.

View Model Schema →

Update Job Position

Handle promotions or role changes.

PATCH/api/v1/accounts/directory/employees/{id}/job-position
Request Body
{
  "newJobPositionId": "jp-789",
  "reason": "PROMOTION",
  "effectiveDate": "2024-06-01",
  "salaryAdjustment": {
    "newDailySalary": 800.00
  }
}

Bank Information

Update bank account details for payroll disbursement.

PUT/api/v1/accounts/directory/employees/{id}/bank-account