Show Job

Overview

The "Show Job" functionality enables users to retrieve the current status and details of a previously created job within Woflow's platform. By querying a specific API endpoint with the job's unique identifier, users can gain insights into the job's progress, state, and any associated data. This feature provides transparency and real-time tracking of tasks, ensuring users remain informed about their operations within Woflow. Whether a job is in progress, completed, or requires client intervention, the "Show Job" endpoint delivers a comprehensive snapshot at any given time.

Job States

This section details the various states a job can be in, providing users with understanding of each state's meaning.

State	Description
in_progress	Job is being actively worked on and under way.
pending_approval	Job is ready for review from the client, and is pending approval.
export_in_progress	Job has been approved by the client, and the export is in progress.
export_failed	A failure occured during the export process.
client_action_required	Job cannot be processed because it requires further action from the client. Progress has been temporarily suspended.
flagged	Completed job has been submitted back to Woflow for rework due to quality error.
cancelled	Customer requested to cancel the job while it was in progress.
failed	An unexpected technical error occurred and the job cannot be completed.
completed	Job has been completed and data deliverables are ready.

Example Request

To retrieve the status and details of a job, use the following request format:

curl --location 'https://gateway.woflow.com/v1/jobs/<job_id>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token api_key=<api_key>'

Example Response

{
  "id": "9df1f4d5-3c8d-45c2-8fc3-618c18daa9b2",
  "state": "initiated",
  "processing_type": "standard",
  "results": {}
}