Skip to main content
DELETE
Cancel an in-flight command. An authenticated factory_reset may be cancelled only while it is still pending. Once delivered, the physical device may already be wiping local data, so cancellation is rejected and the reset must finish its acknowledgement close-loop.

Authentication

Requires an API key with devices:write scope.

Path Parameters

string
required
The device’s unique identifier (e.g., dev_abc123).
string
required
The command’s unique identifier (e.g., cmd_xyz789).

Response

Returns the command object with status set to cancelled.

Response Fields

Notes

  • A factory_reset can be cancelled only while pending; delivery makes it non-cancellable
  • Other command types retain the existing pending/delivered cancellation behavior
  • Commands in executed, failed, expired, or cancelled status cannot be cancelled
  • Cancellation is immediate and the command will not be delivered to the device