List candidate interviews
list_candidate_meetingsList the interviews of one candidate: title, type, status, start time and job position, plus hasTranscript and hasReport flags. The transcript and the report themselves are not included. Paginated with cursor (from pageInfo.nextCursor) and incremental with updatedSince.
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": {
"candidateId": "<candidateId>"
},
"name": "list_candidate_meetings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Records per page (default: 20, max: 1000). Values above ~50 are meant for programmatic syncing, not for reasoning over the results. | |
| cursor | No | Opaque cursor from the previous page (`pageInfo.nextCursor`). Omit for the first page. Treat it as a token — do not construct or modify it. | |
| sortBy | No | Sort field (default: startTime). | |
| status | No | Filter by meeting status | |
| sortOrder | No | Sort order (default: desc). | |
| candidateId | Yes | The candidate ID | |
| updatedSince | No | ISO 8601 timestamp. Returns only records modified strictly after it, for incremental syncing. Deleted records are never returned. |