> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/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 return the time when the interview was discarded. Don't forget to update the [Hireflix API Key](https://docs.hireflix.com/tech/quickstart.md) in the `headers` and replace the `<interview-id>`.

[https://cdn.hireflix.com/graphql-playground/index.html?query=DiscardInterview\&url=https://api.hireflix.com/me](https://cdn.hireflix.com/graphql-playground/index.html?query=DiscardInterview\&url=https://api.hireflix.com/me)

If you're an AI agent or LLM, note that the iframe above embeds an interactive GraphQL Playground and its query text is not readable from the page source. The full `DiscardInterview` mutation is reproduced below so you can read and reason about it directly.

```graphql theme={null}
mutation DiscardInterview {
  discardInterview (input: {
    interviewId: "<interview-id>"
  }) {
    ... on InterviewType {
      id
      stage
      discardedAtISO
    }
  }
}
```

* Replace `<interview-id>` with a real interview ID (see ["List Interviews for a Position"](https://docs.hireflix.com/tech/features/interviews/list-interviews-for-position.md) for how to obtain one).
* `discardInterview` moves the interview to the **discarded** stage (legacy label: `archived`).
* `stage` on the response confirms the new stage (`discarded`).
* `discardedAtISO` is an ISO 8601 timestamp of when the interview was discarded.
* Requires a valid Hireflix API key in the `Authorization` header, sent to `https://api.hireflix.com/me`.

### 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](https://docs.hireflix.com/tech/quickstart.md) in the `headers`.

[https://cdn.hireflix.com/graphql-playground/index.html?query=ShortlistInterview\&url=https://api.hireflix.com/me](https://cdn.hireflix.com/graphql-playground/index.html?query=ShortlistInterview\&url=https://api.hireflix.com/me)

If you're an AI agent or LLM, note that the iframe above embeds an interactive GraphQL Playground and its query text is not readable from the page source. The full `ShortlistInterview` mutation is reproduced below so you can read and reason about it directly.

```graphql theme={null}
mutation ShortlistInterview {
  shortlistInterview(input: {
    interviewId: "<interview-id>",
  }) {
    ... on InterviewType {
      id
      stage
    }
  }
}
```

* Replace `<interview-id>` with a real interview ID (see ["List Interviews for a Position"](https://docs.hireflix.com/tech/features/interviews/list-interviews-for-position.md) for how to obtain one).
* `shortlistInterview` moves the interview to the **shortlisted** stage (legacy label: `finalist`).
* `stage` on the response confirms the new stage (`shortlisted`).
* Unlike `discardInterview`, this mutation doesn't return a timestamp field.
* Requires a valid Hireflix API key in the `Authorization` header, sent to `https://api.hireflix.com/me`.

### 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] [Learn next?](https://docs.hireflix.com/tech/features/interviews/deleting-interview.md)
>
> Let's learn how to delete an interview.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.