create_variable_set

Create and manage variable sets in Terraform Cloud organizations to centralize configuration across workspaces and projects. Define global settings, priorities, and descriptions for efficient variable management.

Instructions

Create a new variable set in an organization.

Creates a new variable set which can be used to manage variables across multiple workspaces and projects.

API endpoint: POST /organizations/{organization}/varsets

Args: organization: The name of the organization name: The name to give the variable set

params: Additional variable set parameters (optional):
    - description: 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 created variable set with its configuration and metadata

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

Input Schema

Name	Required	Description	Default
`name`	Yes
`organization`	Yes
`params`	No

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": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "organization": {
      "title": "Organization",
      "type": "string"
    },
    "params": {
      "anyOf": [
        {
          "$ref": "#/$defs/VariableSetParams"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Params"
    }
  },
  "required": [
    "organization",
    "name"
  ],
  "type": "object"
}

terraform-cloud-mcp