Resume Run | Onepin

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "workflow_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "running",
    "run_number": 5,
    "token_cost": 350,
    "created_at": "2024-04-10T13:55:00Z",
    "updated_at": "2024-04-10T14:15:00Z",
    "total_nodes": 12,
    "total_steps": 48,
    "finished_steps": 20,
    "usage_summary": {
      "api_calls": 15,
      "cpu_seconds": 120,
      "memory_mb": 512
    },
    "started_at": "2024-04-10T14:00:00Z",
    "completed_at": null,
    "pause_requested_at": null,
    "paused_at": null,
    "error": null,
    "has_export": true,
    "triggered_by": {
      "user_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "user_name": "jane.doe@example.com"
    },
    "credits": 25
  },
  "meta": {
    "request_id": "req_9f8b7c6d5e4a3b2c1d0e",
    "timestamp": "2024-04-10T14:15:01Z"
  }
}

Resume a paused workflow run from its last completed wave.

Transitions the run from paused back to running and schedules execution to continue from where it left off — no nodes that already completed are re-executed.

Returns 409 if the workspace already has another active run for this workflow, or if the caller is at the concurrent-run limit. In that case the run stays paused and the caller can retry later. Only runs in paused status can be resumed; attempting to resume a running, completed, failed, or cancelled run returns 409.

Resume a paused workflow run from its last completed wave. Transitions the run from `paused` back to `running` and schedules execution to continue from where it left off — no nodes that already completed are re-executed. Returns 409 if the workspace already has another active run for this workflow, or if the caller is at the concurrent-run limit. In that case the run stays `paused` and the caller can retry later. Only runs in `paused` status can be resumed; attempting to resume a `running`, `completed`, `failed`, or `cancelled` run returns 409.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

run_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.onepin.ai/api/v1/workflows/workflow_id/runs/run_id/resume \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'