List Paused Executions

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.

GET/api/workflows/{id}/paused

Authorization

apiKey
X-API-Key<token>

Your Sim API key (personal or workspace). Generate one from the Sim dashboard under Settings > API Keys.

In: header

Path Parameters

id*string

The unique identifier of the workflow.

Query Parameters

status?string

Filter paused executions by status.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET \  "https://www.sim.ai/api/workflows/{id}/paused?status=paused" \  -H "X-API-Key: YOUR_API_KEY"
{
  "pausedExecutions": [
    {
      "id": "pe_abc123",
      "workflowId": "wf_1a2b3c4d5e",
      "executionId": "exec_9f8e7d6c5b",
      "status": "paused",
      "totalPauseCount": 1,
      "resumedCount": 0,
      "pausedAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z",
      "expiresAt": null,
      "metadata": null,
      "triggerIds": [],
      "pausePoints": [
        {
          "contextId": "ctx_xyz789",
          "blockId": "block_hitl_1",
          "registeredAt": "2026-01-15T10:30:00Z",
          "resumeStatus": "paused",
          "snapshotReady": true,
          "resumeLinks": {
            "apiUrl": "https://www.sim.ai/api/resume/wf_1a2b3c4d5e/exec_9f8e7d6c5b/ctx_xyz789",
            "uiUrl": "https://www.sim.ai/resume/wf_1a2b3c4d5e/exec_9f8e7d6c5b",
            "contextId": "ctx_xyz789",
            "executionId": "exec_9f8e7d6c5b",
            "workflowId": "wf_1a2b3c4d5e"
          },
          "response": {
            "displayData": {
              "title": "Approval Required",
              "message": "Please review this request"
            },
            "formFields": []
          }
        }
      ]
    }
  ]
}
{
  "error": "string",
  "details": [
    {}
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}