> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sarasfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resume Workflow

> Resume a paused workflow run, submitting approvals or new input payloads.

### Body Parameters

<ParamField body="subProjectId" type="string" placeholder="sp_123" required>
  The unique identifier for the sub-project.
</ParamField>

<ParamField body="runId" type="string" placeholder="run_123" required>
  The unique identifier for the paused workflow run.
</ParamField>

<ParamField body="payload" type="object">
  Key-value map containing variables or slots updates to feed back into the workflow context.
</ParamField>

<ParamField body="approved" type="boolean" default="false">
  Approval decision for Human-in-the-Loop steps (pass `true` to approve, `false` to reject/deny).
</ParamField>

### Response

<ResponseField name="runId" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      The unique identifier for the workflow run resumed.
    </ResponseField>

    <ResponseField name="state" type="string">
      The updated state of the workflow run (e.g. `RACING`, `COMPLETED`).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --location 'https://api.sarasfinance.com/v1/process/workflows/resumeWorkflowRunsApi' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
      "subProjectId": "93d599a6-a396-4ef6-b30e-aff95c56c523",
      "runId": "run_017b2c9a",
      "approved": true,
      "payload": {
          "overrideComments": "Verified by Compliance Team"
      }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "runId": {
      "id": "run_017b2c9a",
      "state": "RACING"
    }
  }
  ```
</ResponseExample>

### Error Codes

| Code                                       | ID   | Description                                        |
| :----------------------------------------- | :--- | :------------------------------------------------- |
| `ERROR_PROCESS_META_IS_MISSING_IN_REQUEST` | 1200 | Metadata missing in request (e.g. `runId` missing) |
| `ERROR_SUBPROCESS_META_NOT_FOUND`          | 1202 | Sub-project metadata not found                     |
| `ERROR_NOT_ALLOWED_TO_CALL_METHOD`         | 1209 | User unauthorized to resume workflow runs          |