Skip to main content

Managing and Tracking Job Results

The Job Details page provides detailed information about a function invocation, including execution status, configuration, and results.

Job status​

A job passes through these states:

StateMeaning
QueuedWaiting for the selected device to become available
RunningThe device is executing the job
DoneExecution finished successfully; results are available
ErrorExecution failed; open the job to see the details

Only jobs in the Done state display full result data. For why a job may wait in Queued, see Job queue.

Accessing Job Details​

The Job Details page can be accessed in the following ways:

From Function Details​

From the Functions page, select the function name you want to view.

On the Function Details page, locate the Related Jobs section.

Select a job from the list to open its Job Details view.

Jobs are grouped by function. Jobs created using different providers or devices are all displayed in the same job list for that function.

From Function Details

From Provider Details​

From the Providers section, navigate to the provider details view.

provider

Select a job associated with the provider to open the Job Details page.

provider-jobs

Job Information​

Job Information

The top section of the Job Details page displays general execution information, including:

  • Job ID Unique identifier of the job.
  • Function Name The function that was invoked.
  • Function Version The version of the function used for execution.
  • Run By The user who invoked the job.
  • Created / Started / Finished Timestamps indicating the job lifecycle.
  • Retry Job Number of retry attempts used and remaining.

Job Execution Timeline​

Job Execution Timeline

The execution timeline shows the progress of the job across different stages:

  • Estimation
  • Registration
  • Preparation
  • Execution
  • Analysis
  • Completion

Each stage includes a timestamp indicating when it started.

Job Data​

This section displays the execution configuration used for the job:

  • Total Completion Time
  • Provider
  • Device
  • Shots
  • Description
  • Input

Job Result​

The Job Result section presents the output generated by the execution.

Available views may include:

  • Circuit Visual representation of the executed quantum circuit.

Circuit

  • Histogram Measurement results displayed as a chart or table.

Histogram

  • JSON Raw result data in JSON format.

JSON

Failure Details​

When a job fails (a red cross in Status), the job page shows Failure Details above Job Result: the error code and the stage where it failed, what went wrong down to the line of your code, and How to fix. A Your action needed badge means the cause is in your input or your handler code rather than in the platform.

Failure Details of a job run without its required input: the error code, the cause and How to fix highlighted

Two failures you can cause from the invocation form:

CodeTypical cause
INPUT_MISSING_FIELDThe function reads a field that the input does not contain, for example an empty input.
HANDLER_ERRORAn error inside your handler code, for example a value sent as a number by form-data where the code expects text.

Actions on a job​

  • Refresh — updates the job status and result data.
  • Archive — moves a finished job out of the working job list. Use it for jobs you no longer need to see day to day.

Archiving a job​

Archiving is not deleting. An archived job keeps its results and stays readable; it simply leaves the main job list so the list reflects your current work.

To archive a job, open it and select Archive from its actions.

Restoring an archived job​

Restoring is a System Admin operation. A project member cannot restore a job themselves — raise a support request.

  1. The System Admin opens the Jobs Archive screen and selects the job.
  2. Selecting Restore returns the job to its original project with its original status.
  3. The page reloads and the job appears in the project's job list again.

If the restore fails because of a network or server error, the matching error message is shown and the job stays archived. The operation can be retried.

Notes​

  • Only completed jobs display full result data.
  • Job results depend on the selected provider and device.
  • Archived jobs remain accessible for review — archiving never discards results.
  • Retry Job shows how many automatic retries a job has left. Quapp retries jobs that failed for transient reasons; you receive exactly one notification for the final outcome, not one per attempt. See Notifications.