Staff

get detail staff

GET

/v1/staff/{id}

get detail staff › path Parameters

id

string · required

get detail staff › Responses

200

status

boolean · required

code

integer · required

message

string · required

object · required

GET/v1/staff/{id}

curl --request GET \
  --url /v1/staff/:id

shell

Example Responses

{
  "status": true,
  "code": 200,
  "message": "Success Get Detail Staff",
  "data": {
    "id": "uuid",
    "name": "joko",
    "status": "active",
    "permission_id": "uuid",
    "level": "manager",
    "email": "example@email.com",
    "msisdn": "62888888888",
    "join_date": "2026-01-02T12:12:21",
    "working_type": "",
    "working_schedule": {
      "days": [
        "monday",
        "friday"
      ],
      "start_time": "08:00",
      "end_time": "17:00",
      "start_break_time": "12:00",
      "end_break_time": "13:00"
    },
    "emergency_contact": {
      "name": "user",
      "msisdn": "62888888888",
      "relation": "keluarga"
    }
  }
}

json

application/json

Update

PUT

/v1/staff/{id}

Update › path Parameters

id

string · required

Update › Request Body

name

string · required

email

string · required

msisdn

string · required

join_date

string · required

status

string · required

permission_id

string · required

working_type

string · required

show_salary

boolean · required

salary

integer · required

object · required

Update › Responses

200

status

boolean · required

code

integer · required

message

string · required

data

null · required

PUT/v1/staff/{id}

curl --request PUT \
  --url /v1/staff/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "coba",
  "email": "coba@email.com",
  "msisdn": "628521212111",
  "join_date": "2006-01-02",
  "status": "active",
  "permission_id": "4076bf16-6199-4d4e-9691-dc5019a63a5c",
  "working_type": "fulltime",
  "show_salary": false,
  "salary": 0,
  "working_schedule": {
    "days": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "start_time": "09:00",
    "end_time": "16:00",
    "start_break_time": "12:00",
    "end_break_time": "13:00"
  },
  "emergency_contact": {
    "name": "panjul",
    "msisdn": "62812212321",
    "relation": "keluarga"
  }
}
'

shell

Example Request Body

{
  "name": "coba",
  "email": "coba@email.com",
  "msisdn": "628521212111",
  "join_date": "2006-01-02",
  "status": "active",
  "permission_id": "4076bf16-6199-4d4e-9691-dc5019a63a5c",
  "working_type": "fulltime",
  "show_salary": false,
  "salary": 0,
  "working_schedule": {
    "days": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "start_time": "09:00",
    "end_time": "16:00",
    "start_break_time": "12:00",
    "end_break_time": "13:00"
  },
  "emergency_contact": {
    "name": "panjul",
    "msisdn": "62812212321",
    "relation": "keluarga"
  }
}

json

application/json

Example Responses

{
  "status": true,
  "code": 200,
  "message": "Staff updated",
  "data": null
}

json

application/json

Delete

DELETE

/v1/staff/{id}

Delete › path Parameters

id

string · required

Delete › Responses

200

status

boolean · required

code

integer · required

message

string · required

data

null · required

Create Staff

POST

/v1/staff

Create Staff › Headers

Content-Type

string · required

User-Agent

string · required

Authorization

string · required

Create Staff › Request Body

name

string · required

email

string · required

msisdn

string · required

join_date

string · required

status

string · required

permission_id

string · required

working_type

string · required

show_salary

boolean · required

salary

integer · required

object · required

Create Staff › Responses

200

POST/v1/staff

curl --request POST \
  --url /v1/staff \
  --header 'Authorization: <string>' \
  --header 'Content-Type: <string>' \
  --header 'User-Agent: <string>' \
  --data '
{
  "name": "coba",
  "email": "coba@email.com",
  "msisdn": "628521212111",
  "join_date": "2006-01-02",
  "status": "active",
  "permission_id": "4076bf16-6199-4d4e-9691-dc5019a63a5c",
  "working_type": "fulltime",
  "show_salary": false,
  "salary": 0,
  "working_schedule": {
    "days": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "start_time": "09:00",
    "end_time": "16:00",
    "start_break_time": "12:00",
    "end_break_time": "13:00"
  },
  "emergency_contact": {
    "name": "panjul",
    "msisdn": "62812212321",
    "relation": "keluarga"
  }
}
'

shell

Example Request Body

{
  "name": "coba",
  "email": "coba@email.com",
  "msisdn": "628521212111",
  "join_date": "2006-01-02",
  "status": "active",
  "permission_id": "4076bf16-6199-4d4e-9691-dc5019a63a5c",
  "working_type": "fulltime",
  "show_salary": false,
  "salary": 0,
  "working_schedule": {
    "days": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "start_time": "09:00",
    "end_time": "16:00",
    "start_break_time": "12:00",
    "end_break_time": "13:00"
  },
  "emergency_contact": {
    "name": "panjul",
    "msisdn": "62812212321",
    "relation": "keluarga"
  }
}

json

application/json

Example Responses

{}

json

application/json

Fetch All Staff

GET

/v1/staffs

Fetch All Staff › query Parameters

page

number

page_size

number

search

string

search by email and level

level

string

status

string

one of active and inactive

sort_by

string

sort_dir

string

Fetch All Staff › Headers

User-Agent

string · required

Authorization

string · required

Fetch All Staff › Responses

200

status

boolean · required

code

integer · required

message

string · required

object · required

GET/v1/staffs

curl --request GET \
  --url /v1/staffs \
  --header 'Authorization: <string>' \
  --header 'User-Agent: <string>'

shell

Example Responses

{
  "status": true,
  "code": 200,
  "message": "Success Fetch All Staff",
  "data": {
    "summaries": {
      "total_all_staff": 10,
      "total_active_staff": 5,
      "total_inactive_staff": 5,
      "total_staff_created_this_month": 2
    },
    "staffs": [
      {
        "id": "uuid",
        "name": "panjul",
        "role": "staff",
        "msisdn": "62888888888",
        "email": "example@email.com",
        "status": "active",
        "join_date": "2026-01-02T12:22:22"
      }
    ]
  },
  "pagination": {
    "total_items": 1,
    "total_pages": 1,
    "page": 1,
    "page_size": 10,
    "has_prev_page": false,
    "has_next_page": false
  }
}

json

application/json

Permission Promotions

Update

PUT

/v1/staff/{id}

Update › path Parameters

id

string · required

Update › Request Body

name

string · required

email

string · required

msisdn

string · required

join_date

string · required

status

string · required

permission_id

string · required

working_type

string · required

show_salary

boolean · required

salary

integer · required

object · required

Update › Responses

200

status

boolean · required

code

integer · required

message

string · required

data

null · required

Create Staff

POST

/v1/staff

Create Staff › Headers

Content-Type

string · required

User-Agent

string · required

Authorization

string · required

Create Staff › Request Body

name

string · required

email

string · required

msisdn

string · required

join_date

string · required

status

string · required

permission_id

string · required

working_type

string · required

show_salary

boolean · required

salary

integer · required

object · required

Create Staff › Responses

200

Fetch All Staff

GET

/v1/staffs

Fetch All Staff › query Parameters

page

number

page_size

number

search

string

search by email and level

level

string

status

string

one of active and inactive

sort_by

string

sort_dir

string

Fetch All Staff › Headers

User-Agent

string · required

Authorization

string · required

Fetch All Staff › Responses

200

status

boolean · required

code

integer · required

message

string · required

object · required