# Run, resume, and retry workflow jobs

Start workflow jobs, track jobs, nodes, file executions, and results, and pause, resume, rerun, retry, cancel, or delete jobs when needed. This page does not modify workflow definitions; maintain workflows and templates in [Manage workflows and templates](workflows-templates.md).

## Prerequisites

Prepare credentials that can access the target workspace and the ID of the workflow to run. For service endpoints, authentication, and general request formats, see [Prepare to call an API](../../api-call-basics.md).

Before pausing, resuming, retrying, canceling, rerunning, or deleting an existing job, obtain its ID from the job list or details.

## Call sequence

1. Start a workflow job and retain its job ID. For an existing job, list or get details first to identify the current object.
2. Query job details, nodes, file execution records, and job results to inspect the run, nodes, file processing, and output separately.
3. Refresh status to update current job information. To stop or continue temporarily, use pause and resume in that order.
4. When processing must run again, get the rerun plan first, then rerun from a specified node, or retry individual or batch jobs. Cancel a rerun or job when needed.
5. Delete a job only after confirming that it no longer needs to be retained.

## API operations

### Start and view jobs

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Start a workflow job | [Start a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-jobs/start-workflow-job.md) | Create one run for a workflow. |
| Query workflow jobs | [List workflow jobs](../../../../reference/api/ai-studio/data-processing/workflow-jobs/list-workflow-jobs.md) | Find a job or obtain a target job ID. |
| Query workflow job details | [Get workflow job details](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job.md) | Inspect current information for one job. |
| Query workflow job nodes | [Get a workflow job node](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-node.md) | View nodes in a job. |
| Query file execution records | [List file executions](../../../../reference/api/ai-studio/data-processing/workflow-jobs/list-file-executions.md) | Inspect file-processing records. |
| Query workflow job results | [Get a workflow job result](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-result.md) | Obtain or inspect a job result. |
| Refresh workflow job status | [Refresh workflow job status](../../../../reference/api/ai-studio/data-processing/workflow-jobs/refresh-workflow-job.md) | Refresh the current job status. |

### Control jobs

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Pause a workflow job | [Pause a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-jobs/pause-workflow-job.md) | Stop a target job temporarily. |
| Resume a workflow job | [Resume a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-jobs/resume-workflow-job.md) | Continue a paused job. |
| Cancel a workflow job | [Cancel a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-jobs/cancel-workflow-job.md) | You no longer need the target job to continue. |
| Delete a workflow job | [Delete a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-jobs/delete-workflow-job.md) | You confirmed that the job no longer needs to be retained. |

### Rerun and retry

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Query a node-rerun plan | [Get a node-rerun plan](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-node-rerun-plan.md) | Confirm an available plan before rerunning from a specified node. |
| Rerun from a specified node | [Create a node rerun](../../../../reference/api/ai-studio/data-processing/workflow-reruns/create-node-rerun.md) | Start processing again from a selected node. |
| Query workflow reruns | [List workflow reruns](../../../../reference/api/ai-studio/data-processing/workflow-reruns/list-workflow-reruns.md) | Find existing rerun records. |
| Query workflow rerun details | [Get a workflow rerun](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-workflow-rerun.md) | Inspect current information for one rerun. |
| Cancel a workflow rerun | [Cancel a workflow rerun](../../../../reference/api/ai-studio/data-processing/workflow-reruns/cancel-workflow-rerun.md) | You no longer need the target rerun to continue. |
| Retry a workflow job | [Retry a workflow job](../../../../reference/api/ai-studio/data-processing/workflow-retries/retry-workflow-job.md) | Retry one job. |
| Retry workflow jobs in bulk | [Batch retry workflow jobs](../../../../reference/api/ai-studio/data-processing/workflow-retries/batch-retry-workflow-jobs.md) | Retry multiple jobs together. |

## Confirm the result

After starting, resuming, canceling, rerunning, or retrying, use [Get workflow job details](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job.md) or [Get a workflow rerun](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-workflow-rerun.md) to inspect current information. To confirm output, use [Get a workflow job result](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-result.md).

## Limitations and notes

- Starting, resuming, retrying, or rerunning means the relevant operation was initiated. Job details, nodes, file execution records, and results confirm later progress.
- Before cancellation, deletion, or rerunning, confirm the impact on the target job and its output.

## Next steps

- [Manage workflows and templates](workflows-templates.md)
- [Manage workflow artifacts and data lineage](workflow-artifacts-lineage.md)