Assign

Requires ASSIGN_CANDIDATE_TO_ASSESSMENT. Both the candidate and the assessment must belong to your organisation, or the request fails with NOT_FOUND.

mutation AssignCandidateToAssessment($input: DeveloperAssignCandidateInput!) {
  developerAssignCandidateToAssessment(input: $input) {
    assessmentSessionId
    interviewUrl
    token
    tokenExpiresAt
    emailSent
  }
}

{
  "input": {
    "candidateId": "clv1a...",
    "assessmentId": "clv2b...",
    "sendEmail": true,
    "expiryDays": 3
  }
}

• sendEmail defaults to true - set false to deliver interviewUrl yourself.
• expiryDays defaults to 3 and controls how long the interview link stays valid.
• interviewUrl and token are both returned so you can either redirect the candidate directly or store the token for your own link generation.