---
title: "Pause Dedicated Run"
method: POST
path: "/api/v1/training/runs/{run_id}/pause"
tags: ["training"]
---

# Pause Dedicated Run

`POST /api/v1/training/runs/{run_id}/pause`

## Request

- Base URL: `https://api.primeintellect.ai`
- URL: `https://api.primeintellect.ai/api/v1/training/runs/{run_id}/pause`
- Auth: HTTP bearer

Pause a running dedicated run for good at its next checkpoint.

The run turns PAUSING, then PAUSED once its checkpoint is back on its
volume in R2 and its GPUs are released. Resume it with a new run from
that volume: `resumeFrom` on POST /runs.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- PauseRunResponse
  - `runId` string, required
  - `status` string, required

## Other responses

- `401`: Authorization failed
- `422`: Invalid request data

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-10-16** `81d59fc08a23`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/training/runs/:run_id/pause/post.md)

---

[API](https://skmtc.dev/primeintellect/apis/pi-api.md) - [All operations](https://skmtc.dev/primeintellect/apis/pi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primeintellect/apis/pi-api/revisions/7f032a9306b0?raw)