Read a shortlist
readShortlistOpen one shortlist Clera sent your company from its link (https://www.getclera.com/companies//review/): who was on it, and which of them are still waiting on your review, the same list the link opens in the dashboard.
Each candidate includes opportunityId, talentId, talentName, talentOneliner, fitHeadline and fitReason. noLongerInReview names the rest of the list, the ones no longer in your review queue: already acted on (see listPipeline or listPassed), dismissed, closed on the candidate's side, or on a paused role. notInReviewCount counts them all. When truncated is true the review queue was too large to load completely, so a still-waiting candidate may be missing here. opportunityId is a tool input only, pass it to requestIntro or passCandidate. Never show it to the user; refer to the candidate by name. For a full profile, call getCandidateProfile with the talentId.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"link": "<link>"
},
"name": "readShortlist"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | Yes | The shortlist link Clera sent, https://www.getclera.com/companies/<company>/review/<token>, or just the token at its end. | |
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sentAt | Yes | ||
| roleName | Yes | ||
| truncated | Yes | ||
| candidates | Yes | ||
| noLongerInReview | Yes | ||
| notInReviewCount | Yes |