Read a match
readMatchOne of the candidate's matches in full, by the opportunityId from listMatches or listMyPipeline: the role description, tech stack, experience band, visa line, interview stages, the company block, and every role question with its current answer.
Use it before likeMatch or declineMatch when the row alone is not enough, and to help draft answers for answerRoleQuestion. Refuses an opportunityId that is not the candidate's own. Open roles from listMatches (kind open_role) have no opportunityId yet; readJobListing with their jobId has the full role.
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>"
},
"name": "readMatch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| opportunityId | Yes | The opportunityId from listMatches or listMyPipeline. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| visa | Yes | ||
| jobId | Yes | ||
| reason | Yes | ||
| salary | Yes | ||
| status | Yes | ||
| company | Yes | ||
| location | Yes | ||
| position | Yes | ||
| whyMatch | Yes | ||
| createdAt | Yes | ||
| questions | Yes | ||
| techStack | Yes | ||
| experience | Yes | ||
| arrangement | Yes | ||
| companyName | Yes | ||
| description | Yes | ||
| referralUrl | Yes | ||
| partnerLabel | Yes | ||
| interviewDate | Yes | ||
| matchStrength | Yes | ||
| opportunityId | Yes | ||
| applyOwnership | Yes | ||
| introRequested | Yes | ||
| interviewStages | Yes |