From c0e27ea115a50f5d6280a413e3b84e264da0efdf Mon Sep 17 00:00:00 2001
From: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Date: Tue, 27 Feb 2024 09:06:15 -0500
Subject: [PATCH] API docs: Add note to Get host by identifier (#17097)

- `hostname` isn't always unique
---
 docs/REST API/rest-api.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/REST API/rest-api.md b/docs/REST API/rest-api.md
index f0cf31f7d3..db0be4346d 100644
--- a/docs/REST API/rest-api.md	
+++ b/docs/REST API/rest-api.md	
@@ -2499,7 +2499,9 @@ Returns the information of the specified host.
 ### Get host by identifier
 
 Returns the information of the host specified using the `uuid`, `hardware_serial`, `osquery_host_id`, `hostname`, or
-`node_key` as an identifier
+`node_key` as an identifier.
+
+If `hostname` is specified when there is more than one host with the same hostname, the endpoint returns the first matching host.
 
 `GET /api/v1/fleet/hosts/identifier/:identifier`