Update Multiple Candidates Status

PATCH

/candidates/status

Update the status of multiple candidates at once (e.g., to “Hired” or “Rejected”). Authorization: Users can only update candidates from offices they have access to. If any candidate belongs to an unauthorized office, the entire request is rejected with 401 Unauthorized. All candidate IDs must exist, otherwise a 404 Not Found is returned.

Authorizations

• ApiKeyAuth

Request Body

Bulk candidate status update request

object

candidateIds

required

Array<string>

>= 1 items <= 100 items

status

required

string

Allowed values: applied scheduled interviewed cancelled hired rejected

Responses

204

No Content - Successfully updated candidates

400

Bad request (e.g., invalid candidate IDs, invalid status, or binding/validation errors)

object

error

string

401

Unauthorized (e.g., missing/invalid user id or user lacks access to one or more offices)

object

error

string

404

Not Found (e.g., one or more candidates not found)

object

error

string

500

Internal Server Error (e.g., database error)

object

error

string