Pass on a candidate
passCandidatePass on a candidate for one role. Every reason you name trains the next list Clera sends for this role, so pick each one the user's words name and put their words in reason; your own view of the candidate goes in assistantNote. Reasons: too_senior (more senior than the role needs), too_junior (not senior enough yet), missing_skills (a must-have skill or stack is missing), wrong_background (career path or domain doesn't match), below_talent_bar (not strong enough for this team), location_mismatch (location or remote setup doesn't work), salary_expectations (the comp ask is above the range), visa (needs sponsorship or a work permit the company can't give), already_in_pipeline (the company already knows them), other (anything else; say what in reason). Both are optional, but a pass with neither tells Clera nothing about what to change. Passing again with a new reason replaces the old one. Only pass when the user asked to.
Works for a candidate from a search result, from listPendingIntroRequests or listRecommendedCandidates, or someone already in the pipeline (introduced, interviewing or at offer) from listPipeline. Target either a candidate from searchCandidates or similarCandidates (talentId, with jobId or the interactive role picker), or a list entry (its opportunityId, with talentName and roleName copied verbatim from that entry; all three must describe one entry). If the candidate and role you were asked about are not on the page you fetched, re-call the same list with roleId to narrow, or with offset or a larger candidatesPerStage to page further; if the pair does not exist, say so and pass on nothing. Passing a different role for the same candidate is refused. This marks the opportunity as no_fit (creating the opportunity record first when the candidate came straight from search) and logs the company's decision with their feedback.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "passCandidate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | No | With talentId: the open role the pass is about. Resolve the id yourself with the job tool's list command when the user already named a role; when the role is not settled, omit it and the user gets an interactive role picker. | |
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| reason | No | What the user said about why this candidate is not a fit, in their own words, quoted or lightly trimmed and in their voice, e.g. 'We need someone who has written Rust.' No lead-in such as 'the hiring manager said' or 'per the user'. Never fill it from the profile, fit flags or job notes; that belongs in assistantNote. When the user gave no reason, ask once if the conversation allows it, otherwise leave it out. A sentence that fits any candidate is not a reason. Stored with the pass and shown to Clera. | |
| roleName | No | When acting on a listed opportunity, the role name copied verbatim from the same row. Checked against the record; a mismatch is refused, so never substitute a different role for the same talent. | |
| talentId | No | Alternative target: the candidate's id exactly as returned by searchCandidates or similarCandidates. Pair it with jobId. | |
| categories | No | Every reason from the list in the tool description that the user's own words name. Leave it out when they named none. | |
| talentName | No | When acting on a listed opportunity, the talent's name copied verbatim from that row. Checked against the record; a mismatch is refused. Omit on the talentId path. | |
| assistantNote | No | Your own remarks for Clera, kept apart from the user's reason and never shown as the company's view: what the profile or fit flags say, a profile fact that contradicts what the user said, something to check. Leave it out when you have nothing to add. | |
| opportunityId | No | The opportunity ID from listPendingIntroRequests, listRecommendedCandidates or listPipeline. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | ||
| outcome | Yes | ||
| roleName | Yes | ||
| talentName | Yes | ||
| opportunity | Yes |