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

# POST /jobs/{jobId}/hold

`POST /jobs/{jobId}/hold`

## Request

- Base URL: `https://api.fergus.com`
- URL: `https://api.fergus.com/jobs/{jobId}/hold`
- 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/hold/post.ts> (a function with typed inputs; its response is checked against the schema)

Puts a job on hold

## Path parameters

- `jobId` integer, required

## Request body

- object
  - `holdUntil` string, date, required
  - `notes` string, required

## Response `204`

Job put on hold successfully

## Other responses

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

---

[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)