diff --git a/docs/Configuration/yaml-files.md b/docs/Configuration/yaml-files.md
index 26e73422b050..262abc6c5876 100644
--- a/docs/Configuration/yaml-files.md
+++ b/docs/Configuration/yaml-files.md
@@ -320,6 +320,7 @@ software:
 ### packages
 
 - `url` specifies the URL at which the software is located. Fleet will download the software and upload it to S3 (default: `""`).
+- `version` specifies the version of the software (optional).
 - `install_script.path` specifies the command Fleet will run on hosts to install software. The [default script](https://github.com/fleetdm/fleet/tree/main/pkg/file/scripts) is dependent on the software type (i.e. .pkg).
 - `pre_install_query.path` is the osquery query Fleet runs before installing the software. Software will be installed only if the [query returns results](https://fleetdm.com/tables) (default: `""`).
 - `post_install_script.path` is the script Fleet will run on hosts after installing software (default: `""`).
@@ -331,6 +332,7 @@ software:
 
 ```yaml
 url: https://dl.tailscale.com/stable/tailscale-setup-1.72.0.exe
+version: 1.72.0
 install_script:
   path: ../lib/software/tailscale-install-script.ps1
 self_service: true
diff --git a/docs/REST API/rest-api.md b/docs/REST API/rest-api.md
index 454a27db5570..950ece1ae35b 100644
--- a/docs/REST API/rest-api.md	
+++ b/docs/REST API/rest-api.md	
@@ -9624,8 +9624,9 @@ Returns information about the specified Fleet-maintained app.
 {
   "fleet_maintained_app": {
     "id": 1,
+    "url": "https://downloads.1password.com/mac/1Password-8.10.50-aarch64.zip",
     "name": "1Password",
-    "filename": "1Password-8.10.44-aarch64.zip",
+    "filename": "1Password-8.10.50-aarch64.zip",
     "version": "8.10.40",
     "platform": "darwin",
     "install_script": "#!/bin/sh\ninstaller -pkg \"$INSTALLER_PATH\" -target /",