Sign in

v62

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

Get a specific batch job definition

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

Path parameters

projectOrProductUIDstring required
jobUIDstring required

Unique identifier for a batch job

Response

Batch job details

createdinteger required

Unix timestamp when job was created

created_bystring required

User who created the job

job_uidstring required

Unique identifier for the job

last_run_completedinteger

Unix timestamp when the most recent run completed (0 if still in progress)

last_run_statusstring

Status of the most recent job run. Terminal values are: "submitted", "completed successfully", "dry run completed successfully", "completed with errors", "cancelled". While a job is running, intermediate per-device progress updates may appear (e.g. "dev:000000000000000 completed", "dev:000000000000000 updated: ...").

last_run_submittedinteger

Unix timestamp when the most recent run was submitted

namestring required

Human-readable job name

Example response

{
  "last_run_completed": 1775252922,
  "last_run_status": "dry run completed successfully",
  "last_run_submitted": 1775252900,
  "definition": {
    "comment": "Set environment variables on all devices in a fleet",
    "default_requests": {
      "vars_to_set": {
        "firmware_channel": "production",
        "log_level": "1"
      }
    },
    "select": {
      "devices_in_fleets": [
        "fleet:00000000-0000-0000-0000-000000000000"
      ]
    }
  }
}