New: Kith open-sources its ATS.Read why
Skip to Content
Objects

RoleRecommendation

A role a candidate's calls point to: one the recruiter said on a call they should be considered for, or one discussed with them while they were on no job. Read it from Candidate.roleRecommendations.

type RoleRecommendation {
  blockers: [String!]!
  confidence: RoleMatchConfidence
  grade: JobCandidateGrade
  job: Job
  jobCandidate: JobCandidate
  label: String!
  reason: String
  score: Int
  suggestedAction: String
}

Fields

RoleRecommendation.blockers · [String!]! non-null scalar

What argues against it. Empty when a role check gave none, or none ran.

RoleRecommendation.confidence · RoleMatchConfidence enum

How sure a role check was of the match. Null when none scored this job.

RoleRecommendation.grade · JobCandidateGrade enum

The score as a letter, as CallRoleMatch.grade gives it. Null without a score.

RoleRecommendation.job · Job object

The job, when the role named on the call is one of the workspace's jobs. Null when the call named a role the workspace has no job for.

RoleRecommendation.jobCandidate · JobCandidate object

Their place on the job, when they have already been added to it. Null while this is still only a recommendation.

RoleRecommendation.label · String! non-null scalar

The role as the app shows it: the hiring company and the job's title, such as "Acme — Account Executive", or the role as the call named it when job is null.

RoleRecommendation.reason · String scalar

What was said on the call that makes them a fit, when a role check gave a reason.

RoleRecommendation.score · Int scalar

How well they fit the job, from 0 to 100, when a finished role check of the call scored it. Null otherwise.

RoleRecommendation.suggestedAction · String scalar

What the recruiter should do next, when a role check said.

Member Of

Candidate object