---
title: "List Paused Executions"
method: GET
path: "/api/workflows/{id}/paused"
tags: ["Human in the Loop"]
---

# List Paused Executions

`GET /api/workflows/{id}/paused`

List all paused executions for a workflow. Workflows pause at Human in the Loop blocks and wait for input before continuing. Use this endpoint to discover which executions need attention.

## Path parameters

- `id` string, required

## Query parameters

- `status` string

## Response `200`

List of paused executions.

- object
  - `pausedExecutions` PausedExecutionSummary[]
    - `id` string — Unique identifier for the paused execution record.
    - `workflowId` string — The workflow this execution belongs to.
    - `executionId` string — The execution that was paused.
    - `status` string — Current status of the paused execution.
    - `totalPauseCount` integer — Total number of pause points in this execution.
    - `resumedCount` integer — Number of pause points that have been resumed.
    - `pausedAt` string, date-time, nullable — When the execution was paused.
    - `updatedAt` string, date-time, nullable — When the paused execution record was last updated.
    - `expiresAt` string, date-time, nullable — When the paused execution will expire and be cleaned up.
    - `metadata` object, nullable — Additional metadata associated with the paused execution.
    - `triggerIds` string[] — IDs of triggers that initiated the original execution.
    - `pausePoints` PausePoint[] — List of pause points in the execution.
      - `contextId` string — Unique identifier for this pause context. Used when resuming execution.
      - `blockId` string — The block ID where execution paused.
      - `response` unknown
      - `registeredAt` string, date-time — When this pause point was registered.
      - `resumeStatus` 'paused' | 'resumed' | 'failed' | 'queued' | 'resuming' — Current status of this pause point.
      - `snapshotReady` boolean — Whether the execution snapshot is ready for resumption.
      - `resumeLinks` object — Links for resuming this pause point.
        - `apiUrl` string, uri — API endpoint URL to POST resume input to.
        - `uiUrl` string, uri — UI URL for a human to review and approve.
        - `contextId` string — The context ID for this pause point.
        - `executionId` string — The execution ID.
        - `workflowId` string — The workflow ID.
      - `queuePosition` integer, nullable — Position in the resume queue, if queued.
      - `latestResumeEntry` ResumeQueueEntry — An entry in the resume execution queue.
        - `id` string — Unique identifier for this queue entry.
        - `pausedExecutionId` string — The paused execution this entry belongs to.
        - `parentExecutionId` string — The original execution that was paused.
        - `newExecutionId` string — The new execution ID created for the resume.
        - `contextId` string — The pause context ID being resumed.
        - `resumeInput` unknown
        - `status` string — Status of this queue entry (e.g., pending, claimed, completed, failed).
        - `queuedAt` string, date-time, nullable — When the entry was added to the queue.
        - `claimedAt` string, date-time, nullable — When execution started processing this entry.
        - `completedAt` string, date-time, nullable — When execution completed.
        - `failureReason` string, nullable — Reason for failure, if the resume failed.
      - `parallelScope` object — Scope information when the pause occurs inside a parallel branch.
        - `parallelId` string — Identifier of the parallel execution group.
        - `branchIndex` integer — Index of the branch within the parallel group.
        - `branchTotal` integer — Total number of branches in the parallel group.
      - `loopScope` object — Scope information when the pause occurs inside a loop.
        - `loopId` string — Identifier of the loop.
        - `iteration` integer — Current loop iteration number.

## Other responses

- `400` — Invalid request parameters. Check the details array for specific validation errors.
- `401` — Invalid or missing API key. Ensure the X-API-Key header is set with a valid key.
- `403` — Access denied. You do not have permission to access this resource. For audit log endpoints, this requires an Enterprise subscription and organization admin/owner role.
- `404` — The requested resource was not found. Verify the ID is correct and belongs to your workspace.

---

[API](https://skmtc.net/simstudioai/apis/sim-api.md) · [All operations](https://skmtc.net/simstudioai/apis/sim-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/simstudioai/sim-api/versions/66a471c5b1df/schema)