Skip to main content
Glama

Modify version in Software Repository package

action1_update_version
Destructive

Modify version details of a software package in the Action1 repository, including OS support, release date, and approval status.

Instructions

Modify version in Software Repository package.

Input Schema

NameRequiredDescriptionDefault
bodyNoRequest body
org_idNoOrg UUID.
confirmNoRequired to execute. Exact string "YES".
dry_runNoDefault true (preview). Set false to execute.
package_idYesProvide a specific package ID.
version_idYesProvide a specific version ID.

Output Schema

NameRequiredDescriptionDefault
OSNo
idNo
selfNo
toolNo
typeNo
notesNo
dry_runNo
versionNo
EULA_textNo
binary_idNo
file_nameNo
would_sendNo
update_typeNo
install_typeNo
release_dateNo
security_CVENo
EULA_acceptedNo
app_name_matchNo
approval_statusNo
scoped_approvalsNo
reboot_exit_codesNo
security_severityNo
additional_actionsNo
success_exit_codesNo
allow_x86_x64_on_armNo
silent_install_switchesNo
uninstall_app_name_matchNo
silent_uninstall_switchesNo
minimum_required_agent_versionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed36 schema fields changedv0.6.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • removedInput schema / properties / body / additionalProperties
      Removed value: -{}
    • addedInput schema / properties / body / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "EULA_accepted": {
      +        "enum": [
      +          "yes",
      +          "no"
      +        ],
      +        "type": "string"
      +      },
      +      "EULA_text": {
      +        "description": "The text of the EULA agreement.",
      +        "type": "string"
      +      },
      +      "OS": {
      +        "description": "The list of supported OS's.",
      +        "items": {
      +          "enum": [
      +            "Windows 11 (26H2)",
      +            "Windows 11 (26H1)",
      +            "Windows 11 (25H2)",
      +            "Windows 11 (24H2)",
      +            "Windows 11 (23H2)",
      +            "Windows 11 (22H2)",
      +            "Windows 11 (21H2)",
      +            "Windows 11",
      +            "Windows 10 (22H2)",
      +            "Windows 10 (21H2)",
      +            "Windows 10 (21H1)",
      +            "Windows 10 (20H2)",
      +            "Windows 10 (2004)",
      +            "Windows 10 (1909)",
      +            "Windows 10 (1903)",
      +            "Windows 10 (1809)",
      +            "Windows 10 (1803)",
      +            "Windows 10 (1709)",
      +            "Windows 10 (1703)",
      +            "Windows 10 (1607)",
      +            "Windows 10 (1511)",
      +            "Windows 10 (1507)",
      +            "Windows 10",
      +            "Windows 8.1",
      +            "Windows 8",
      +            "Windows 7",
      +            "Windows Vista",
      +            "Windows XP",
      +            "Windows Server 2025",
      +            "Windows Server 2022",
      +            "Windows Server 2019",
      +            "Windows Server 2016",
      +            "Windows Server 2012 R2",
      +            "Windows Server 2012",
      +            "Windows Server 2008 R2",
      +            "Windows Server 2008",
      +            "Windows Server 2003",
      +            "Windows Server"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "additional_actions": {
      +        "items": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "deploy_update",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "deploy_package",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "run_script",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "type": "array"
      +      },
      +      "allow_x86_x64_on_arm": {
      +        "description": "If 'file_name.Windows_ARM64' not provided and 'x86_arm_fallback' are set to 'yes', the...",
      +        "enum": [
      +          "no",
      +          "yes"
      +        ],
      +        "type": "string"
      +      },
      +      "app_name_match": {
      +        "description": "Regular expression to identify a specific version of already installed software.",
      +        "type": "string"
      +      },
      +      "approval_status": {
      +        "enum": [
      +          "New",
      +          "Approved",
      +          "Declined"
      +        ],
      +        "type": "string"
      +      },
      +      "file_name": {
      +        "additionalProperties": {},
      +        "description": "Methods for downloading the installation file.",
      +        "properties": {
      +          "Windows_32": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "Windows_64": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "Windows_ARM64": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "install_type": {
      +        "description": "The type of installation file",
      +        "enum": [
      +          "msi",
      +          "exe",
      +          "msix"
      +        ],
      +        "type": "string"
      +      },
      +      "minimum_required_agent_version": {
      +        "description": "Minimum required agent version",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Additional notes about version.",
      +        "type": "string"
      +      },
      +      "reboot_exit_codes": {
      +        "description": "Reboot exit code",
      +        "type": "string"
      +      },
      +      "release_date": {
      +        "description": "The date when the software version was released in format YYYY-MM-DD.",
      +        "type": "string"
      +      },
      +      "scoped_approvals": {
      +        "items": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "status": {
      +                  "enum": [
      +                    "New",
      +                    "Approved",
      +                    "Declined"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "Enterprise",
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "organization_id": {
      +                  "description": "The ID of the organization where the update holds this status.",
      +                  "type": "string"
      +                },
      +                "status": {
      +                  "enum": [
      +                    "New",
      +                    "Approved",
      +                    "Declined"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "Organization",
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "type": "array"
      +      },
      +      "security_CVE": {
      +        "description": "For Security Updates only, CVE ID, if available.",
      +        "type": "string"
      +      },
      +      "security_severity": {
      +        "description": "For Security Updates only.",
      +        "enum": [
      +          "Critical",
      +          "Important",
      +          "Moderate",
      +          "Low",
      +          "Unspecified"
      +        ],
      +        "type": "string"
      +      },
      +      "silent_install_switches": {
      +        "description": "The command line parameters that suppress all setup UI prompts to ensure the installation...",
      +        "type": "string"
      +      },
      +      "silent_uninstall_switches": {
      +        "description": "The command line parameters that suppress all setup UI prompts to ensure the...",
      +        "type": "string"
      +      },
      +      "success_exit_codes": {
      +        "description": "Exit code",
      +        "type": "string"
      +      },
      +      "uninstall_app_name_match": {
      +        "description": "Regular expression to identify all possible versions of the same software, including...",
      +        "type": "string"
      +      },
      +      "update_type": {
      +        "description": "The update type field will be used by the update automation to determine which updates to...",
      +        "enum": [
      +          "Regular Updates",
      +          "Critical - Non-Security",
      +          "Definition Updates",
      +          "Feature Updates",
      +          "Security Updates",
      +          "Service Packs",
      +          "Tools",
      +          "Update Rollups",
      +          "Drivers",
      +          "Upgrades",
      +          "Unknown"
      +        ],
      +        "type": "string"
      +      },
      +      "version": {
      +        "description": "Specify the exact version number as shown in Apps & Features when installed.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "EULA_accepted": {
      +        "enum": [
      +          "yes",
      +          "no"
      +        ],
      +        "type": "string"
      +      },
      +      "EULA_text": {
      +        "description": "The text of the EULA agreement.",
      +        "type": "string"
      +      },
      +      "OS": {
      +        "description": "The list of supported OS's.",
      +        "items": {
      +          "enum": [
      +            "macOS Golden Gate",
      +            "macOS Tahoe",
      +            "macOS Sequoia",
      +            "macOS Sonoma",
      +            "macOS Ventura",
      +            "macOS Monterey",
      +            "macOS"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "additional_actions": {
      +        "items": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "deploy_update",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "deploy_package",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "params": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "priority": {
      +                  "description": "The priority of the action.",
      +                  "type": "string"
      +                },
      +                "template_id": {
      +                  "const": "run_script",
      +                  "type": "string"
      +                },
      +                "when": {
      +                  "description": "The action will be triggered - before_install|after_install|before_uninstall|after_unin...",
      +                  "enum": [
      +                    "before_install",
      +                    "after_install",
      +                    "before_uninstall",
      +                    "after_uninstall",
      +                    "disable_updates"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "priority",
      +                "when",
      +                "template_id",
      +                "name",
      +                "params"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "type": "array"
      +      },
      +      "app_name_match": {
      +        "description": "Regular expression to identify a specific version of already installed software.",
      +        "type": "string"
      +      },
      +      "approval_status": {
      +        "enum": [
      +          "New",
      +          "Approved",
      +          "Declined"
      +        ],
      +        "type": "string"
      +      },
      +      "file_name": {
      +        "additionalProperties": {},
      +        "description": "Methods for downloading the installation file.",
      +        "properties": {
      +          "Mac_AppleSilicon": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "Mac_IntelCPU": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "minimum_required_agent_version": {
      +        "description": "Minimum required agent version",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Additional notes about version.",
      +        "type": "string"
      +      },
      +      "release_date": {
      +        "description": "The date when the software version was released in format YYYY-MM-DD.",
      +        "type": "string"
      +      },
      +      "scoped_approvals": {
      +        "items": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "status": {
      +                  "enum": [
      +                    "New",
      +                    "Approved",
      +                    "Declined"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "Enterprise",
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "organization_id": {
      +                  "description": "The ID of the organization where the update holds this status.",
      +                  "type": "string"
      +                },
      +                "status": {
      +                  "enum": [
      +                    "New",
      +                    "Approved",
      +                    "Declined"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "Organization",
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "type": "array"
      +      },
      +      "security_CVE": {
      +        "description": "For Security Updates only, CVE ID, if available.",
      +        "type": "string"
      +      },
      +      "security_severity": {
      +        "description": "For Security Updates only.",
      +        "enum": [
      +          "Critical",
      +          "Important",
      +          "Moderate",
      +          "Low",
      +          "Unspecified"
      +        ],
      +        "type": "string"
      +      },
      +      "silent_install_switches": {
      +        "description": "The command line parameters that suppress all setup UI prompts to ensure the installation...",
      +        "type": "string"
      +      },
      +      "success_exit_codes": {
      +        "description": "Exit code",
      +        "type": "string"
      +      },
      +      "update_type": {
      +        "description": "The update type field will be used by the update automation to determine which updates to...",
      +        "enum": [
      +          "Regular Updates",
      +          "Critical - Non-Security",
      +          "Definition Updates",
      +          "Feature Updates",
      +          "Security Updates",
      +          "Service Packs",
      +          "Tools",
      +          "Update Rollups",
      +          "Drivers",
      +          "Upgrades",
      +          "Unknown"
      +        ],
      +        "type": "string"
      +      },
      +      "version": {
      +        "description": "Specify the exact version number as shown in Apps & Features when installed.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / description
      Previous value: -"Request body (schema: object)"New value: +"Request body"
    • removedInput schema / properties / body / type
      Removed value: -"object"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +{}
    • addedOutput schema / properties / EULA_accepted
      Added value: +{}
    • addedOutput schema / properties / EULA_text
      Added value: +{}
    • addedOutput schema / properties / OS
      Added value: +{}
    • addedOutput schema / properties / additional_actions
      Added value: +{}
    • addedOutput schema / properties / allow_x86_x64_on_arm
      Added value: +{}
    • addedOutput schema / properties / app_name_match
      Added value: +{}
    • addedOutput schema / properties / approval_status
      Added value: +{}
    • addedOutput schema / properties / binary_id
      Added value: +{}
    • addedOutput schema / properties / dry_run
      Added value: +{}
    • addedOutput schema / properties / file_name
      Added value: +{}
    • addedOutput schema / properties / id
      Added value: +{}
    • addedOutput schema / properties / install_type
      Added value: +{}
    • addedOutput schema / properties / minimum_required_agent_version
      Added value: +{}
    • addedOutput schema / properties / notes
      Added value: +{}
    • addedOutput schema / properties / reboot_exit_codes
      Added value: +{}
    • addedOutput schema / properties / release_date
      Added value: +{}
    • addedOutput schema / properties / scoped_approvals
      Added value: +{}
    • addedOutput schema / properties / security_CVE
      Added value: +{}
    • addedOutput schema / properties / security_severity
      Added value: +{}
    • addedOutput schema / properties / self
      Added value: +{}
    • addedOutput schema / properties / silent_install_switches
      Added value: +{}
    • addedOutput schema / properties / silent_uninstall_switches
      Added value: +{}
    • addedOutput schema / properties / success_exit_codes
      Added value: +{}
    • addedOutput schema / properties / tool
      Added value: +{}
    • addedOutput schema / properties / type
      Added value: +{}
    • addedOutput schema / properties / uninstall_app_name_match
      Added value: +{}
    • addedOutput schema / properties / update_type
      Added value: +{}
    • addedOutput schema / properties / version
      Added value: +{}
    • addedOutput schema / properties / would_send
      Added value: +{}
  2. First observedv0.5.0

TDQS

C2.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already disclose that this is destructive, non-idempotent, and open-world, which lowers the disclosure bar. However, the description adds no behavioral context beyond the title, such as what fields are modified, whether changes are reversible, or how the destructive operation is gated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single short sentence with no wasted words, but it is effectively a title repetition rather than a front-loaded, informative statement. Conciseness is achieved at the cost of under-specification.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a destructive mutation tool with a complex body schema and no explanatory context in the description. While annotations cover safety hints and the output schema covers return values, the description gives an agent no understanding of the operation's scope or effects.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters including body fields, dry_run, and confirm. The description adds no parameter semantics, which is acceptable given the high schema coverage but provides no extra value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description restates the title almost verbatim: 'Modify version in Software Repository package.' It names a verb and resource, but provides no distinguishing detail versus siblings such as action1_update_package, action1_create_package_version, or action1_get_version.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives, no prerequisites, and no mention of the confirm/dry_run workflow. An agent must infer usage entirely from the schema and sibling names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools