v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Openings

Bulk delete openings

Asynchronously remove many openings in a single call. Each item is an opening ID and is processed independently. The same constraints as DELETE /v3/openings/{id} apply per item, so only closed openings with no attached offer and no filling application are deleted. Protected openings fail individually and are reported in the results from GET /v3/bulk_requests/{bulk_action_uuid}. A bulk_action_uuid is returned immediately.

delete/v3/openings/bulk

Request body

callback_urlstring

Optional HTTPS URL Greenhouse will POST to when every row in data has finished. Omit to poll GET /v3/bulk_requests/{bulk_action_uuid} instead.

datanumber[] required

Array of integer ids identifying the records to delete. Each id is dispatched to the matching non-bulk DELETE endpoint in its own Sidekiq job.

Response

Accepted

bulk_action_uuidstring

UUID assigned to the new bulk request. Use this with GET /v3/bulk_requests/{bulk_action_uuid} to monitor progress and retrieve per-row results.

statusstring

Initial lifecycle state of the new bulk request, typically building immediately after creation. See the bulk request response schema for the full set of values.

status_urlstring

Relative path that returns the current status of the bulk request. Append this to your Harvest base URL to fetch the latest state.