[API design] Create policies automatically for Fleet-maintained apps (#…

…24413)

Related to #22077

docs/REST API/rest-api.md

@@ -9055,7 +9055,13 @@ Get a list of all software.
       "software_package": {
         "name": "FirefoxInsall.pkg",
         "version": "125.6",
-        "self_service": true
+        "self_service": true,
+        "automatic_install_policies": [
+          {
+            "id": 343,
+            "name": "[Install software] Firefox.app",
+          }
+        ],
       },
       "app_store_app": null,
       "versions_count": 3,
@@ -9306,7 +9312,7 @@ Returns information about the specified software. By default, `versions` are sor
 
 #### Example
 
-`GET /api/v1/fleet/software/titles/12`
+`GET /api/v1/fleet/software/titles/12?team_id=3`
 
 ##### Default response
 
@@ -9316,8 +9322,8 @@ Returns information about the specified software. By default, `versions` are sor
 {
   "software_title": {
     "id": 12,
-    "name": "Firefox.app",
-    "bundle_identifier": "org.mozilla.firefox",
+    "name": "Falcon.app",
+    "bundle_identifier": "crowdstrike.falcon.Agent",
     "software_package": {
       "name": "FalconSensor-6.44.pkg",
       "version": "6.44",
@@ -9329,6 +9335,12 @@ Returns information about the specified software. By default, `versions` are sor
       "post_install_script": "sudo /Applications/Falcon.app/Contents/Resources/falconctl license 0123456789ABCDEFGHIJKLMNOPQRSTUV-WX",
       "uninstall_script": "/Library/CS/falconctl uninstall",
       "self_service": true,
+      "automatic_install_policies": [
+        {
+          "id": 343,
+          "name": "[Install software] Crowdstrike Agent",
+        }
+      ],
       "status": {
         "installed": 3,
         "pending_install": 1,
@@ -9884,7 +9896,13 @@ Add Fleet-maintained app so it's available for install.
 
 ##### Default response
 
-`Status: 204`
+`Status: 200`
+
+```json
+{
+  "software_title_id": 234
+}
+```
 
 ### Download package