Skip to content
My Docs

Update Multiple Candidates Status (Admin)

PATCH
/admin/candidates/statuses

Admin endpoint to update the status of multiple candidates at once (e.g., to “Hired” or “Rejected”). This endpoint is restricted to admin users only.

Authorizations

Section titled “Authorizations ”

Request Body

Section titled “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

Section titled “ Responses ”

204

Section titled “204 ”

No Content - Successfully updated candidates

400

Section titled “400 ”

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

object
error
string

401

Section titled “401 ”

Unauthorized (e.g., missing/invalid token)

object
error
string

403

Section titled “403 ”

Forbidden (e.g., user is not an admin)

object
error
string

404

Section titled “404 ”

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

object
error
string

500

Section titled “500 ”

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

object
error
string