Remove Candidate from Shortlist
DELETE /candidates/{candidateId}/shortlist
DELETE
/candidates/{candidateId}/shortlist
Remove a candidate from shortlist. Authorization: Users can only remove shortlist from candidates from offices they have access to. This operation is idempotent - if the candidate is already not shortlisted, 204 is returned.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” candidateId
required
string
Candidate ID (UUID format)
Responses
Section titled “ Responses ”No Content - Successfully removed candidate from shortlist
Bad request (e.g., invalid candidate ID)
object
error
string
Unauthorized (e.g., missing/invalid user id or user lacks access to the office)
object
error
string
Not Found (e.g., candidate not found)
object
error
string
Internal Server Error (e.g., database error)
object
error
string