coder
diff --git a/‎coderd/apidoc/docs.go
+1-1 b/‎coderd/apidoc/docs.go
+1-1
diff --git a/‎coderd/apidoc/swagger.json
+1-1 b/‎coderd/apidoc/swagger.json
+1-1
diff --git a/‎coderd/files.go
+1-1 b/‎coderd/files.go
+1-1
diff --git a/‎docs/api/files.md
+5-5 b/‎docs/api/files.md
+5-5
@@ -38,7 +38,7 @@ const (
 // @Accept application/x-tar
 // @Tags Files
 // @Param Content-Type header string true "Content-Type must be `application/x-tar` or `application/zip`" default(application/x-tar)
-// @Param file formData file true "File to be uploaded"
+// @Param file formData file true "File to be uploaded. If using tar format, file must conform to ustar (pax may cause problems)."
 // @Success 201 {object} codersdk.UploadResponse
 // @Router /files [post]
 func (api *API) postFile(rw http.ResponseWriter, r *http.Request) {