Staffs

This section provides comprehensive documentation regarding staff management functionalities within Whautomate.

Explore the methods available to retrieve staff lists and access detailed information about individual staff members within your organization.

Retrieve Staffs: Obtain a list of staff members available within your Whautomate account, enabling access to information about the personnel associated with your organization.

Get Staff By ID: Retrieve detailed information about a specific staff member using their unique identifier (staffId), facilitating targeted access to individual staff profiles and their specific details within the platform.

Retrieve Staff's Blocked Time Based on Date Range: This method allows you to view a staff member's blocked time schedule for a specific date range. By providing the staff's unique identifier and desired date range, you can identify periods marked as unavailable due to leaves, or personal commitments.

Block Staff's Time: This method enables you to create blocked time slots on a staff member's schedule. Use this functionality to mark specific times as unavailable. You can create these blocks by providing the staff's ID and details about the blocked time period (date, time range).

Get Blocked Time By Id: Use this method to retrieve detailed information about a specific blocked time slot within a staff member's schedule. Provide the staff ID and the unique identifier of the blocked time to access details.

Delete Staff's Blocked Time By Id: This method allows you to remove a previously created blocked time period from a staff member's schedule. Use the staff ID and the unique identifier of the blocked time for deletion.

Retrieve Staffs

get

Query parameters

locationIdstringOptional

limitstringOptional

pagestringOptional

searchTextstringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

/v1/staffs

HTTPcURLJavaScriptPython

GET /v1/staffs HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

[
  {
    "id": "text",
    "firstName": "text",
    "lastName": "text",
    "email": "text",
    "gender": "Male",
    "countryCode": "text",
    "phone": "text",
    "active": true,
    "locations": [
      "text"
    ]
  }
]

Get Staff By Id

get

Path parameters

staffIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

/v1/staffs/{staffId}

HTTPcURLJavaScriptPython

GET /v1/staffs/{staffId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "firstName": "text",
  "lastName": "text",
  "email": "text",
  "gender": "Male",
  "countryCode": "text",
  "phone": "text",
  "active": true,
  "locations": [
    "text"
  ]
}

Retrieve Staff's availability blocks based on date range

get

Path parameters

staffIdstringRequired

Query parameters

startDatestringOptional

endDatestringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

/v1/staffs/{staffId}/availabilityBlocks

HTTPcURLJavaScriptPython

GET /v1/staffs/{staffId}/availabilityBlocks HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

[
  {
    "id": "text",
    "staff": {
      "id": "text",
      "firstName": "text",
      "lastName": "text"
    },
    "timezone": "text",
    "date": "2026-01-25",
    "slots": [
      {
        "startTime": "text",
        "startTimeUTC": "text",
        "endTime": "text",
        "endTimeUTC": "text"
      }
    ]
  }
]

Block Staff's time

post

Path parameters

staffIdstringRequired

Header parameters

x-api-keystringOptional

Body

application/json

idstringOptional

timezonestringOptional

datestring · dateRequired

Responses

200

200 response

application/json

post

/v1/staffs/{staffId}/availabilityBlocks

HTTPcURLJavaScriptPython

POST /v1/staffs/{staffId}/availabilityBlocks HTTP/1.1
Host: <YOUR HOST>
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "id": "text",
  "staff": {
    "id": "text",
    "firstName": "text",
    "lastName": "text"
  },
  "timezone": "text",
  "date": "2026-01-25",
  "slots": [
    {
      "startTime": "text",
      "startTimeUTC": "text",
      "endTime": "text",
      "endTimeUTC": "text"
    }
  ]
}

200

200 response

[
  {
    "id": "text",
    "staff": {
      "id": "text",
      "firstName": "text",
      "lastName": "text"
    },
    "timezone": "text",
    "date": "2026-01-25",
    "slots": [
      {
        "startTime": "text",
        "startTimeUTC": "text",
        "endTime": "text",
        "endTimeUTC": "text"
      }
    ]
  }
]

Get Availibility Block By Id

get

Path parameters

staffIdstringRequired

availabilityBlockIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

/v1/staffs/{staffId}/availabilityBlocks/{availabilityBlockId}

HTTPcURLJavaScriptPython

GET /v1/staffs/{staffId}/availabilityBlocks/{availabilityBlockId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "staff": {
    "id": "text",
    "firstName": "text",
    "lastName": "text"
  },
  "timezone": "text",
  "date": "2026-01-25",
  "slots": [
    {
      "startTime": "text",
      "startTimeUTC": "text",
      "endTime": "text",
      "endTimeUTC": "text"
    }
  ]
}

Delete Staff's Blocked Time By Id

delete

Path parameters

staffIdstringRequired

availabilityBlockIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

delete

/v1/staffs/{staffId}/availabilityBlocks/{availabilityBlockId}

HTTPcURLJavaScriptPython

DELETE /v1/staffs/{staffId}/availabilityBlocks/{availabilityBlockId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "success": true
}