Work through a team task
Assign an interview panel check, hand it to a teammate and record who finished it.
Sam is interviewing for the Engineering Director job at Example Studio. Alex asks who’s on Friday’s panel. Give your teammate that task on Sam’s application so they can find it when they open the job. Follow Sam’s application from shortlist to placement
1. Assign the task on Sam’s application
Use the job ID and the jobCandidate.id from when you added Sam to the job. If you’re picking up an existing application, find it with jobCandidates filtered by jobIds and candidateIds. Find an application
Find your teammate with users, then run AssignTask with your workspace key. Here are example variables for a Friday deadline. Use your own job, application and teammate IDs. Find a teammate · Create a task · Download the task calls
{
"input": {
"jobId": "84",
"jobCandidateId": "219",
"assigneeUserId": "12",
"title": "Confirm Sam’s interview panel",
"dueAt": "2027-01-08T12:00:00Z"
}
}Keep the task ID and version from the response. Run ApplicationTasks with Sam’s application ID to see it there. Anyone who can’t see the application also can’t see its task. For work that covers the whole job, such as agreeing the interview budget with Alex, leave out jobCandidateId. Read an application’s tasks
2. See what’s due
Run TeamTasks with the teammate’s ID in assigneeUserIds and a dueBefore time. For a desk covering several jobs, one query gives you the whole list. To see work you can pick up now, use actionableOnly: true. Filter and page through tasks
3. Pick it up later or hand it over
Alex calls back. One interviewer is away until tomorrow. Run EditTask with the current version and a future snoozedUntil. The task will reappear in the actionable list when that time arrives. Friday’s deadline stays in place. To pick it up earlier, send snoozedUntil: null. Edit or snooze a task
mutation WaitForThePanel($task: ID!, $version: String!, $tomorrow: DateTime!) {
updateRecruitingTask(input: {
recruitingTaskId: $task
expectedVersion: $version
snoozedUntil: $tomorrow
}) {
recruitingTask { id status snoozedUntil dueAt version }
}
}If another teammate is covering the job, give ReassignTask their ID and the latest version. They’ll see the same task, instructions and deadline. Hand off the task
4. Close the task
When the panel confirms, run ResolveTask with the task ID, latest version and DONE. If Alex cancels the panel, use DISMISSED. If someone has edited it in the meantime, you’ll get STALE_VERSION. Read the task again before deciding what to do. Resolve the task
query WhoClosedTheTask($id: ID!) {
recruitingTask(id: $id) {
title
status
resolvedBy { id name }
resolvedAt
}
}You can now tell Alex who followed up and when. Read a recruiting task