Shortlist a Candidate
POST /candidates/{candidateId}/shortlist
POST
/candidates/{candidateId}/shortlist
Mark a candidate as shortlisted. Authorization: Users can only shortlist candidates from offices they have access to. This operation is idempotent - if the candidate is already 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 shortlisted candidate
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