---
title: "Hold all pending jobs"
method: POST
path: "/jobs/hold_all"
tags: ["Jobs"]
---

# Hold all pending jobs

`POST /jobs/hold_all`

## Request

- Base URL: `https://localhost/index.php/api`
- URL: `https://localhost/index.php/api/jobs/hold_all`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/docs/jobs/hold_all/post.ts> (a function with typed inputs; its response is checked against the schema)

Admin only. Sets all pending jobs to held status so the worker skips them. Use this to pause the queue for testing without deleting jobs.

## Response `200`

Jobs held successfully

- object
  - `status` string
  - `message` string
  - `held_count` integer

## Other responses

- `403`: Access denied (admin only)

## Changes

- **2026-05-24** `1ff58dcd71a4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/changes/jobs/hold_all/post.md)

---

[API](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api.md) - [All operations](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/revisions/755536b6492e?raw)