Skip to main content

​
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

This first request allows you to submit a score between 1 and 5 with a precision of 0.5. Make sure to replace the interview ID.

​
Explanation

  • score(score: 4.5) sets or overrides the interview’s score.
  • score.value is the current score for the interview. If multiple reviewers scored, this is the team average.
  • scores.overridenScore appears when someone explicitly overrides their previous score.
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": {
    "Interview": {
      "score": {
        "id": "68d4164f19367e041b2030c0",
        "score": {
          "value": 4.5
        },
        "scores": [
          {
            "computedScore": 0,
            "overridenScore": {
              "createdAt": 1758830984015,
              "updatedAt": 1760199630540,
              "value": 4.5,
              "__typename": "InterviewTeamMemberOverridenScore"
            },
            "scorer": {
              "name": "Michiel"
            }
          }
        ]
      }
    }
  }
}

​
GraphQL Request: Add a Comment

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

​
Explanation

  • comment(comment: ”…”) adds a new reviewer comment.
  • comments 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": {
    "Interview": {
      "comment": {
        "comments": [
          {
            "createdAt": 1758831998524,
            "updatedAt": 1760199630231,
            "value": "Great interview!",
            "author": {
              "name": "Michiel"
            }
          }
        ]
      }
    }
  }
}

Learn next?

Let’s learn how to update an interview status.