Skip to navigation
Fleets APIDevices

Delete Device

Delete a device. If the device does not exist, this API will return a 204. To learn more about devices, read Device Concept.

RBAC Capability Required: fleet.device.delete

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired
namestringRequired

Query parameters

$forcebooleanOptional
Force the delete of this device
$reasonstringOptional

Must be set to one of Failed|Maintenance|Storage|Other - if 'Other', the additional 'notes' query parameter is required with a brief description of the reason

$notesstringOptional

Other reason description - minimum 5 characters, maximum 255 characters

Response

Device deleted.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error