---
title: "POST /jobs/{jobId}/archive"
method: POST
path: "/jobs/{jobId}/archive"
tags: ["Jobs"]
---

# POST /jobs/{jobId}/archive

`POST /jobs/{jobId}/archive`

## Request

- Base URL: `https://api.fergus.com`
- URL: `https://api.fergus.com/jobs/{jobId}/archive`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.fergus.com/oauth2/authorize`
    - Token URL: `https://auth.fergus.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/fergus/apis/fergus-api/docs/jobs/:jobId/archive/post.ts> (a function with typed inputs; its response is checked against the schema)

Archives a job, including a draft. Requires ARCHIVE_JOB. Clears hold and pending-archive flags, removes past and future schedule entries, and records an audit log. Already archived jobs succeed without further changes. No request body is required.

## Path parameters

- `jobId` number, required

## Response `204`

Job archived

## Other responses

- `4XX`: Client Request Errors
- `5XX`: Server Errors

## Changes

- **2026-10-21** `5b346032eff4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fergus/apis/fergus-api/changes/jobs/:jobId/archive/post.md)

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) - [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fergus/apis/fergus-api/revisions/6135f517c3bf?raw)