> ## 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: Archiving a Position

## When to use this

Archive a position when it should no longer accept new submissions or invites. Archiving hides the position from “active” lists but **keeps all past interviews** intact.

## GraphQL Request

This mutation request requires a position ID of the position you would like to archive.

* On **success**, the`data.archived` field will be set to an epoch-milliseconds timestamp.
* On **error**, the `__typename` field is set to `PositionNotFoundError`. Use `code`/`message` to inform the user.

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

### Explanation

* **input.id** — the position to archive.
* **data.archivedAtISO** — non-null indicates the position is archived and contains the epoch timestamp of when it was archived.
* **active** — may remain `true` even when archived; your UI should primarily rely on `archived` to filter “closed” positions.

### Example Response

```json theme={null}
{
  "data": {
    "archivePosition": {
      "__typename": "MutationArchivePositionSuccess",
      "data": {
        "id": "68d53cf0a3d3c03c50f103c3",
        "name": "DevRel Manager",
        "archivedAtISO": "2026-07-08T13:27:37.333Z"
      }
    }
  }
}
```

**Position not found**

```json theme={null}
{
  "data": {
    "archivePosition": {
      "__typename": "PositionNotFoundError",
      "code": 404,
      "message": "Position not found",
      "name": "PositionNotFoundError"
    }
  }
}
```

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