delete_workspace

Permanently delete a Terraform Cloud workspace and all associated resources, including state versions, run history, and configurations. Use with caution as this action is irreversible and destructive. Ideal for cleanup operations after confirming resources are no longer needed.

Instructions

Delete a workspace.

Permanently deletes a Terraform Cloud workspace and all its resources including
state versions, run history, and configuration versions. This action cannot be undone.

WARNING: This is a destructive operation. For workspaces that have active resources,
consider running a destroy plan first or use safe_delete_workspace instead.

API endpoint: DELETE /organizations/{organization}/workspaces/{workspace_name}

Args:
    organization: The name of the organization that owns the workspace
    workspace_name: The name of the workspace to delete

Returns:
    Success message with no content (HTTP 204) if successful
    Error response with explanation if the workspace cannot be deleted

See:
    docs/tools/workspace_tools.md for usage examples

Input Schema

Name	Required	Description	Default
`organization`	Yes
`workspace_name`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "organization": {
      "title": "Organization",
      "type": "string"
    },
    "workspace_name": {
      "title": "Workspace Name",
      "type": "string"
    }
  },
  "required": [
    "organization",
    "workspace_name"
  ],
  "title": "delete_workspaceArguments",
  "type": "object"
}

terraform-cloud-mcp

delete_workspace

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools