list_commands_resp_object

{
  "executions": [
    {
        "id": "7ba65010-f64e-4ba8-bfe4-963dd0c67009",
        "device_id": "fecbbba0-79f2-4e9e-a6f0-69a310ab110b",
        "state": "SUCCESS",
        "ephemeral": false,
        "created_at": "2025-07-11T00:00:01Z",
        "request": {
            "name": "change_color_temperature",
            "arguments": {
                "temp_kelvins": 1850
            },
            "manifest_name": "change_lux"
        },
        "response": {
            "state": "SUCCEEDED",
            "received_at": "2025-07-11T00:00:02Z"
        }
    },
    {
        "id": "d8fbb364-bae2-4d29-b76e-23e23a321448",
        "device_id": "fecbbba0-79f2-4e9e-a6f0-69a310ab110b",
        "state": "ERROR",
        "ephemeral": true,
        "created_at": "2025-09-11T00:00:00Z",
        "request": {
            "name": "change_color_temperature",
            "arguments": {
                "temp_kelvins": 15000
            },
            "manifest_name": "change_lux"
        },
        "response": {
          "state": "ERROR",
          "received_at": "2025-09-11T00:00:01Z"
        }
    }
  ],
  "total_count": 2
}

total_countinteger

The total number of device command executions.

executionsarray of objects

A list of command executions of a specified device. If query parameters limit and/or offset are present:

• the length of the list is less or equal to limit;
• offset executions will be skipped before returning results. If offset is greater than total_count, an empty list is returned.

CommandExecutionobject

Object containing command execution information.

CommandExecution.idstring

Command execution ID.

CommandExecution.device_idstring

Device ID.

CommandExecution.statestring

Command execution state. Possible values:

• NEW — execution is created but not yet started.
• IN_PROGRESS — execution is in progress.
• SUCCESS — execution completed successfully.
• ERROR — execution completed with an error.
• TIMEOUT — execution timed out.
• UNSYNC — execution is not completely synchronized from the gateway.

CommandExecution.created_atstring

The datetime when the execution was created, in RFC 3339 format.

CommandExecution.requestobject

CommandRequest object contains execution request information.

CommandRequest.namestring

A command name as it is or an alias.

CommandRequest.argumentsobject

The command arguments are specified in the device blueprint manifest.

This is an object whose keys are the names of the arguments and whose values are the corresponding argument values.

CommandRequest.manifest_namestring

A command name specified in the device manifest.

CommandExecution.responseobject

CommandResponse object with response information.

CommandResponse.statestring

Command response state. Possible values:

• STARTED
• IN_PROGRESS
• SUCCEEDED
• ERROR

CommandResponse.payloadobject

The payload depends on the response state.

CommandResponse.received_atstring

The datetime when the response was received, in RFC 3339 format.

execution.logarray of objects

The log contains a list of CommandResponse objects.

CommandResponse.statestring

Command response state. Possible values:

• STARTED
• IN_PROGRESS
• SUCCEEDED
• ERROR

CommandResponse.payloadobject

The payload depends on the response state.

CommandResponse.received_atstring

The datetime when the response was received, in RFC 3339 format.

CommandExecution.ephemeralboolean

Shows whether the command has a limited TTL (time-to-live).