Sign in
FOTA Job Executions

ListFOTAJobExecutionsForDevice

get/fota-job-executions/{deviceId}

Path parameters

deviceIdstring required

This is the canonical device id used in the device certificate, and as the MQTT client id.

Example:nrf-1234567890123456789000

Query parameters

pageLimitinteger

Maximum number of items you want returned in the response (<=100).

pageNextTokenstring

If available in the initial response, use this token to retrieve the next page of items in the list. When supplying as a request parameter, use URL-encoding.

Example:4bb1f9ab35bd

Response

Ok

totalinteger

Reflects the total results returned by the query, which may be less than the total number of items available. If the response contains a pageNextToken value, you can supply the pageNextToken in the next request to get more results. The maximum value of total is the page limit of the request, or ten pages if no page limit is provided.

pageNextTokenstring

Token used to retrieve the next page of items in the list. Present in a response only if the total available results exceeds the specified limit on a page. This token does not change between requests. When supplying as a request parameter, use URL-encoding.

Example response

{
  "items": [
    {
      "status": "SUCCEEDED",
      "deviceId": "nrfsim-453330795897806100000",
      "createdAt": "2020-12-09T18:34:13.472Z",
      "executionId": "4d50a3ba-9573-4ec9-b362-02e2bde5aaee",
      "jobDocument": {
        "path": "3701edba-5bd5-4fcf-a0d1-769457a8f409/APP*c52c99d3*v1.3.0-280-g485445b6a869/AT_fast_blink.bin",
        "host": "firmware.nrfcloud.com",
        "firmwareType": "APP",
        "fileSize": 253640,
        "version": "v1.3.0-280-g485445b6a869"
      },
      "jobId": "f539350f-7784-470c-b0cf-c669147b0c54",
      "lastUpdatedAt": "2020-12-09T18:34:18.731Z",
      "tenantId": "3701edba-5bd5-4fcf-a0d1-769457a8f409",
      "statusDetail": "Job Completed"
    }
  ],
  "total": 10,
  "pageNextToken": "4bb1f9ab35bd"
}

Changes