Skip to main content

​
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, thedata.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.

​
Explanation

  • input.id — the position to archive.
  • data.archived — 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

{
  "data": {
    "archivePosition": {
      "__typename": "MutationArchivePositionSuccess",
      "data": {
        "id": "68d53cf0a3d3c03c50f103c3",
        "name": "DevRel Manager",
        "archived": 1758806647378
      }
    }
  }
}
Position not found 
{
  "data": {
    "archivePosition": {
      "__typename": "PositionNotFoundError",
      "code": 404,
      "message": "Position not found",
      "name": "PositionNotFoundError"
    }
  }
}

Learn next?

Let’s learn how to delete a position.