Remove host (device) from Fleet

Removes a single host (device) from FleetDM by host ID. Only organization owners can perform this action. Validates that the organization exists and the member exists within the organization. Supports both API key authentication (X-API-Key header) and session authentication (cookies + X-Organization-Id header).

DELETE /v1/people/{id}/host/{hostId}

Remove host (device) from Fleet

cURL

curl --request DELETE \
  --url http://localhost:3333/v1/people/{id}/host/{hostId} \
  --header 'X-API-Key: <api-key>'

200

{
  "success": true
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Headers

X-Organization-Id · string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

id · string · required

Member ID

Example:

"mem_abc123def456"

hostId · number · required

FleetDM host ID

Example:

1

Response

200

application/json

Host removed from Fleet successfully

success · boolean

Indicates successful removal

Example:

true

authType · enum<string>

How the request was authenticated

Available options: api-key, session