v62

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-31136116265.6 KB
jobs

Get the result of a job execution

get/v1/projects/{projectOrProductUID}/jobs/runs/{reportUID}

Path parameters

projectOrProductUIDstring required
reportUIDstring required

Unique identifier for a job run report

Query parameters

view'summary' | 'detail'

Controls the level of detail returned: 'summary' returns metadata only, 'detail' returns the full result payload

Response

Job run details

cancelboolean

Whether cancellation was requested

completedinteger

Unix timestamp when completed

dry_runboolean required

Whether this was a dry run

job_namestring required

Name of the job

job_uidstring required

Unique identifier for the job

report_uidstring required

Unique identifier for this run

resultsobject

Full results (only in detail view)

startedinteger

Unix timestamp when started

statusstring required

Current status (submitted, running, completed, cancelled, failed)

submittedinteger required

Unix timestamp when submitted

submitted_bystring required

User who submitted the run

updatedinteger required

Unix timestamp of last update

Example response

{
  "completed": 1775252922,
  "job_name": "My Fleet Update",
  "job_uid": "6862064d-9c7a-4d5d-88e6-2dfa8b4ef6c5",
  "report_uid": "6862064d-9c7a-4d5d-88e6-2dfa8b4ef6c5-1776780688472",
  "results": {
    "devices": {
      "dev:000000000000001": {
        "status": "completed",
        "vars_set": {
          "firmware_channel": "production",
          "log_level": "1"
        }
      },
      "dev:000000000000002": {
        "status": "completed",
        "vars_set": {
          "firmware_channel": "production",
          "log_level": "1"
        }
      }
    },
    "job": {
      "dry_run": false,
      "job_name": "My Fleet Update",
      "job_uid": "6862064d-9c7a-4d5d-88e6-2dfa8b4ef6c5",
      "status": "completed successfully",
      "when_completed": 1775252922,
      "when_started": 1775252900,
      "when_submitted": 1775252900,
      "when_updated": 1775252922,
      "who_submitted": "user@example.com"
    }
  },
  "started": 1775252900,
  "status": "completed successfully",
  "submitted": 1775252900,
  "submitted_by": "user@example.com",
  "updated": 1775252922
}