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

# Jobs

> Manage Unstructured workflow jobs with the Python SDK or REST API. List jobs, monitor processing status, inspect failed files, and cancel running jobs.

A workflow job is created automatically whenever:

* A workflow runs on a schedule. For more details see [Create workflow](/api-reference/api/workflow/create-workflow).
* You run a workflow manually. For more details see [Run workflow](/api-reference/api/workflow/run-workflow).

To use the [Unstructured Pipeline API](/api-reference/workflow/overview) to manage jobs, do the following:

| Task                                                                                                                             | Python function         | curl                                                                               |
| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------- |
| Get a list of available jobs                                                                                                     | `jobs.list_jobs`        | `GET` [`/jobs`](/api-reference/api/job/list-jobs)                                  |
| Get basic information about a job                                                                                                | `jobs.get_job`          | `GET` [`/jobs/<job-id>`](/api-reference/api/job/get-job)                           |
| Get information about a job's current processing status                                                                          | `jobs.get_job_details`  | `GET` [`/jobs/<job-id>/details`](/api-reference/api/job/get-job-details)           |
| Get the list of any failed files for a job and why those files failed                                                            | `jobs.get_failed_files` | `GET` [`/jobs/<job-id>/failed-files`](/api-reference/api/job/get-job-failed-files) |
| Run a workflow that takes one or more local files only as input, and the workflow exists only for the duration of that job's run |                         | `POST` [`/jobs/`](/api-reference/api/job/create-job)                               |
| Cancel a running job                                                                                                             | `jobs.cancel_job`       | `POST` [`/jobs/<job-id>/cancel`](/api-reference/api/job/cancel-job)                |

A workflow job is created automatically whenever:

* A workflow runs on a schedule. For more details see [Create workflow](/api-reference/api/workflow/create-workflow).
* You run a workflow manually. For more details see [Run workflow](/api-reference/api/workflow/run-workflow).

<Tip>
  Visit the [Unstructured documentation samples repo](https://github.com/Unstructured-IO/docs-samples/tree/main/postman) on GitHub for Postman Collections that demonstrate the API requests discussed in this topic. To import any of these Postman collections:

  1. Browse to the [postman folder](https://github.com/Unstructured-IO/docs-samples/tree/main/postman) in the repo, and select the collection file you want to import.
  2. Click the **Raw** icon, and then copy the URL for the raw JSON file.
  3. In your Postman workspace, click **Import**, and then paste in the file URL.

  To learn about Postman Collections, see [Manage and organize Postman Collections](https://learning.postman.com/latest-v-12/docs/use/use-collections/manage-collections) in the Postman Docs.
</Tip>