API docs: Add note to Get host by identifier (#17097)

- `hostname` isn't always unique
2024-02-27 09:06:15 -05:00
parent 2d73b99bb0
commit c0e27ea115
1 changed files with 3 additions and 1 deletions
@@ -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`