diff --git a/docs/reference/replicated-cli-vm-ssh-endpoint.mdx b/docs/reference/replicated-cli-vm-ssh-endpoint.mdx
index d0a9aa8757..c764455380 100644
--- a/docs/reference/replicated-cli-vm-ssh-endpoint.mdx
+++ b/docs/reference/replicated-cli-vm-ssh-endpoint.mdx
@@ -8,15 +8,19 @@ Get the SSH endpoint and port of a VM.
 
 The output will be in the format: hostname:port
 
+You can identify the VM either by its unique ID or by its name.
+
+Note: SSH endpoints can only be retrieved from VMs in the "running" state.
+
 ```
-replicated vm ssh-endpoint VM_ID [flags]
+replicated vm ssh-endpoint VM_ID_OR_NAME [flags]
 ```
 
 ### Examples
 
 ```
 # Get SSH endpoint for a specific VM by ID
-replicated vm ssh-endpoint <id>
+replicated vm ssh-endpoint <id-or-name>
 ```
 
 ### Options