v62

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

List all runs for a specific job

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

Path parameters

projectOrProductUIDstring required
jobUIDstring required

Unique identifier for a batch job

Query parameters

statusstring

Filter runs by status

dry_runboolean nullable

Filter runs by dry run flag

Response

List of job runs

Example response

{
  "runs": [
    {
      "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
    }
  ]
}