action lgtm_get_query_job {
  label: "Get the status of a query job"
  description: "Get the status of a query job using the query job identifier for the task.\n\nWhen you create a query job, the response includes a task result URL of the form: `/queryjobs/{queryjob-id}`.\n"
  provider: lgtm
  method: GET
  path: "/queryjobs/{queryjob-id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      "queryjob-id": {
        type: "string"
      }
    }
    required: ["queryjob-id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      id: {
        type: "string"
        description: "The identifier for the QueryJob."
      }
      "result-url": {
        type: "string"
        description: "URL to view the result of the query job."
      }
      stats: {
        type: "object"
        properties: {
          failed: {
            type: "integer"
            format: "int32"
            description: "The number of projects for which the query failed."
          }
          pending: {
            type: "integer"
            format: "int32"
            description: "The number of projects scheduled for execution but pending. For very large jobs, not all projects are scheduled at the same time. Therefore, this number might increase as more projects are scheduled. This means that `successful + failed + pending` might be smaller than the total number of project that will be analyzed.\n"
          }
          "success-with-result": {
            type: "integer"
            format: "int32"
            description: "The number of projects for which the query returned results."
          }
          "success-without-result": {
            type: "integer"
            format: "int32"
            description: "The number of projects for which the query was successful but returned no results."
          }
          successful: {
            type: "integer"
            format: "int32"
            description: "The number of projects for which the query completed succesfully. These are broken down further between the ones that have results (`success-with-result`) and the ones that do not (`success-without-result`): `successful = success-with-result + success-without-result`.\n"
          }
        }
      }
    }
  }
}