update_variable_set

Modify settings of an existing variable set in Terraform Cloud via MCP API. Customize name, description, global scope, or priority without altering unspecified attributes. Use PATCH /varsets/{varset_id}.

Instructions

Update an existing variable set.

Modifies the settings of a variable set. Only specified attributes will be updated; unspecified attributes remain unchanged.

API endpoint: PATCH /varsets/{varset_id}

Args: varset_id: The ID of the variable set (format: "varset-xxxxxxxx")

params: Variable set parameters to update (optional):
    - name: New name for the variable set
    - description: New description of the variable set
    - global: Whether this is a global variable set
    - priority: Whether this variable set takes priority over workspace variables

Returns: The updated variable set with all current settings and configuration

See: docs/tools/variables.md#update-variable-set for reference documentation

Input Schema

Name	Required	Description	Default
`params`	No
`varset_id`	Yes

Input Schema (JSON Schema)

{
  "$defs": {
    "VariableSetParams": {
      "description": "Parameters for variable set operations without routing fields.\n\nThis model provides all optional parameters for creating or updating variable\nsets, separating configuration parameters from routing information.\n\nReference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/variable-sets\n\nSee:\n    docs/models/variables.md for reference",
      "properties": {
        "description": {
          "anyOf": [
            {
              "maxLength": 512,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Description of the variable set",
          "title": "Description"
        },
        "global": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Whether this is a global variable set",
          "title": "Global"
        },
        "name": {
          "anyOf": [
            {
              "maxLength": 90,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Variable set name",
          "title": "Name"
        },
        "priority": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Whether this variable set takes priority over workspace variables",
          "title": "Priority"
        }
      },
      "title": "VariableSetParams",
      "type": "object"
    }
  },
  "properties": {
    "params": {
      "anyOf": [
        {
          "$ref": "#/$defs/VariableSetParams"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Params"
    },
    "varset_id": {
      "title": "Varset Id",
      "type": "string"
    }
  },
  "required": [
    "varset_id"
  ],
  "type": "object"
}

terraform-cloud-mcp