Bulk Update Employees

Update fields on multiple employees in a single request. Each item in the request array must include the BizzAssure internal emp_id. Only the fields provided per item will be updated.

The response contains a per-employee result so you can identify exactly which updates succeeded or failed.

Endpoint

PATCH /v1/client/employees/bulk

Request

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer YOUR_ACCESS_TOKEN

Body

{
  "employees": [
    {
      "emp_id": "ba_emp_01jwz3k...",
      "last_active_date": "2025-12-31"
    },
    {
      "emp_id": "ba_emp_02abc...",
      "last_active_date": "2025-11-30"
    }
  ]
}

Fields

Top-level

Field	Type	Required	Description
employees	array	Yes	Array of employee update objects (max 100 per request)

Per-employee object

Field	Type	Required	Description
emp_id	string	Yes	BizzAssure internal employee ID returned when the employee was created
last_active_date	string	No	Last date the employee was active, in YYYY-MM-DD format

Response

Success (200 OK)

The overall success field is true as long as the request itself was valid, even if some individual employees failed (e.g. not found). Check each entry in results to determine per-employee outcome.

{
  "payload": {
    "success": true,
    "results": [
      {
        "emp_id": "ba_emp_01jwz3k...",
        "success": true
      },
      {
        "emp_id": "ba_emp_02abc...",
        "success": false,
        "error": "Employee with the given ID does not exist"
      }
    ]
  }
}

Response Fields

Top-level

Field	Type	Description
success	boolean	true if the bulk request was processed (regardless of per-item failures)
results	array	One result entry per employee in the request, in the same order

Per-employee result object

Field	Type	Description
emp_id	string	BizzAssure internal employee ID from the request
success	boolean	true if this employee was updated successfully
error	string	Human-readable error reason, present only when success is false

Error Responses

Validation Error (400 Bad Request)

Returned when the top-level request body is invalid (e.g. employees is missing or empty).

{
  "type": "VALIDATION_ERROR",
  "title": "Validation Failed",
  "detail": "employees: must not be empty",
  "instance": "/v1/client/employees/bulk"
}

Payload Too Large (413)

{
  "type": "PAYLOAD_TOO_LARGE",
  "title": "Too Many Employees",
  "detail": "A maximum of 100 employees can be updated in a single request",
  "instance": "/v1/client/employees/bulk"
}

Unauthorized (401 Unauthorized)

{
  "type": "UNAUTHORIZED",
  "title": "Unauthorized",
  "detail": "Missing or invalid access token",
  "instance": "/v1/client/employees/bulk"
}