Ask a candidate something
askCandidateAsk a candidate who is interviewing for one of your roles a question, through Clera: availability, a detail of their background, what they think of the role. Clera's agent for the candidate answers what it already knows and asks the candidate for the rest.
Take opportunityId from a listPipeline row of a candidate in an interview process. request is what the user wants to know, in the user's words, self-contained and naming the role; it reaches the candidate's agent and can be put to the candidate. Confirm the wording with the user before calling. The answer arrives later: listAsks shows each ask's status and, once answered, its outcome.
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": {
"opportunityId": "<opportunityId>",
"request": "<request>"
},
"name": "askCandidate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| request | Yes | What the user wants to know, in their words, self-contained and naming the role. | |
| opportunityId | Yes | The opportunityId of the candidate's listPipeline row. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| askId | Yes | ||
| message | Yes | ||
| expiresAt | Yes |