infrawrench-sdk 1.52.0 → 1.55.0

data/lib/infrawrench/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.52.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.55.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.52.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.55.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -2502,6 +2502,68 @@ module Infrawrench
       )
     end
 
+    # Preview a rule or customer pricing against a month of spend
+    #
+    # Prices one calendar month (last month by default) twice: with the saved
+    # rules and settings, and with the candidate rule or customer settings
+    # swapped in. Nothing is written. Returns both totals, every effect,
+    # re-rating coverage, any expression failures and the lines that moved most.
+    #
+    # Requires `costs:read`, and `invoices:read` as well when a customer is
+    # named.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # POST /api/org/{orgId}/billing-rules/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 `PricingPreviewRequest`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `PricingPreviewResult` — 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}/billing-rules/preview",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Reorder billing rules
+    #
+    # Rewrites every rule's priority to match the given order (10, 20, 30…) in
+    # one transaction and one audit entry. The list must name every rule exactly
+    # once.
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # POST /api/org/{orgId}/billing-rules/reorder
+    #
+    # 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 `BillingRuleOrder`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<Hash>] Parsed JSON, shaped as `Array<BillingRule>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def reorder(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/billing-rules/reorder",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
     # Update a billing rule
     #
     # A full replace, `enabled` included — switching a markup off is an edit of
@@ -4328,62 +4390,500 @@ module Infrawrench
     # A hard delete. A withdrawn explanation should stop being drawn, and
     # nothing references a note by id.
     #
-    # _Requires permission: `costs:write`._
+    # _Requires permission: `costs:write`._
+    #
+    # DELETE /api/org/{orgId}/cost-annotations/{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 `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}/cost-annotations/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # List cost annotations
+    #
+    # Dated notes drawn over cost charts. With `reportId`, the set a chart for
+    # that report draws: the org-wide notes plus that report's own. Without it,
+    # every annotation in the org. Annotations are an overlay — they never
+    # appear in a series, a total, or an axis.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/cost-annotations
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param report_id [String, nil] Scope to the notes a chart for this report should draw.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `Hash` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(org_id: nil, report_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/cost-annotations",
+        path_params: { "orgId" => org_id },
+        query: { "reportId" => report_id },
+        request_options: request_options
+      )
+    end
+
+    # Update a cost annotation
+    #
+    # Replaces the note's dates, text and scope. Moving a note between org-wide
+    # and one report is this same PUT with a different `costReportId`.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # PUT /api/org/{orgId}/cost-annotations/{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 `CostAnnotationInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CostAnnotation` — 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}/cost-annotations/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
+  # `client.cost_canvases.notifications`
+  class CostCanvasesNotificationsNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Create a canvas delivery schedule
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # POST /api/org/{orgId}/cost-canvases/{id}/notifications
+    #
+    # 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 `DashboardNotificationInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvasNotification` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def create(id:, body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications",
+        path_params: { "orgId" => org_id, "id" => id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Delete a canvas delivery schedule
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # DELETE /api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}
+    #
+    # 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 notification_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:, notification_id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "DELETE",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}",
+        path_params: { "orgId" => org_id, "id" => id, "notificationId" => notification_id },
+        request_options: request_options
+      )
+    end
+
+    # List a canvas's delivery schedules
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/cost-canvases/{id}/notifications
+    #
+    # 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 [Array<Hash>] Parsed JSON, shaped as `Array<CostCanvasNotification>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def list(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # Send a canvas delivery now
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # POST
+    # /api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}/send
+    #
+    # 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 notification_id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `DashboardNotificationSendResult` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def post_org_org_id_cost_canvases_id_notifications_notification_id_send(
+      id:,
+      notification_id:,
+      org_id: nil,
+      request_options: nil
+    )
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}/send",
+        path_params: { "orgId" => org_id, "id" => id, "notificationId" => notification_id },
+        request_options: request_options
+      )
+    end
+
+    # List the destinations a canvas schedule can deliver to
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # GET /api/org/{orgId}/cost-canvases/{id}/notifications/targets
+    #
+    # 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 `ReportDeliveryTargets` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def targets(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications/targets",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # Replace a canvas delivery schedule
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # PUT /api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}
+    #
+    # 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 notification_id [String]
+    # @param body [Hash] Request body, shaped as `DashboardNotificationInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvasNotification` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def update(id:, notification_id:, body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "PUT",
+        path: "/api/org/{orgId}/cost-canvases/{id}/notifications/{notificationId}",
+        path_params: { "orgId" => org_id, "id" => id, "notificationId" => notification_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
+  # `client.cost_canvases`
+  class CostCanvasesNamespace
+    # @return [CostCanvasesNotificationsNamespace] `client.cost_canvases.notifications`
+    attr_reader :notifications
+
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+      @notifications = CostCanvasesNotificationsNamespace.new(@transport)
+    end
+
+    # Open the caller's editing conversation for a canvas
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/cost-canvases/{id}/conversation
+    #
+    # 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, nil] Request body, shaped as `Hash`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `Hash` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def conversation(id:, org_id: nil, body: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/{id}/conversation",
+        path_params: { "orgId" => org_id, "id" => id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Create a cost canvas from a spec
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/cost-canvases
+    #
+    # 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 `CostCanvasInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvas` — 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}/cost-canvases",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Delete a cost canvas
+    #
+    # Soft delete. Its dashboard cards and delivery schedules go with it.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # DELETE /api/org/{orgId}/cost-canvases/{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 `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}/cost-canvases/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # Start a canvas from a description
+    #
+    # Creates an empty canvas and a chat conversation linked to it. Send
+    # `prompt` as the conversation's first message (`POST
+    # /chat/conversations/{id}/messages`); the agent writes the spec. Needs
+    # `chat:write` as well as `costs:write`.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/cost-canvases/draft
+    #
+    # 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 `CostCanvasDraftInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvas` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def draft(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/draft",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Get a cost canvas
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/cost-canvases/{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 `CostCanvas` — 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}/cost-canvases/{id}",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
+    # List cost canvases
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/cost-canvases
+    #
+    # @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<CostCanvas>` — 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}/cost-canvases",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
+
+    # Export a cost canvas as a PDF
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/cost-canvases/{id}/pdf
+    #
+    # 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 tz [String, nil] IANA zone the document's generated-at line is written in, e.g.
+    #   `Europe/Berlin`. UTC when absent or unknown.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [String] Raw response bytes.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def pdf(id:, org_id: nil, tz: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/cost-canvases/{id}/pdf",
+        path_params: { "orgId" => org_id, "id" => id },
+        query: { "tz" => tz },
+        accept: :binary,
+        request_options: request_options
+      )
+    end
+
+    # Run an unsaved canvas spec
+    #
+    # _Requires permission: `costs:read`._
     #
-    # DELETE /api/org/{orgId}/cost-annotations/{id}
+    # POST /api/org/{orgId}/cost-canvases/preview
     #
-    # Raises on 404: Not found
+    # Raises on 400: Bad request
     #
     # @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 `Hash`.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
-    # @return [Hash] Parsed JSON, shaped as `Ok` — see `sig/infrawrench/sdk.rbs`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvasRunResult` — see
+    #   `sig/infrawrench/sdk.rbs`.
     # @raise [Infrawrench::ApiError] On any non-2xx response.
-    def delete(id:, org_id: nil, request_options: nil)
+    def preview(body:, org_id: nil, request_options: nil)
       @transport.request(
-        http_method: "DELETE",
-        path: "/api/org/{orgId}/cost-annotations/{id}",
-        path_params: { "orgId" => org_id, "id" => id },
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/preview",
+        path_params: { "orgId" => org_id },
+        body: body,
         request_options: request_options
       )
     end
 
-    # List cost annotations
+    # Run (refresh) a cost canvas
     #
-    # Dated notes drawn over cost charts. With `reportId`, the set a chart for
-    # that report draws: the org-wide notes plus that report's own. Without it,
-    # every annotation in the org. Annotations are an overlay — they never
-    # appear in a series, a total, or an axis.
+    # Re-executes every block's query. Deterministic; no model call.
     #
     # _Requires permission: `costs:read`._
     #
-    # GET /api/org/{orgId}/cost-annotations
+    # POST /api/org/{orgId}/cost-canvases/{id}/run
+    #
+    # Raises on 404: Not found
     #
     # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
     #   constructed with.
-    # @param report_id [String, nil] Scope to the notes a chart for this report should draw.
+    # @param id [String]
+    # @param body [Hash, nil] Request body, shaped as `Hash`.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
-    # @return [Hash] Parsed JSON, shaped as `Hash` — see `sig/infrawrench/sdk.rbs`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvasRunResult` — see
+    #   `sig/infrawrench/sdk.rbs`.
     # @raise [Infrawrench::ApiError] On any non-2xx response.
-    def get(org_id: nil, report_id: nil, request_options: nil)
+    def run(id:, org_id: nil, body: nil, request_options: nil)
       @transport.request(
-        http_method: "GET",
-        path: "/api/org/{orgId}/cost-annotations",
-        path_params: { "orgId" => org_id },
-        query: { "reportId" => report_id },
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-canvases/{id}/run",
+        path_params: { "orgId" => org_id, "id" => id },
+        body: body,
         request_options: request_options
       )
     end
 
-    # Update a cost annotation
-    #
-    # Replaces the note's dates, text and scope. Moving a note between org-wide
-    # and one report is this same PUT with a different `costReportId`.
+    # Replace a cost canvas
     #
     # _Requires permission: `costs:write`._
     #
-    # PUT /api/org/{orgId}/cost-annotations/{id}
+    # PUT /api/org/{orgId}/cost-canvases/{id}
     #
     # Raises on 400: Bad request
     #
@@ -4392,14 +4892,14 @@ module Infrawrench
     # @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 `CostAnnotationInput`.
+    # @param body [Hash] Request body, shaped as `CostCanvasInput`.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
-    # @return [Hash] Parsed JSON, shaped as `CostAnnotation` — see `sig/infrawrench/sdk.rbs`.
+    # @return [Hash] Parsed JSON, shaped as `CostCanvas` — 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}/cost-annotations/{id}",
+        path: "/api/org/{orgId}/cost-canvases/{id}",
         path_params: { "orgId" => org_id, "id" => id },
         body: body,
         request_options: request_options
@@ -8758,6 +9258,326 @@ module Infrawrench
     end
   end
 
+  # `client.github_issues.pull_requests`
+  class GithubIssuesPullRequestsNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Open an IaC pull request for a finding
+    #
+    # Creates a branch, commits the one-file change and opens a pull request
+    # against the mapped base branch. Never merged automatically.
+    #
+    # _Requires permission: `github-issues:write`._
+    #
+    # POST /api/org/{orgId}/github-issues/pull-requests
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `GithubPullRequestInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `GithubPullRequestResult` — 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}/github-issues/pull-requests",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # Preview an IaC pull request for a finding
+    #
+    # Reads only. Says what the pull request would change (one file, as a diff),
+    # or why the change is not mechanical.
+    #
+    # _Requires permission: `github-issues:write`._
+    #
+    # POST /api/org/{orgId}/github-issues/pull-requests/preview
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `GithubPullRequestInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `GithubPullRequestPreview` — 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}/github-issues/pull-requests/preview",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
+  # `client.github_issues`
+  class GithubIssuesNamespace
+    # @return [GithubIssuesPullRequestsNamespace] `client.github_issues.pull_requests`
+    attr_reader :pull_requests
+
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+      @pull_requests = GithubIssuesPullRequestsNamespace.new(@transport)
+    end
+
+    # List a repository's assignable users
+    #
+    # Backs the assignee picker.
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues/assignees
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param installation_id [Integer]
+    # @param repo [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<Hash>] Parsed JSON, shaped as `Array<GithubAssignee>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def assignees(installation_id:, repo:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/github-issues/assignees",
+        path_params: { "orgId" => org_id },
+        query: { "installationId" => installation_id, "repo" => repo },
+        request_options: request_options
+      )
+    end
+
+    # List a repository's branches
+    #
+    # Backs the base-branch picker for Terraform sources.
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues/branches
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param installation_id [Integer]
+    # @param repo [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<String>] Parsed JSON, shaped as `Array<String>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def branches(installation_id:, repo:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/github-issues/branches",
+        path_params: { "orgId" => org_id },
+        query: { "installationId" => installation_id, "repo" => repo },
+        request_options: request_options
+      )
+    end
+
+    # Get GitHub issue settings and installation access
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues
+    #
+    # @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 `GithubIssuesStatus` — 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}/github-issues",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
+
+    # File a finding as a GitHub issue
+    #
+    # Opens an issue in the routed repository, or comments on the open issue
+    # already filed for the same finding (matched by fingerprint, including a
+    # hidden marker in issue bodies).
+    #
+    # _Requires permission: `github-issues:write`._
+    #
+    # POST /api/org/{orgId}/github-issues/issues
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `FileGithubIssueInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `FileGithubIssueResult` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def issues(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/github-issues/issues",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # List a repository's labels
+    #
+    # Backs the label picker.
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues/labels
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 409: The GitHub App installation needs a permission an owner has
+    # not approved yet
+    #
+    # Raises on 502: GitHub refused the request or was unreachable
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param installation_id [Integer]
+    # @param repo [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<Hash>] Parsed JSON, shaped as `Array<GithubLabel>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def labels(installation_id:, repo:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/github-issues/labels",
+        path_params: { "orgId" => org_id },
+        query: { "installationId" => installation_id, "repo" => repo },
+        request_options: request_options
+      )
+    end
+
+    # Look up filed GitHub issues for a set of findings
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues/links
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param source_kind [String, nil]
+    # @param state [String, nil]
+    # @param source_id [Array<String>, nil]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Array<Hash>] Parsed JSON, shaped as `Array<GithubIssueLink>` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def links(org_id: nil, source_kind: nil, state: nil, source_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/github-issues/links",
+        path_params: { "orgId" => org_id },
+        query: { "sourceKind" => source_kind, "state" => state, "sourceId" => source_id },
+        request_options: request_options
+      )
+    end
+
+    # Resolve where a finding would be filed
+    #
+    # _Requires permission: `github-issues:read`._
+    #
+    # GET /api/org/{orgId}/github-issues/route
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param resource_id [String, nil]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `GithubIssueRouteResolution` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def route(org_id: nil, resource_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/github-issues/route",
+        path_params: { "orgId" => org_id },
+        query: { "resourceId" => resource_id },
+        request_options: request_options
+      )
+    end
+
+    # Replace the GitHub issue settings
+    #
+    # Whole-document replace: route order is part of the meaning. Route and
+    # source ids are kept when supplied.
+    #
+    # _Requires permission: `org:settings:write`._
+    #
+    # PUT /api/org/{orgId}/github-issues/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 `GithubIssueSettingsInput`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `GithubIssueSettings` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def settings(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "PUT",
+        path: "/api/org/{orgId}/github-issues/settings",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.iac.states`
   class IacStatesNamespace
     # @api private
@@ -17701,6 +18521,8 @@ module Infrawrench
     attr_reader :cost_alerts
     # @return [CostAnnotationsNamespace] `client.cost_annotations`
     attr_reader :cost_annotations
+    # @return [CostCanvasesNamespace] `client.cost_canvases`
+    attr_reader :cost_canvases
     # @return [CostCentresNamespace] `client.cost_centres`
     attr_reader :cost_centres
     # @return [CostExportsNamespace] `client.cost_exports`
@@ -17745,6 +18567,8 @@ module Infrawrench
     attr_reader :environments
     # @return [ExpiringNamespace] `client.expiring`
     attr_reader :expiring
+    # @return [GithubIssuesNamespace] `client.github_issues`
+    attr_reader :github_issues
     # @return [IacNamespace] `client.iac`
     attr_reader :iac
     # @return [IncidentsNamespace] `client.incidents`
@@ -17881,6 +18705,7 @@ module Infrawrench
       @connect = ConnectNamespace.new(@transport)
       @cost_alerts = CostAlertsNamespace.new(@transport)
       @cost_annotations = CostAnnotationsNamespace.new(@transport)
+      @cost_canvases = CostCanvasesNamespace.new(@transport)
       @cost_centres = CostCentresNamespace.new(@transport)
       @cost_exports = CostExportsNamespace.new(@transport)
       @cost_report_folders = CostReportFoldersNamespace.new(@transport)
@@ -17903,6 +18728,7 @@ module Infrawrench
       @environment_diff = EnvironmentDiffNamespace.new(@transport)
       @environments = EnvironmentsNamespace.new(@transport)
       @expiring = ExpiringNamespace.new(@transport)
+      @github_issues = GithubIssuesNamespace.new(@transport)
       @iac = IacNamespace.new(@transport)
       @incidents = IncidentsNamespace.new(@transport)
       @invitations = InvitationsNamespace.new(@transport)