Skip to main content

Get all configuration jobs

GET 
/v2/configuration-jobs

Get all configuration jobs

Overview​

The Get all configuration jobs endpoint retrieves a paginated list of all configuration jobs in your project. Configuration jobs are background processes that handle various setup and management tasks within your projects.

Description​

This endpoint returns a comprehensive list of configuration jobs with their current status, creation time, and associated metadata. You can use this endpoint to:

  • Monitor the progress of ongoing configuration tasks
  • Retrieve historical records of completed jobs
  • Debug failed configuration processes
  • Track job execution times and performance metrics

Configuration jobs are essential for understanding what background processes are running or have completed. Each job provides detailed information about its current status, progress percentage, and any relevant metadata or error details.

Example response:

{
    "totalPages": 1,
    "totalElements": 2,
    "number": 0,
    "size": 2,
    "numberOfElements": 2,
    "content": [
        {
            "id": "9e25e95c-b22a-4272-b22a-aa74ab398f83",
            "name": "Configure Wi-Fi for TU700 - MySSID",
            "description": "Configure all TU700s on the account to connect to MySSID",
            "deviceIds": [
                "fe3ba927-4272-495d-9442-178626192af5"
            ],
            "desiredStateOnEnter": {
                "desired": {
                    "wifi": {
                        "profiles": [
                            {
                                "securityType": "WPA2_PSK",
                                "ssid": "MySSID1",
                                "hiddenSsid": "false"
                            },
                            {
                                "securityType": "AUTOMATIC",
                                "ssid": "MySSID"
                            }
                        ]
                    }
                }
            },
            "createdAt": "2026-01-22T12:57:24.698697Z"
        },
        {
            "id": "9e25e95c-4272-4bea-b22a-acb282800f3c",
            "name": "Update Operating Mode to Stock on 1 devices",
            "description": "",
            "deviceIds": [
                "5dc412f0-4272-b22a-8b9e-a271c35c308c"
            ],
            "desiredStateOnEnter": {
                "desired": {
                    "operatingMode": {
                        "mode": "stock"
                    }
                }
            },
            "createdAt": "2026-01-22T07:41:50.406126Z"
        }    
}

Request​

Responses​

All configuration jobs