v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
commands_Command Status

Get a command status

Retrieves a single command status record by its ID.

Returns the full CommandStatus object for one device's execution of one command, including its current state, the associated device and request IDs, and the reason for its current state.

About Get Command Status This is the most granular status check available for a command's execution on a specific device. Use it once you already have a command status id, typically obtained by filtering GET /commands/v0/status/ down to the record you care about.

Common Use Cases

Checking the current state and reason for one device's execution of a command

Confirming a command has reached a terminal state before considering it complete

Best Practices

Use the reason field to understand why a command failed rather than only checking state

Cache this result briefly rather than polling continuously if the state is already terminal

Workflow

Filter GET /commands/v0/status/ by device or request to find the specific command status id

Call this endpoint with that id for the full record

get/commands/v0/status/{id}/

Path parameters

idstring required

ID of the command status object

Response

Command status information

codeinteger
messagestring