Delete a specific Device

delete https://api.kolide.com/devices/{id}

Mark a device as pending deletion. Note that the deletion will not
happen immediately: the deletion can be canceled in the web
interface until the device is actually deleted. The Kolide agent
on the device will also be disabled to prevent re-enrollment.
If this device is the only registered device for a user, their
Trust-On-First-Use (TOFU) status will be reset, allowing them to
register another device without needing admin approval.

Responses

Response body

object

string

The canonical identifier for this device

name

string

The canonical human name for the device. May be edited via the web interface.

registered_at

date-time

The timestamp representing when the device was registered to its current owner

last_authenticated_at

date-time

The timestamp representing when the device last authenticated with Kolide

registered_owner_info

object

Information for fetching the complete data on the registered owner of the device

identifier

string

the canonical identifier for this object

location

url

the API URL where complete information about this object can be found

operating_system

string

The operating system installed on the device

hardware_model

string

The specific hardware model of the device

serial

string

The hardware serial of the device. May not be applicable

hardware_uuid

string

The hardware UUID/UDID for the device. May not be applicable for some devices

note

string

Notes provided by a Kolide administrator (in markdown format)

auth_state

string

The authorization status of the device, one of: 'Good', 'Notified', 'Will Block' or 'Blocked'

Will Block Blocked Notified Good

will_block_at

date-time

If the auth status is 'Will Block', this timestamp describes when the device will be blocked by a failing check

product_image_url

string

The URL of the device's product image

auth_configuration

object

Object describing the authentication configuration for the device. Will be null if the device is not registered.

device_id

string

The canonical identifier for the device

authentication_mode

string

Authentication mode describing who can authentication with this device. Must be one of: only_registered_owner, only_registered_owner_or_group_members, anyone

person_groups

array of objects

Description of the groups allowed to authenticate with this device

person_groups

object

string

The canonical identifier for this group

name

string

The human-readable name for this group

device_type

string

The platform type of the device

Mac Linux Windows iOS Android

form_factor

string

The form factor of the device

Computer Tablet Phone

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request DELETE \
2
     --url https://api.kolide.com/devices/id \
3
     --header 'accept: application/json' \
4
     --header 'x-kolide-api-version: 2023-05-26'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The deleted Device

401An 'unauthorized' response may occur for features restricted by or unavailable to your organization

403A 'forbidden' response may occur if the API key does not have necessary permissions to perform certain actions