Skip to main content
POST
Bulk Delete Employees
← Employees API
Deprecated. Use POST /v2/employees/delete: up to 5,000 employees per request by id, including those of the organizations under yours that you can write to, idempotent, deleted asynchronously as an ingest job, with webhooks. This endpoint keeps working; its responses carry Deprecation and Link: </v2/employees/delete>; rel="successor-version" headers. Its responses also carry Sunset: Fri, 30 Apr 2027 00:00:00 GMT: the endpoint is retired on April 30, 2027 (see the changelog).
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