> ## Documentation Index
> Fetch the complete documentation index at: https://hireflixsl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/quickstart) in the `headers` and replace the `<interview-id>`.

<iframe src="https://cdn.hireflix.com/graphql-playground/index.html?query=DiscardInterview&url=https://api.hireflix.com/me" width="100%" height="750" />

### 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

```json theme={null}
{
  "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](/quickstart) in the `headers`.

<iframe src="https://cdn.hireflix.com/graphql-playground/index.html?query=ShortlistInterview&url=https://api.hireflix.com/me" width="100%" height="750" />

### Explanation

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

### Example Response

```json theme={null}
{
  "data": {
    "shortlistInterview": {
      "id": "68d4164f19367e041b2030c0",
      "stage": "shortlisted"
    }
  }
}
```

<Card title="Learn next?" icon="arrow-right" color="#5863ff" horizontal href="/features/positions/fetching-positions">
  Let's learn how to fetch positions.
</Card>