Schedule or update an interview
setInterviewSchedule, reschedule, complete or advance a candidate's interview on one of the company's roles, or move them to Offer. This is the same interview picker the Pipeline page of the dashboard uses.
Take talentId and roleId from a listPipeline candidate row, never guess them. For schedule and advance-with-date, send scheduledAt with the user's UTC offset; confirm the day, time and timezone with the user first. A scheduled date sends the candidate prep and good-luck reminders ahead of the interview. Cancel, a moved time and clear_date tell the candidate through Clera, so say that before the user confirms. When the date no longer holds and nobody has the new time yet, clear_date removes it instead of keeping the old one; never guess a time. Passing on a candidate is passCandidate, not this tool.
When the company's ATS is Ashby, the role is linked to an Ashby job and Clera added the candidate there, advance and offer also move them in the ATS, a moment later: advance to the ATS stage matching the round it opened, offer to the ATS offer stage. Forward only, never to Hired. With no matching ATS stage, or any other ATS, only Clera changes. Schedule, clear_date, complete, mark_final and cancel never move anyone in the ATS.
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": {
"talentId": "<talentId>",
"roleId": "<roleId>",
"action": "<action>"
},
"name": "setInterview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| action | Yes | schedule: set or move the date of the current round (also reschedules to a known time). clear_date: the current round's date no longer holds and no new time is known yet; clears it so reminders queued for the old slot do not send. advance: open the next round, with a date when one is known. complete: mark the current round done. mark_final: flag the current round as the last one. cancel: cancel the current round. offer: close the current round and move the candidate to Offer. | |
| roleId | Yes | The roleId from the same listPipeline candidate row. | |
| talentId | Yes | The candidate's talentId from listPipeline. | |
| stageName | No | Name of the round to open on advance. Omit to use the role's next defined round. | |
| completedAt | No | For complete: when the round actually ended, as an ISO 8601 datetime with offset. Omit to record now. | |
| scheduledAt | No | When the interview happens, as an ISO 8601 datetime with the user's UTC offset, e.g. 2026-10-02T14:00:00+02:00. Required for schedule, optional for advance. Ask the user for the time and their timezone if either is unclear; never guess. | |
| fromTrackerUpdate | No | true when applying an update from listTrackerUpdates, copied from its setInterviewArgs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | ||
| outcome | Yes | ||
| stageName | Yes | ||
| opportunityStatus | Yes |