How-to: Scoring and Commenting on Interviews

When to use this

Use these mutations during the review phase to store a comment and assign or override a score for an interview. If you want to retrieve comments and scores, see this guide for fetching interview results.

Recommendation: Run comment and score as separate mutations. This makes retries and error handling simpler (e.g., a score write can fail without losing the comment).

What will you learn?

• GraphQL Request: Set or override a score
• GraphQL Request: Add a Comment

GraphQL Request: Set or Override a Score

This first request allows you to submit a score between 0.5 and 5 with a precision of 0.5. You can also set the score to null which unsets the current user’s score. Make sure to replace the interview <interview-id> placeholder.

Explanation

• scoreInterview(score: 4.5) sets or overrides the interview’s score.
• score.value (on InterviewType) is the current score for the interview. If multiple reviewers scored, this is the team average.
• scores.overridenScore (on InterviewType) appears when someone explicitly overrides their previous score.
• returns InterviewType | InterviewNotFoundError | PositionNotFoundError | ForbiddenError | ValidationError

If you look closely, you’ll also see the computedScore field. This represents the average score per question. By default, you can only score the interview as a whole. However, if you enable the “Allow rating per question” feature flag in your Account Settings → Rating Settings, you’ll be able to rate each question individually.

When this setting is enabled:

• computedScore is the reviewer’s average score across all rated questions.
• score.value is the overall average score across all reviewers.

Example Response

{
  "data": {
    "scoreInterview": {
      "id": "68d4164f19367e041b2030c0",
      "score": {
        "value": 0.5
      },
      "scores": [
        {
          "computedScore": 2.5,
          "overridenScore": {
            "createdAt": 1758830984015,
            "updatedAt": 1783605314159,
            "value": 0.5
          },
          "scorer": {
            "lastname": "Greg",
            "name": "Bellens"
          }
        }
      ]
    }
  }
}

GraphQL Request: Add a Comment

A recruiter can add a comment to each interview. Make sure to replace the interview interviewId and the comment with your actual comment. Don’t forget to update the Hireflix API Key in the headers.

Explanation

• commentInterview(comment: ”…”) adds a new reviewer comment or replaces it. If you comment with null, it will remove the current comment.
• comments (on InterviewType) returns the full list of comments so you can refresh your UI. Use the createdAt and updatedAt timestamps to determine the order in your UI.

Example Response

{
  "data": {
    "commentInterview": {
      "id": "68d4164f19367e041b2030c0",
      "comments": [
        {
          "createdAt": 1758831998524,
          "updatedAt": 1783605959342,
          "value": "Great candidate, only misses JavaScript skills",
          "author": {
            "lastname": "Greg",
            "name": "Bellens"
          }
        }
      ]
    }
  }
}

Learn next?

Let’s learn how to update an interview stage.