Get Operation Status

Retrieve the status of a previously submitted asynchronous job. For example, upsertCI a bulk upsert operation. Use this query to check the progress and completion status of the asynchronous operations.

Special Access Rules

To query an operation status, you must have the following user permissions:

  • IT Service Configuration Item Type Manager
  • IT Service Configuration Item Owner

Request

JSON example

This example shows a sample request to get the status of an asynchronous job.

query GetOperationStatus {
  getOperationStatus(id: 108) {
    id
    status
    lastModifiedOn
    totalRecordCount
    successRecordCount
    failureRecordCount
    details
  }
}

Properties

Name Type Description Required or Optional Available Version
id Integer The unique identifier of the asynchronous job. This ID is returned by mutations such as upsertCI when an asynchronous operation is initiated. Required 67.0

Response

JSON example

This example is a sample response from the getStatus query.

{
  "data": {
    "getOperationStatus": {
      "id": 108,
      "status": "Completed",
      "lastModifiedOn": "2025-11-14T10:16:05.123456Z",
      "details": "Job completed - Upsert CI - Canonical API (5 items)",
      "totalRecordCount": 5,
      "successRecordCount": 5,
      "failureRecordCount": 0
    }
  }
}

Properties

Name Type Description Available Version
id Integer The ID of the job or operation. 67.0
status String The current status of the job. 67.0
lastModifiedOn String The date and time when the job status was last updated. Valid format: YYYY-MM-DDTHH:MM:SSZ. 67.0
details String User message that provides additional context about the job status or completion. 67.0
totalRecordCount Integer The total number of records processed in the job. 67.0
successRecordCount Integer The number of records that were successfully processed. 67.0
failureRecordCount Integer The number of records that failed to process. 67.0