diff --git a/.changelog/11818.txt b/.changelog/11818.txt new file mode 100644 index 000000000..728e7360f --- /dev/null +++ b/.changelog/11818.txt @@ -0,0 +1,3 @@ +```release-note:improvement +http: when a URL path is not found, include a message with the 404 status code to help the user understand why (e.g., HTTP API endpoint path not prefixed with /v1/) +``` \ No newline at end of file diff --git a/agent/http.go b/agent/http.go index a1d8461d0..e1f6e475b 100644 --- a/agent/http.go +++ b/agent/http.go @@ -587,6 +587,12 @@ func (s *HTTPHandlers) Index(resp http.ResponseWriter, req *http.Request) { // Check if this is a non-index path if req.URL.Path != "/" { resp.WriteHeader(http.StatusNotFound) + + if strings.Contains(req.URL.Path, "/v1/") { + fmt.Fprintln(resp, "Invalid URL path: not a recognized HTTP API endpoint") + } else { + fmt.Fprintln(resp, "Invalid URL path: if attempting to use the HTTP API, ensure the path starts with '/v1/'") + } return }