update_project

update_project

Modify Terraform Cloud project settings with the specified attributes such as name, description, auto-destroy duration, or tags. Only specified fields are updated; others remain unchanged.

Instructions

Update an existing project.

Modifies the settings of a Terraform Cloud project. This can be used to change attributes like name, description, auto-destroy duration, or tags. Only specified attributes will be updated; unspecified attributes remain unchanged.

API endpoint: PATCH /projects/{project_id}

Args: project_id: The ID of the project to update (format: "prj-xxxxxxxx") params: Project parameters to update (optional): - name: New name for the project - description: Human-readable description of the project - auto_destroy_activity_duration: How long each workspace should wait before auto-destroying (e.g., '14d', '24h') - tag_bindings: List of tag key-value pairs to bind to the project

Returns: The updated project with all current settings and configuration

See: docs/tools/project.md for reference documentation

Input Schema

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

Input Schema (JSON Schema)

{
  "$defs": {
    "ProjectParams": {
      "description": "Parameters for project operations without routing fields.\n\nThis model provides all optional parameters for creating or updating projects,\nreusing field definitions from BaseProjectRequest. It separates configuration\nparameters from routing information like organization and project ID.\n\nReference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/projects\n\nNote:\n    When updating a project, use this model to specify only the attributes\n    you want to change. Unspecified attributes retain their current values.\n    All fields are inherited from BaseProjectRequest.\n\nSee:\n    docs/models/project.md for reference",
      "properties": {
        "auto-destroy-activity-duration": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "How long each workspace should wait before auto-destroying (e.g., '14d', '24h')",
          "title": "Auto-Destroy-Activity-Duration"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Description of the project",
          "title": "Description"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Name of the project",
          "title": "Name"
        },
        "tag-bindings": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/TagBinding"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Tags to bind to the project, inherited by workspaces",
          "title": "Tag-Bindings"
        }
      },
      "title": "ProjectParams",
      "type": "object"
    },
    "TagBinding": {
      "description": "Tag binding configuration for a project.\n\nDefines a tag key-value pair that can be bound to a project\nand inherited by its workspaces.\n\nReference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/projects\n\nSee:\n    docs/models/project.md for reference",
      "properties": {
        "key": {
          "description": "The key of the tag",
          "title": "Key",
          "type": "string"
        },
        "value": {
          "description": "The value of the tag",
          "title": "Value",
          "type": "string"
        }
      },
      "required": [
        "key",
        "value"
      ],
      "title": "TagBinding",
      "type": "object"
    }
  },
  "properties": {
    "params": {
      "anyOf": [
        {
          "$ref": "#/$defs/ProjectParams"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Params"
    },
    "project_id": {
      "title": "Project Id",
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "type": "object"
}

terraform-cloud-mcp

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools

MCP directory API