How-to: Updating Interview Status

When to use this

Use these mutations to update the status of an interview through the Hireflix API. For example, mark a candidate as discarded or shortlisted (finalist) after review. This how-to guide shows both mutations.

This allows your system to stay in sync with Hireflix when recruiters move candidates between stages in your ATS or workflow.

GraphQL Request: Discard an Interview

Use this mutation to move a candidate to the discarded stage and returns the time when the interview was discarded. Don’t forget to update the Hireflix API Key in the headers and replace the <interview-id>.

Explanation

• discardInterview(interviewId) — the ID of the interview you want to update to discarded stage (legacy label: archived).
• discardedAtISO — timestamp indicating when the interview was archived.

Example Response

{
  "data": {
    "discardInterview": {
      "id": "68d4164f19367e041b2030c0",
      "stage": "discarded",
      "discardedAtISO": "2026-07-09T14:23:08.667Z"
    }
  }
}

GraphQL Request: Shortlist an Interview

Use this mutation to move a candidate to the shortlisted (legacy label: finalist) stage. Don’t forget to update the <interview-id> placeholder and Hireflix API Key in the headers.

Explanation

• shortlistInterview(interviewId) — the ID of the interview you want to update to shortlisted stage.

Example Response

{
  "data": {
    "shortlistInterview": {
      "id": "68d4164f19367e041b2030c0",
      "stage": "shortlisted"
    }
  }
}

Learn next?

Let’s learn how to fetch positions.