infrawrench-sdk 1.60.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 556a352a9021aed9e685ed978754c3ff101ae2e612d0078d89dd739caec08a1a
-  data.tar.gz: 3fcaae344285b5a84663210dbae2029c0b6eaa6e7b4e4affd465ff603311da51
+  metadata.gz: b6d3f0257a114595211cf176906366997598e9d06c8b54ce6de7aa6d408ab0a4
+  data.tar.gz: c2a2ed23d72b11ca28681aa3c5c339a47a3bcef33db48b97e141c3391fd25dae
 SHA512:
-  metadata.gz: f95293d9e2352821f5c9d351e47972e2356c81226870e4a6de503f4dbf654fff4fb68a4f05b3576ef8e0e7cc5037a93be7b3f6dcfe5cfe4f739f789ad5aadf47
-  data.tar.gz: 5e4cb57cdc55f36ff778c7f338e47ad85f70bcba11d8617ecf5768e8f2983a82b0d0fb7f511707706dedc38d8fc40caca954ed51ac5a14fe28448bd789e3497e
+  metadata.gz: 5e91dcefd0cbf55894b809029a87ef3899328521a8978171d34256828c8d7e478a10fd6c48222a21eee4ab9fe08ba9488340d54d72546026d93bbc0597a2d3e2
+  data.tar.gz: 75475f3d824638ebdedf7efd4cb9869b28928afa81b8c8986192fd37e009838fcb17c785067abf94d561fbcaa49a91c4de8b506035c6442c40ef04406ac5e85d

data/README.md

@@ -1,6 +1,6 @@
 # infrawrench-sdk
 
-Generated Ruby client for the Infrawrench API (API version `1.60.0`).
+Generated Ruby client for the Infrawrench API (API version `1.62.0`).
 
 **Do not edit this gem by hand** — it is regenerated from `openapi.json` and is
 not checked into the repository. Run
@@ -41,7 +41,7 @@ Every method takes an optional trailing `request_options:` hash (`:headers`,
 Responses are the plain `Hash`/`Array` that `JSON.parse` returns, with String
 keys spelled exactly as the wire spells them. There are no model classes — see
 [`sig/infrawrench/sdk.rbs`](./sig/infrawrench/sdk.rbs) for the shape of every one of the
-858 schemas, as RBS type aliases that steep and TypeProf can read.
+868 schemas, as RBS type aliases that steep and TypeProf can read.
 
 Non-2xx responses raise `Infrawrench::ApiError`, which carries `#status`,
 the parsed `#body`, and the machine-readable `#code` when the API sends one —

data/infrawrench-sdk.gemspec

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -17,8 +17,8 @@ require_relative "lib/infrawrench/version"
 Gem::Specification.new do |spec|
   spec.name = "infrawrench-sdk"
   spec.version = Infrawrench::VERSION
-  spec.summary = "Generated Ruby client for the Infrawrench API (v1.60.0)."
-  spec.description = "Generated Ruby client for the Infrawrench API (v1.60.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
+  spec.summary = "Generated Ruby client for the Infrawrench API (v1.62.0)."
+  spec.description = "Generated Ruby client for the Infrawrench API (v1.62.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
   spec.authors = ["Infrawrench LLC", "Astrid Gealer"]
   spec.email = ["astrid@infrawrench.com"]
   spec.homepage = "https://infrawrench.com/docs/team-and-billing/client-sdks"

data/lib/infrawrench/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -7128,12 +7128,15 @@ module Infrawrench
     # List distinct values for a cost dimension
     #
     # Feeds the filter and group-by pickers. Pass dimension=tag-keys for tag
-    # keys, or dimension=usage-units for the usage units providers report (a
-    # usage budget's unit); dimension=tag requires tagKey. `charge_type` answers
-    # from the fixed set of charge types rather than from the stored data, so
-    # the picker is populated before any provider has reported one.
-    # `usage-units` lists the usage units present in the cost data, most common
-    # first, for the `usage` measure's unit picker.
+    # keys, which follow the org's tag key settings (preferred keys first and
+    # flagged, hidden keys omitted unless includeHidden=true),
+    # dimension=virtual-tag-keys for the organization's virtual tag keys
+    # (labelled by name), or dimension=usage-units for the usage units providers
+    # report (a usage budget's unit); dimension=tag and dimension=virtual_tag
+    # require tagKey. `charge_type` answers from the fixed set of charge types
+    # rather than from the stored data, so the picker is populated before any
+    # provider has reported one. `usage-units` lists the usage units present in
+    # the cost data, most common first, for the `usage` measure's unit picker.
     #
     # _Requires permission: `costs:read`._
     #
@@ -7145,16 +7148,18 @@ module Infrawrench
     #   constructed with.
     # @param dimension [String]
     # @param tag_key [String, nil]
+    # @param include_hidden [String, nil] dimension=tag-keys only: also list keys the org hides,
+    #   flagged `hidden`.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
     # @return [Hash] Parsed JSON, shaped as `CostDimensionValues` — see
     #   `sig/infrawrench/sdk.rbs`.
     # @raise [Infrawrench::ApiError] On any non-2xx response.
-    def dimensions(dimension:, org_id: nil, tag_key: nil, request_options: nil)
+    def dimensions(dimension:, org_id: nil, tag_key: nil, include_hidden: nil, request_options: nil)
       @transport.request(
         http_method: "GET",
         path: "/api/org/{orgId}/costs/dimensions",
         path_params: { "orgId" => org_id },
-        query: { "dimension" => dimension, "tagKey" => tag_key },
+        query: { "dimension" => dimension, "tagKey" => tag_key, "includeHidden" => include_hidden },
         request_options: request_options
       )
     end
@@ -18486,6 +18491,103 @@ module Infrawrench
     end
   end
 
+  # `client.tag_keys.settings`
+  class TagKeysSettingsNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # The org's hidden and preferred tag keys
+    #
+    # _Requires permission: `resources:read`._
+    #
+    # GET /api/org/{orgId}/tag-keys/settings
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `TagKeySettings` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/tag-keys/settings",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
+
+    # Replace the org's hidden and preferred tag keys
+    #
+    # Applied to every tag-key listing the API serves (`GET
+    # /costs/dimensions?dimension=tag-keys`, the metric alert selector options,
+    # the MCP tools): preferred keys first, hidden keys omitted. A display
+    # preference only; no stored data changes.
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # PUT /api/org/{orgId}/tag-keys/settings
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `TagKeySettings`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `TagKeySettings` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def update(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "PUT",
+        path: "/api/org/{orgId}/tag-keys/settings",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
+  # `client.tag_keys`
+  class TagKeysNamespace
+    # @return [TagKeysSettingsNamespace] `client.tag_keys.settings`
+    attr_reader :settings
+
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+      @settings = TagKeysSettingsNamespace.new(@transport)
+    end
+
+    # Discovered tag keys with usage
+    #
+    # Every tag key the org's cost data (trailing 90 days) and resource
+    # inventory carry, with the providers using it, row and resource counts, and
+    # whether the tag key settings hide or pin it. Preferred keys first, then by
+    # usage. Cost counts are included only when the caller also holds
+    # `costs:read`.
+    #
+    # _Requires permission: `resources:read`._
+    #
+    # GET /api/org/{orgId}/tag-keys
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `DiscoveredTagKeys` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/tag-keys",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.tag_policy`
   class TagPolicyNamespace
     # @api private
@@ -18891,6 +18993,208 @@ module Infrawrench
     end
   end
 
+  # `client.virtual_tags`
+  class VirtualTagsNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Create a virtual tag
+    #
+    # Queues the background evaluation over stored history at once.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/virtual-tags
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: Conflict
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `VirtualTagInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `VirtualTag` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def create(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/virtual-tags",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Delete a virtual tag
+    #
+    # Refused with a 409 that names every saved filter, budget, report,
+    # dashboard card, change alert, allocation rule, cost export or business
+    # metric still referencing the key: deleting it would make those fail rather
+    # than quietly widen to all spend.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # DELETE /api/org/{orgId}/virtual-tags/{id}
+    #
+    # Raises on 404: Not found
+    #
+    # Raises on 409: Conflict
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `Ok` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def delete(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "DELETE",
+        path: "/api/org/{orgId}/virtual-tags/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # Get a virtual tag
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/virtual-tags/{id}
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `VirtualTag` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/virtual-tags/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # List virtual tags
+    #
+    # Virtual tags are tags the organisation computes from its own ordered
+    # rules: merge `env`/`Environment`/`ENV` into one key, assign values by any
+    # cost filter, split shared spend by percentage or by a business metric,
+    # with optional start and end dates per rule. They work as the `virtual_tag`
+    # cost dimension everywhere a tag does.
+    #
+    # **They are computed at query time and never written into stored cost
+    # data**, and splits are weighted so a total never changes.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/virtual-tags
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<Hash>] Parsed JSON, shaped as `Array<VirtualTag>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def list(org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/virtual-tags",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
+
+    # Preview an unsaved virtual tag
+    #
+    # Evaluates a definition over the trailing 30 days without storing it: spend
+    # per rule, unmatched spend and the top values. Validates exactly as a save
+    # would.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # POST /api/org/{orgId}/virtual-tags/preview
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `VirtualTagInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `VirtualTagStats & Hash` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def preview(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/virtual-tags/preview",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Re-run a virtual tag's evaluation
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/virtual-tags/{id}/reprocess
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `VirtualTag` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def reprocess(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/virtual-tags/{id}/reprocess",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # Update a virtual tag
+    #
+    # A full replace, rule order included. The key cannot change (400). Saving
+    # re-queues the background evaluation.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # PUT /api/org/{orgId}/virtual-tags/{id}
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String]
+    # @param body [Hash] Request body, shaped as `VirtualTagInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `VirtualTag` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def update(id:, body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "PUT",
+        path: "/api/org/{orgId}/virtual-tags/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.wallboard`
   class WallboardNamespace
     # @api private
@@ -19598,10 +19902,14 @@ module Infrawrench
     attr_reader :status_pages
     # @return [StorageNamespace] `client.storage`
     attr_reader :storage
+    # @return [TagKeysNamespace] `client.tag_keys`
+    attr_reader :tag_keys
     # @return [TagPolicyNamespace] `client.tag_policy`
     attr_reader :tag_policy
     # @return [TeamNamespace] `client.team`
     attr_reader :team
+    # @return [VirtualTagsNamespace] `client.virtual_tags`
+    attr_reader :virtual_tags
     # @return [WallboardNamespace] `client.wallboard`
     attr_reader :wallboard
     # @return [WorkflowApprovalsNamespace] `client.workflow_approvals`
@@ -19716,8 +20024,10 @@ module Infrawrench
       @status_incidents = StatusIncidentsNamespace.new(@transport)
       @status_pages = StatusPagesNamespace.new(@transport)
       @storage = StorageNamespace.new(@transport)
+      @tag_keys = TagKeysNamespace.new(@transport)
       @tag_policy = TagPolicyNamespace.new(@transport)
       @team = TeamNamespace.new(@transport)
+      @virtual_tags = VirtualTagsNamespace.new(@transport)
       @wallboard = WallboardNamespace.new(@transport)
       @workflow_approvals = WorkflowApprovalsNamespace.new(@transport)
       @workflow_secrets = WorkflowSecretsNamespace.new(@transport)

data/lib/infrawrench/sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/transport.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -15,5 +15,5 @@
 # Kept in its own file so the gemspec can read the version without loading the
 # client — a gemspec that pulls in net/http is a gemspec that can fail to parse.
 module Infrawrench
-  VERSION = "1.60.0"
+  VERSION = "1.62.0"
 end

data/lib/infrawrench-sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/sig/infrawrench/sdk.rbs

@@ -1,7 +1,7 @@
-# infrawrench-sdk v1.60.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.62.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.60.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.62.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -676,7 +676,9 @@ module Infrawrench
     ?"tagValue" => String,
     ?"accountId" => String,
     ?"pluginId" => String,
-    ?"service" => String
+    ?"service" => String,
+    ?"virtualTagKey" => String,
+    ?"virtualTagValue" => String
   }
 
   # Spec schema: `ApiKey`.
@@ -1095,7 +1097,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -1383,7 +1386,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -1994,6 +1998,7 @@ module Infrawrench
         | "tag"
         | "charge_type"
         | "commitment"
+        | "virtual_tag"
       | nil,
     "groupByTagKey" => String | nil,
     "cadence" => cost_change_cadence,
@@ -2036,7 +2041,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -2054,6 +2060,7 @@ module Infrawrench
         | "tag"
         | "charge_type"
         | "commitment"
+        | "virtual_tag"
       | nil,
     ?"groupByTagKey" => String,
     "cadence" => cost_change_cadence,
@@ -2324,9 +2331,12 @@ module Infrawrench
     | "tag"
     | "charge_type"
     | "commitment"
+    | "virtual_tag"
 
   # Spec schema: `CostDimensionValues`.
-  type cost_dimension_values = { "values" => Array[String | { "value" => String, "label" => String }] }
+  type cost_dimension_values = {
+    "values" => Array[String | { "value" => String, "label" => String, ?"preferred" => bool, ?"hidden" => bool }]
+  }
 
   # Spec schema: `CostEfficiencySettings`.
   type cost_efficiency_settings = {
@@ -2426,7 +2436,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -2473,8 +2484,10 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment"],
+      | "commitment"
+      | "virtual_tag"],
     "tagKeys" => Array[String],
+    ?"virtualTagKeys" => Array[String],
     "filters" => Array[cost_export_filter],
     ?"chargeTypes" => Array["usage"
       | "commitment_covered_usage"
@@ -2562,7 +2575,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     ?"groupByTagKey" => String,
     ?"filters" => Array[cost_report_filter],
     ?"savedFilterId" => String,
@@ -2607,7 +2621,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     ?"groupByTagKey" => String,
     ?"filters" => Array[cost_filter],
     ?"query" => String,
@@ -2668,7 +2683,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -2783,7 +2799,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -3551,6 +3568,28 @@ module Infrawrench
   # Spec schema: `DiscountTreatment`.
   type discount_treatment = { "mode" => "pass_through" | "partial" | "retain", ?"passThroughPercent" => Numeric | nil }
 
+  # Spec schema: `DiscoveredTagKey`.
+  type discovered_tag_key = {
+    "key" => String,
+    "providers" => Array[String],
+    "sources" => Array["costs" | "resources"],
+    "costRowCount" => Integer,
+    "costResourceCount" => Integer,
+    "inventoryCount" => Integer,
+    "lastSeen" => String | nil,
+    "hidden" => bool,
+    "hiddenBy" => String | nil,
+    "preferred" => bool
+  }
+
+  # Spec schema: `DiscoveredTagKeys`.
+  type discovered_tag_keys = {
+    "keys" => Array[discovered_tag_key],
+    "settings" => tag_key_settings,
+    "lookbackDays" => Integer,
+    "truncated" => bool
+  }
+
   # Spec schema: `DismissedAccessFinding`.
   type dismissed_access_finding = {
     "resourceId" => String,
@@ -5214,7 +5253,8 @@ module Infrawrench
   # Spec schema: `MetricAlertSelectorOptions`.
   type metric_alert_selector_options = {
     "plugins" => Array[{ "pluginId" => String, "resourceTypeIds" => Array[String] }],
-    "tagKeys" => Array[String]
+    "tagKeys" => Array[String],
+    "preferredTagKeys" => Array[String]
   }
 
   # Spec schema: `MetricAlertSelectorPreview`.
@@ -8032,7 +8072,8 @@ module Infrawrench
       | "resource"
       | "tag"
       | "charge_type"
-      | "commitment",
+      | "commitment"
+      | "virtual_tag",
     "op" => "in" | "not_in",
     "values" => Array[String],
     ?"tagKey" => String
@@ -8806,6 +8847,9 @@ module Infrawrench
   # Spec schema: `TagComplianceReport`.
   type tag_compliance_report = { "policy" => tag_policy, "accounts" => Array[account_tag_compliance] }
 
+  # Spec schema: `TagKeySettings`.
+  type tag_key_settings = { "hidden" => Array[String], "preferred" => Array[String] }
+
   # Spec schema: `TagPolicy`.
   type tag_policy = { "requiredTags" => Array[required_tag], "enforceOnCreate" => bool }
 
@@ -8982,6 +9026,72 @@ module Infrawrench
   # Spec schema: `ValidateTabsResponse`.
   type validate_tabs_response = { "validTabIds" => Array[String] }
 
+  # Spec schema: `VirtualTag`.
+  type virtual_tag = {
+    "id" => String,
+    "key" => String,
+    "name" => String,
+    "description" => String | nil,
+    "defaultValue" => String | nil,
+    "rules" => Array[virtual_tag_rule],
+    "status" => {
+      "state" => "pending" | "processing" | "ready" | "failed",
+      "processedAt" => String | nil,
+      "error" => String | nil,
+      "stats" => virtual_tag_stats
+    },
+    "createdByUserId" => String | nil,
+    "createdAt" => String,
+    "updatedAt" => String
+  }
+
+  # Spec schema: `VirtualTagAllocation`.
+  type virtual_tag_allocation = { "value" => String, ?"percent" => Numeric | nil, ?"metricId" => String | nil }
+
+  # Spec schema: `VirtualTagCurrencyStats`.
+  type virtual_tag_currency_stats = {
+    "currency" => String,
+    "total" => Numeric,
+    "unmatched" => Numeric,
+    "byRule" => Array[Numeric],
+    "topValues" => Array[{ "value" => String, "amount" => Numeric }]
+  }
+
+  # Spec schema: `VirtualTagInput`.
+  type virtual_tag_input = {
+    "key" => String,
+    "name" => String,
+    ?"description" => String | nil,
+    ?"defaultValue" => String | nil,
+    "rules" => Array[virtual_tag_rule]
+  }
+
+  # Spec schema: `VirtualTagRule`.
+  type virtual_tag_rule = {
+    ?"query" => String,
+    ?"description" => String | nil,
+    ?"startsOn" => String | nil,
+    ?"endsOn" => String | nil,
+    "kind" => "value" | "tag" | "split" | "metric_split",
+    ?"value" => String | nil,
+    ?"sources" => Array[virtual_tag_source],
+    ?"valueTransform" => "none" | "lower" | "upper",
+    ?"allocations" => Array[virtual_tag_allocation]
+  }
+
+  # Spec schema: `VirtualTagSource`.
+  type virtual_tag_source = { "tagKey" => String, ?"valuePrefix" => String | nil, ?"query" => String | nil }
+
+  # Spec schema: `VirtualTagStats`.
+  type virtual_tag_stats = {
+      "from" => String | nil,
+      "to" => String | nil,
+      "currencies" => Array[virtual_tag_currency_stats],
+      "metricFallbackDays" => Integer,
+      "distinctValues" => Integer
+    }
+    | nil
+
   # Spec schema: `WallboardFailureLine`.
   type wallboard_failure_line = { "id" => String, "label" => String, "detail" => String, "since" => String | nil }
 
@@ -9622,7 +9732,7 @@ module Infrawrench
     attr_reader anomaly_settings: CostsAnomalySettingsNamespace
     attr_reader efficiency_alert_settings: CostsEfficiencyAlertSettingsNamespace
     def initialize: (Transport) -> void
-    def dimensions: (dimension: "provider" | "account" | "service" | "region" | "resource" | "tag" | "charge_type" | "commitment" | "tag-keys" | "usage-units", ?org_id: String?, ?tag_key: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_dimension_values
+    def dimensions: (dimension: "provider" | "account" | "service" | "region" | "resource" | "tag" | "charge_type" | "commitment" | "virtual_tag" | "tag-keys" | "usage-units" | "virtual-tag-keys", ?org_id: String?, ?tag_key: String?, ?include_hidden: "true" | "false"?, ?request_options: Hash[Symbol, untyped]?) -> cost_dimension_values
     def efficiency_alerts: (?org_id: String?, ?kind: "commitment_expiry" | "commitment_idle" | "unit_cost_regression"?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> { "events" => Array[efficiency_alert_event] }
     def focus_export: (body: focus_export_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> String
     def query: (body: cost_query_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_query_response
@@ -10431,6 +10541,18 @@ module Infrawrench
     def upload: (body: storage_upload_form, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> ok
   end
 
+  class TagKeysSettingsNamespace
+    def initialize: (Transport) -> void
+    def get: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> tag_key_settings
+    def update: (body: tag_key_settings, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> tag_key_settings
+  end
+
+  class TagKeysNamespace
+    attr_reader settings: TagKeysSettingsNamespace
+    def initialize: (Transport) -> void
+    def get: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> discovered_tag_keys
+  end
+
   class TagPolicyNamespace
     def initialize: (Transport) -> void
     def compliance: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> tag_compliance_report
@@ -10469,6 +10591,17 @@ module Infrawrench
     def permissions: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> permission_catalog
   end
 
+  class VirtualTagsNamespace
+    def initialize: (Transport) -> void
+    def create: (body: virtual_tag_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> virtual_tag
+    def delete: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> ok
+    def get: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> virtual_tag
+    def list: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> Array[virtual_tag]
+    def preview: (body: virtual_tag_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> (virtual_tag_stats & Hash[String, untyped])
+    def reprocess: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> virtual_tag
+    def update: (id: String, body: virtual_tag_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> virtual_tag
+  end
+
   class WallboardNamespace
     def initialize: (Transport) -> void
     def get: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> wallboard_response
@@ -10612,8 +10745,10 @@ module Infrawrench
     attr_reader status_incidents: StatusIncidentsNamespace
     attr_reader status_pages: StatusPagesNamespace
     attr_reader storage: StorageNamespace
+    attr_reader tag_keys: TagKeysNamespace
     attr_reader tag_policy: TagPolicyNamespace
     attr_reader team: TeamNamespace
+    attr_reader virtual_tags: VirtualTagsNamespace
     attr_reader wallboard: WallboardNamespace
     attr_reader workflow_approvals: WorkflowApprovalsNamespace
     attr_reader workflow_secrets: WorkflowSecretsNamespace

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infrawrench-sdk
 version: !ruby/object:Gem::Version
-  version: 1.60.0
+  version: 1.62.0
 platform: ruby
 authors:
 - Infrawrench LLC
@@ -11,7 +11,7 @@ bindir: bin
 cert_chain: []
 date: 2026-10-05 00:00:00.000000000 Z
 dependencies: []
-description: Generated Ruby client for the Infrawrench API (v1.60.0). Covers the published
+description: Generated Ruby client for the Infrawrench API (v1.62.0). Covers the published
   API surface only — operations marked x-internal in the spec are not generated. No
   runtime dependencies.
 email:
@@ -58,5 +58,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Generated Ruby client for the Infrawrench API (v1.60.0).
+summary: Generated Ruby client for the Infrawrench API (v1.62.0).
 test_files: []