---
title: "Resume the command with retained checkpoint files"
method: POST
path: "/v1/workloads/{id}/resume"
tags: ["Workloads"]
---

# Resume the command with retained checkpoint files

`POST /v1/workloads/{id}/resume`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/workloads/{id}/resume`
- Auth: HTTP bearer

Requires a running checkpointed batch workload with useful saved state and a compatible runner. Freeze returns intent until checkpoint and exact compute cleanup are confirmed. Resume requires completed cleanup, preserves selected saved files and restarts the same customer command. Storage bytes are reported separately from unknown storage charges.

## Path parameters

- `id` string, required

## Response `202`

Resume the command with retained checkpoint files

- WorkloadFreeze: Saved checkpoint files and verified compute cleanup. Freeze and resume do not restore arbitrary process memory. The customer command must load its checkpoint.
  - `id` string, required
  - `workload_id` string, required
  - `stage_id` string, required
  - `manifest_id` string
  - `reason` string
  - `generation` integer, required
  - `state` 'requested' | 'releasing' | 'frozen' | 'resuming' | 'resumed' | 'failed', required
  - `requested_at` string, date-time, required
  - `frozen_at` string, date-time, nullable, required
  - `retained_bytes` integer, required
  - `storage_charge_micros` integer, nullable, required: Null while retained storage is not separately metered. Do not infer a zero charge.
  - `storage_billing_status` 'retained_storage_not_separately_metered', required

## Other responses

- `default`: Authentication, disabled feature, invalid input, missing pool or host, rate limits, and transient failures apply.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)