Skip to main content
To use the Unstructured API’s workflow operations to manage jobs, do the following:
  • To get a list of available jobs, use the UnstructuredClient object’s jobs.list_jobs function (for the Python SDK) or the GET method to call the /jobs endpoint (for curl or Postman). Learn more.
  • To get basic information about a job, use the UnstructuredClient object’s jobs.get_job function (for the Python SDK) or the GET method to call the /jobs/<job-id> endpoint (for curl or Postman). Learn more.
  • To get information about a job’s current processing status, use the UnstructuredClient object’s jobs.get_job_details function (for the Python SDK) or the GET method to call the /jobs/<job-id>/details endpoint (for curl or Postman). Learn more.
  • To get the list of any failed files for a job and why those files failed, use the UnstructuredClient object’s jobs.get_failed_files function (for the Python SDK) or the GET method to call the /jobs/<job-id>/failed-files endpoint (for curl or Postman). Learn more.
  • To 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 (known as an on-demand job), use the POST method to call the /jobs/ endpoint for curl or Postman. Learn more.
  • A job is created automatically whenever a workflow runs on a schedule; see Create a workflow. A job is also created automatically whenever you run a workflow manually; see Run a workflow.
  • To cancel a running job, use the UnstructuredClient object’s jobs.cancel_job function (for the Python SDK) or the POST method to call the /jobs/<job-id>/cancel endpoint (for curl or Postman). Learn more.