Skip to main content
POST
Bulk Delete

Bulk Delete

Delete multiple employees by their IDs in a single request. Progress is tracked via a processing job and real-time Redis notifications. All employees must belong to the requesting organization. Employees from other organizations will be reported as failed in the response.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

string[]
required
List of employee UUIDs to delete (1–100,000)

Response

integer
Total number of employees processed
integer
Number of employees successfully deleted
integer
Number of employees that failed to delete
array[object]
Details of failed deletions

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Unprocessable Entity

Cause: Empty or invalid employee_ids array

Bulk Delete by Filters

Delete all employees matching filter criteria

Delete Employee

Delete a single employee