---
title: "Read live suspension progress without waking the workspace"
method: GET
path: "/v1/operations/{operation_id}/progress"
tags: ["Operations"]
---

# Read live suspension progress without waking the workspace

`GET /v1/operations/{operation_id}/progress`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/operations/{operation_id}/progress`
- Auth: HTTP bearer

## Path parameters

- `operation_id` string, uuid, required

## Response `200`

Default Response

- object
  - `progress` SuspendProgress, required
    - `operation_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `state` 'queued' | 'capacity_pending' | 'running' | 'succeeded' | 'failed' | 'canceled', required
    - `workspace_state` 'creating' | 'starting' | 'running' | 'suspending' | 'suspended' | 'resuming' | 'forking' | 'stopping' | 'failed' | 'deleting' | 'deleted', required
    - `phase` string, required: Actual snapshot preparation/capture phase, or an explicitly unavailable control status.
    - `cancelable` boolean, required: True only while the host can acknowledge cancellation before its capture cut.
    - `supported` boolean, required
    - `safe_action` 'wait_for_terminal' | 'resume' | 'retry_tools' | 'inspect_failure', required
    - `phase_started_at` string, date-time: RFC 3339 UTC timestamp with Z.
    - `deadline_at` string, date-time: RFC 3339 UTC timestamp with Z.
    - `accepted` boolean

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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