hanzoai 8.5.156

data/lib/hanzoai/api/platform_api.rb

@@ -0,0 +1,2522 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class PlatformApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Deletes an application and tears down what it runs.
+    # Deletes an application and tears down what it runs.  It removes the application record and tears down what it owns in the org's tenant namespace — its operator Service CR and its KMSSecret — then answers 204. An app this org and project do not have is 404, never a silent success.  Teardown is best-effort by design: a cluster that refuses or is unreachable does not block the delete, so the record cannot be left orphaned behind a broken cluster; the failure is logged for operators and the orphan reaper reconciles it. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application's slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_platform_projects_by_project_apps_by_app(project, app, opts = {})
+      delete_platform_projects_by_project_apps_by_app_with_http_info(project, app, opts)
+      nil
+    end
+
+    # Deletes an application and tears down what it runs.
+    # Deletes an application and tears down what it runs.  It removes the application record and tears down what it owns in the org's tenant namespace — its operator Service CR and its KMSSecret — then answers 204. An app this org and project do not have is 404, never a silent success.  Teardown is best-effort by design: a cluster that refuses or is unreachable does not block the delete, so the record cannot be left orphaned behind a broken cluster; the failure is logged for operators and the orphan reaper reconciles it. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application's slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_platform_projects_by_project_apps_by_app_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.delete_platform_projects_by_project_apps_by_app ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.delete_platform_projects_by_project_apps_by_app"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.delete_platform_projects_by_project_apps_by_app"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.delete_platform_projects_by_project_apps_by_app",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#delete_platform_projects_by_project_apps_by_app\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Detaches a hostname and releases the claim.
+    # Detaches a hostname and releases the claim.  It drops the host from the app's ingress and releases any custom claim on it, so the name becomes claimable again — by this org or any other. Answers 204.  The default host is permanent and cannot be removed: that is 400, not 404. A host that is neither attached nor claimed here is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param host [String] Host is the hostname, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_platform_projects_by_project_apps_by_app_domains_by_host(project, app, host, opts = {})
+      delete_platform_projects_by_project_apps_by_app_domains_by_host_with_http_info(project, app, host, opts)
+      nil
+    end
+
+    # Detaches a hostname and releases the claim.
+    # Detaches a hostname and releases the claim.  It drops the host from the app&#39;s ingress and releases any custom claim on it, so the name becomes claimable again — by this org or any other. Answers 204.  The default host is permanent and cannot be removed: that is 400, not 404. A host that is neither attached nor claimed here is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param host [String] Host is the hostname, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_platform_projects_by_project_apps_by_app_domains_by_host_with_http_info(project, app, host, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.delete_platform_projects_by_project_apps_by_app_domains_by_host ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.delete_platform_projects_by_project_apps_by_app_domains_by_host"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.delete_platform_projects_by_project_apps_by_app_domains_by_host"
+      end
+      # verify the required parameter 'host' is set
+      if @api_client.config.client_side_validation && host.nil?
+        fail ArgumentError, "Missing the required parameter 'host' when calling PlatformApi.delete_platform_projects_by_project_apps_by_app_domains_by_host"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/domains/{host}'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s)).sub('{' + 'host' + '}', CGI.escape(host.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.delete_platform_projects_by_project_apps_by_app_domains_by_host",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#delete_platform_projects_by_project_apps_by_app_domains_by_host\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers what this organisation has declared, joined with what the delivery plane has done about it.
+    # Answers what this organisation has declared, joined with what the delivery plane has done about it.  The join is best-effort BY DESIGN and says so when it is missing: the declarations ARE the answer to \"what have I deployed\", so refusing the whole board because the cluster is unreadable would lose the half that is readable. What must never happen is a silent null — an unreadable plane is reported as `cd.unavailable` carrying the reason, never as an app with no reconciliation.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation whose declarations to read, defaulting to the caller&#39;s own. Only a SuperAdmin may name one that is not theirs; anyone else naming a foreign org is refused, so this widens nothing by itself.
+    # @return [DeclaredResp]
+    def get_platform_apps(opts = {})
+      data, _status_code, _headers = get_platform_apps_with_http_info(opts)
+      data
+    end
+
+    # Answers what this organisation has declared, joined with what the delivery plane has done about it.
+    # Answers what this organisation has declared, joined with what the delivery plane has done about it.  The join is best-effort BY DESIGN and says so when it is missing: the declarations ARE the answer to \&quot;what have I deployed\&quot;, so refusing the whole board because the cluster is unreadable would lose the half that is readable. What must never happen is a silent null — an unreadable plane is reported as &#x60;cd.unavailable&#x60; carrying the reason, never as an app with no reconciliation.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation whose declarations to read, defaulting to the caller&#39;s own. Only a SuperAdmin may name one that is not theirs; anyone else naming a foreign org is refused, so this widens nothing by itself.
+    # @return [Array<(DeclaredResp, Integer, Hash)>] DeclaredResp data, response status code and response headers
+    def get_platform_apps_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_apps ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/apps'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'org'] = opts[:'org'] if !opts[:'org'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeclaredResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_apps",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers ONE declaration — what git says this app is, before the delivery plane has had any say in it.
+    # Answers ONE declaration — what git says this app is, before the delivery plane has had any say in it.
+    # @param app [String] App is the DNS-1123 label of the declaration. The URL is the addressing authority — a path segment binds after the body and after the query — so the address decides which app is read whatever else is sent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation the declaration lives in, defaulting to the caller&#39;s own and subject to the same SuperAdmin rule as the listing.
+    # @return [Declaration]
+    def get_platform_apps_by_app(app, opts = {})
+      data, _status_code, _headers = get_platform_apps_by_app_with_http_info(app, opts)
+      data
+    end
+
+    # Answers ONE declaration — what git says this app is, before the delivery plane has had any say in it.
+    # Answers ONE declaration — what git says this app is, before the delivery plane has had any say in it.
+    # @param app [String] App is the DNS-1123 label of the declaration. The URL is the addressing authority — a path segment binds after the body and after the query — so the address decides which app is read whatever else is sent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation the declaration lives in, defaulting to the caller&#39;s own and subject to the same SuperAdmin rule as the listing.
+    # @return [Array<(Declaration, Integer, Hash)>] Declaration data, response status code and response headers
+    def get_platform_apps_by_app_with_http_info(app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_apps_by_app ...'
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_apps_by_app"
+      end
+      # resource path
+      local_var_path = '/v1/platform/apps/{app}'.sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'org'] = opts[:'org'] if !opts[:'org'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Declaration'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_apps_by_app",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_apps_by_app\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers ONE app's reconciliation alone — the poll a deploy console makes while it waits, without re-reading the whole inventory each time.
+    # Answers ONE app's reconciliation alone — the poll a deploy console makes while it waits, without re-reading the whole inventory each time.
+    # @param app [String] App is the DNS-1123 label of the declaration. The URL is the addressing authority — a path segment binds after the body and after the query — so the address decides which app is read whatever else is sent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation the declaration lives in, defaulting to the caller&#39;s own and subject to the same SuperAdmin rule as the listing.
+    # @return [CDApp]
+    def get_platform_apps_by_app_cd(app, opts = {})
+      data, _status_code, _headers = get_platform_apps_by_app_cd_with_http_info(app, opts)
+      data
+    end
+
+    # Answers ONE app&#39;s reconciliation alone — the poll a deploy console makes while it waits, without re-reading the whole inventory each time.
+    # Answers ONE app&#39;s reconciliation alone — the poll a deploy console makes while it waits, without re-reading the whole inventory each time.
+    # @param app [String] App is the DNS-1123 label of the declaration. The URL is the addressing authority — a path segment binds after the body and after the query — so the address decides which app is read whatever else is sent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :org Org names the organisation the declaration lives in, defaulting to the caller&#39;s own and subject to the same SuperAdmin rule as the listing.
+    # @return [Array<(CDApp, Integer, Hash)>] CDApp data, response status code and response headers
+    def get_platform_apps_by_app_cd_with_http_info(app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_apps_by_app_cd ...'
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_apps_by_app_cd"
+      end
+      # resource path
+      local_var_path = '/v1/platform/apps/{app}/cd'.sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'org'] = opts[:'org'] if !opts[:'org'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CDApp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_apps_by_app_cd",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_apps_by_app_cd\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns real build records for your org.
+    # Returns real build records for your org.  It lists the org's BuildKit build records — the git build step behind a deploy — each with the repo it built, the short commit, its status, when it started and how long it took. These are real records or an honest empty list; a build appears here because one ran, never because a page needed a row. Builds are created only by /deploy and the push-to-deploy hook. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [BuildBoard]
+    def get_platform_builds(opts = {})
+      data, _status_code, _headers = get_platform_builds_with_http_info(opts)
+      data
+    end
+
+    # Returns real build records for your org.
+    # Returns real build records for your org.  It lists the org&#39;s BuildKit build records — the git build step behind a deploy — each with the repo it built, the short commit, its status, when it started and how long it took. These are real records or an honest empty list; a build appears here because one ran, never because a page needed a row. Builds are created only by /deploy and the push-to-deploy hook. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BuildBoard, Integer, Hash)>] BuildBoard data, response status code and response headers
+    def get_platform_builds_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_builds ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/builds'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BuildBoard'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_builds",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_builds\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers every Application the delivery plane holds.
+    # Answers every Application the delivery plane holds.  Scoped to the namespaces the caller's own validated org owns: the ROLE admits the caller and the tenant boundary is applied inside, so an admin of one org never observes another's.
+    # @param [Hash] opts the optional parameters
+    # @return [CdResp]
+    def get_platform_cd(opts = {})
+      data, _status_code, _headers = get_platform_cd_with_http_info(opts)
+      data
+    end
+
+    # Answers every Application the delivery plane holds.
+    # Answers every Application the delivery plane holds.  Scoped to the namespaces the caller&#39;s own validated org owns: the ROLE admits the caller and the tenant boundary is applied inside, so an admin of one org never observes another&#39;s.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CdResp, Integer, Hash)>] CdResp data, response status code and response headers
+    def get_platform_cd_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_cd ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/cd'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CdResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_cd",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_cd\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Continuous integration (not wired)
+    # Answers 501. The forge's Actions runs need a Forgejo API client and this deployment has none; an empty run list would be indistinguishable from a forge with no runs.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_platform_ci(opts = {})
+      get_platform_ci_with_http_info(opts)
+      nil
+    end
+
+    # Continuous integration (not wired)
+    # Answers 501. The forge&#39;s Actions runs need a Forgejo API client and this deployment has none; an empty run list would be indistinguishable from a forge with no runs.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_platform_ci_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_ci ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/ci'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_ci",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_ci\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns your deploy targets, and what is running on each.
+    # Returns your deploy targets, and what is running on each.  It returns the org's environments — the distinct deploy targets its applications name, `production` for anything that names none — each aggregating the apps that target it, a rolled-up status and when it last changed.  An environment is DERIVED, not stored: there is nothing to create or delete here, and an environment exists exactly as long as an app points at it. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [EnvironmentBoard]
+    def get_platform_environments(opts = {})
+      data, _status_code, _headers = get_platform_environments_with_http_info(opts)
+      data
+    end
+
+    # Returns your deploy targets, and what is running on each.
+    # Returns your deploy targets, and what is running on each.  It returns the org&#39;s environments — the distinct deploy targets its applications name, &#x60;production&#x60; for anything that names none — each aggregating the apps that target it, a rolled-up status and when it last changed.  An environment is DERIVED, not stored: there is nothing to create or delete here, and an environment exists exactly as long as an app points at it. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EnvironmentBoard, Integer, Hash)>] EnvironmentBoard data, response status code and response headers
+    def get_platform_environments_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_environments ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/environments'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EnvironmentBoard'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_environments",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_environments\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the platform's own service tier, and where it has drifted.
+    # Returns the platform's own service tier, and where it has drifted.  It returns the board for the services the PLATFORM itself runs — iam, kms, gateway and the rest — as `{apps, summary}`: per service its environment, health, phase, the image tag its CR DECLARES, the tag actually running, and the drift between them, plus a summary counting the board green, yellow and red.  This is not a customer surface. `/v1/platform/projects/:project/apps` is a tenant's apps; this is the tier those tenants run ON, which is why the two are named differently rather than sharing a prefix.  Admission is scoped at the SCAN, before any CR is read: a platform SuperAdmin observes the whole fleet, an org admin observes only their own org's namespaces, and an org that owns none gets an empty board — a non-super caller never even lists another org's services. Narrow further with `env`, `health`, `org`, or `drift=1` for only what has drifted.  It degrades honestly rather than failing whole: a namespace that does not exist is skipped, and a running-state read the caller cannot make leaves the running tag empty — an unknown, never a guess — while the declared, health and phase columns still render.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :env Env narrows to one lifecycle env: main, test or dev.
+    # @option opts [String] :health Health narrows to one health colour: green, yellow or red.
+    # @option opts [String] :org Org narrows to one image namespace.
+    # @option opts [String] :drift Drift is &#x60;1&#x60; or &#x60;true&#x60; to show only rows that have actually drifted. It is a STRING and not a bool because those two spellings are exactly what the board has always accepted, and a bool would silently widen that to &#x60;?drift&#x60; alone and to &#x60;TRUE&#x60; — a behaviour change wearing a type change&#39;s clothes.
+    # @return [DriftBoard]
+    def get_platform_fleet(opts = {})
+      data, _status_code, _headers = get_platform_fleet_with_http_info(opts)
+      data
+    end
+
+    # Returns the platform&#39;s own service tier, and where it has drifted.
+    # Returns the platform&#39;s own service tier, and where it has drifted.  It returns the board for the services the PLATFORM itself runs — iam, kms, gateway and the rest — as &#x60;{apps, summary}&#x60;: per service its environment, health, phase, the image tag its CR DECLARES, the tag actually running, and the drift between them, plus a summary counting the board green, yellow and red.  This is not a customer surface. &#x60;/v1/platform/projects/:project/apps&#x60; is a tenant&#39;s apps; this is the tier those tenants run ON, which is why the two are named differently rather than sharing a prefix.  Admission is scoped at the SCAN, before any CR is read: a platform SuperAdmin observes the whole fleet, an org admin observes only their own org&#39;s namespaces, and an org that owns none gets an empty board — a non-super caller never even lists another org&#39;s services. Narrow further with &#x60;env&#x60;, &#x60;health&#x60;, &#x60;org&#x60;, or &#x60;drift&#x3D;1&#x60; for only what has drifted.  It degrades honestly rather than failing whole: a namespace that does not exist is skipped, and a running-state read the caller cannot make leaves the running tag empty — an unknown, never a guess — while the declared, health and phase columns still render.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :env Env narrows to one lifecycle env: main, test or dev.
+    # @option opts [String] :health Health narrows to one health colour: green, yellow or red.
+    # @option opts [String] :org Org narrows to one image namespace.
+    # @option opts [String] :drift Drift is &#x60;1&#x60; or &#x60;true&#x60; to show only rows that have actually drifted. It is a STRING and not a bool because those two spellings are exactly what the board has always accepted, and a bool would silently widen that to &#x60;?drift&#x60; alone and to &#x60;TRUE&#x60; — a behaviour change wearing a type change&#39;s clothes.
+    # @return [Array<(DriftBoard, Integer, Hash)>] DriftBoard data, response status code and response headers
+    def get_platform_fleet_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_fleet ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/fleet'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'env'] = opts[:'env'] if !opts[:'env'].nil?
+      query_params[:'health'] = opts[:'health'] if !opts[:'health'].nil?
+      query_params[:'org'] = opts[:'org'] if !opts[:'org'].nil?
+      query_params[:'drift'] = opts[:'drift'] if !opts[:'drift'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DriftBoard'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_fleet",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_fleet\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one platform service, resolved to production by default.
+    # Returns one platform service, resolved to production by default.  It returns a single platform service by its CR name, with the same declared-versus-running and drift facts the board carries. The name must be a DNS-1123 label; anything else is 400.  Namespaces are scanned in lifecycle order — main, then test, then dev — and the first match wins, so a bare name resolves to PRODUCTION. The scan covers only the namespaces the caller is authorized for, so an org admin can never read a service outside their own org, and a name found in none of them is 404 rather than a leak.
+    # @param app [String] App is the service&#39;s CR name, from the path. It must be a DNS-1123 label.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :env Env narrows the scan to one lifecycle env: main, test or dev. Omitted, the namespaces are scanned in lifecycle order and the first match wins, so a bare name resolves to PRODUCTION.
+    # @return [AppView]
+    def get_platform_fleet_by_app(app, opts = {})
+      data, _status_code, _headers = get_platform_fleet_by_app_with_http_info(app, opts)
+      data
+    end
+
+    # Returns one platform service, resolved to production by default.
+    # Returns one platform service, resolved to production by default.  It returns a single platform service by its CR name, with the same declared-versus-running and drift facts the board carries. The name must be a DNS-1123 label; anything else is 400.  Namespaces are scanned in lifecycle order — main, then test, then dev — and the first match wins, so a bare name resolves to PRODUCTION. The scan covers only the namespaces the caller is authorized for, so an org admin can never read a service outside their own org, and a name found in none of them is 404 rather than a leak.
+    # @param app [String] App is the service&#39;s CR name, from the path. It must be a DNS-1123 label.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :env Env narrows the scan to one lifecycle env: main, test or dev. Omitted, the namespaces are scanned in lifecycle order and the first match wins, so a bare name resolves to PRODUCTION.
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def get_platform_fleet_by_app_with_http_info(app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_fleet_by_app ...'
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_fleet_by_app"
+      end
+      # resource path
+      local_var_path = '/v1/platform/fleet/{app}'.sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'env'] = opts[:'env'] if !opts[:'env'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_fleet_by_app",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_fleet_by_app\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reports whether this control plane can actually deploy anything.
+    # Reports whether this control plane can actually deploy anything.  A real probe, not a status page. It answers 200 only when the metadata store is open AND the cluster is genuinely reachable — proved by LISTING the operator App CRD, which settles reachability and CRD presence in one bounded call, and which is the exact question every deploy depends on. Anything else is 503 carrying the real reason and whether the CRD was found.  A constructed cluster client proves nothing — it is built from a kubeconfig, not from a reachable apiserver — so this deliberately spends a round trip rather than reporting `ok` while every deploy fails. Not admin-gated: liveness has to be probe-able without a credential.
+    # @param [Hash] opts the optional parameters
+    # @return [Readiness]
+    def get_platform_health(opts = {})
+      data, _status_code, _headers = get_platform_health_with_http_info(opts)
+      data
+    end
+
+    # Reports whether this control plane can actually deploy anything.
+    # Reports whether this control plane can actually deploy anything.  A real probe, not a status page. It answers 200 only when the metadata store is open AND the cluster is genuinely reachable — proved by LISTING the operator App CRD, which settles reachability and CRD presence in one bounded call, and which is the exact question every deploy depends on. Anything else is 503 carrying the real reason and whether the CRD was found.  A constructed cluster client proves nothing — it is built from a kubeconfig, not from a reachable apiserver — so this deliberately spends a round trip rather than reporting &#x60;ok&#x60; while every deploy fails. Not admin-gated: liveness has to be probe-able without a credential.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Readiness, Integer, Hash)>] Readiness data, response status code and response headers
+    def get_platform_health_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_health ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/health'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Readiness'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_health",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_health\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one build-and-deploy pipeline per app, with its latest run.
+    # Returns one build-and-deploy pipeline per app, with its latest run.  It returns one pipeline per application in the caller's org — its repo or image source, its current status, and when its most recent deployment ran and how long it took. A pipeline is a PROJECTION of an app plus its newest deployment, not a separate record: it comes into existence with the app and is triggered only through /deploy, never here. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [PipelineBoard]
+    def get_platform_pipelines(opts = {})
+      data, _status_code, _headers = get_platform_pipelines_with_http_info(opts)
+      data
+    end
+
+    # Returns one build-and-deploy pipeline per app, with its latest run.
+    # Returns one build-and-deploy pipeline per app, with its latest run.  It returns one pipeline per application in the caller&#39;s org — its repo or image source, its current status, and when its most recent deployment ran and how long it took. A pipeline is a PROJECTION of an app plus its newest deployment, not a separate record: it comes into existence with the app and is triggered only through /deploy, never here. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PipelineBoard, Integer, Hash)>] PipelineBoard data, response status code and response headers
+    def get_platform_pipelines_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_pipelines ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/pipelines'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PipelineBoard'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_pipelines",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_pipelines\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns your org's projects, each with how many apps live under it.
+    # Returns your org's projects, each with how many apps live under it.  It lists the caller org's projects with the number of platform applications in each. A project is IAM's resource — it is created and deleted at /v1/iam/projects, never here — so this is the ONE projection IAM cannot serve: the project plus what the platform has put under it.  Requires a validated principal; 403 without one, and the org comes from that validated identity rather than a request header. This is the console's first authenticated read, so a project store that is not yet initialised degrades to an EMPTY list rather than a 500 — a new org genuinely has zero projects — and the real cause is surfaced to operators instead of to the caller.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<ProjectView>]
+    def get_platform_projects(opts = {})
+      data, _status_code, _headers = get_platform_projects_with_http_info(opts)
+      data
+    end
+
+    # Returns your org&#39;s projects, each with how many apps live under it.
+    # Returns your org&#39;s projects, each with how many apps live under it.  It lists the caller org&#39;s projects with the number of platform applications in each. A project is IAM&#39;s resource — it is created and deleted at /v1/iam/projects, never here — so this is the ONE projection IAM cannot serve: the project plus what the platform has put under it.  Requires a validated principal; 403 without one, and the org comes from that validated identity rather than a request header. This is the console&#39;s first authenticated read, so a project store that is not yet initialised degrades to an EMPTY list rather than a 500 — a new org genuinely has zero projects — and the real cause is surfaced to operators instead of to the caller.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<ProjectView>, Integer, Hash)>] Array<ProjectView> data, response status code and response headers
+    def get_platform_projects_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<ProjectView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one project and its app count.
+    # Returns one project and its app count.  It returns a single project of the caller's org with the number of platform applications under it. A project this org does not have is 404, which is also what another tenant's project looks like from here. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project&#39;s name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [ProjectView]
+    def get_platform_projects_by_project(project, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_with_http_info(project, opts)
+      data
+    end
+
+    # Returns one project and its app count.
+    # Returns one project and its app count.  It returns a single project of the caller&#39;s org with the number of platform applications under it. A project this org does not have is 404, which is also what another tenant&#39;s project looks like from here. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project&#39;s name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ProjectView, Integer, Hash)>] ProjectView data, response status code and response headers
+    def get_platform_projects_by_project_with_http_info(project, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}'.sub('{' + 'project' + '}', CGI.escape(project.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ProjectView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the applications in one project, with what the cluster says about them.
+    # Returns the applications in one project, with what the cluster says about them.  It lists the caller org's applications under one project. Each row carries the stored record and, for an app that is live or deploying, the LIVE phase and health read from its operator Service CR; an app with sealed env also carries its secret-sync state. Those cluster reads are best-effort — an unreachable cluster leaves those fields empty and never blocks the listing.  The project must exist in IAM for this org, or the answer is 404; the `default` project is implicit and always accepted, because it is part of what an org IS. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project&#39;s name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<AppView>]
+    def get_platform_projects_by_project_apps(project, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_with_http_info(project, opts)
+      data
+    end
+
+    # Returns the applications in one project, with what the cluster says about them.
+    # Returns the applications in one project, with what the cluster says about them.  It lists the caller org&#39;s applications under one project. Each row carries the stored record and, for an app that is live or deploying, the LIVE phase and health read from its operator Service CR; an app with sealed env also carries its secret-sync state. Those cluster reads are best-effort — an unreachable cluster leaves those fields empty and never blocks the listing.  The project must exist in IAM for this org, or the answer is 404; the &#x60;default&#x60; project is implicit and always accepted, because it is part of what an org IS. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project&#39;s name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<AppView>, Integer, Hash)>] Array<AppView> data, response status code and response headers
+    def get_platform_projects_by_project_apps_with_http_info(project, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps'.sub('{' + 'project' + '}', CGI.escape(project.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<AppView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one application, with its live phase, health and secret sync.
+    # Returns one application, with its live phase, health and secret sync.  It returns a single application of the caller's org together with what the cluster currently reports for it: the operator Service CR's phase and health, and whether its sealed env has synced. An app this org and project do not have is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [AppView]
+    def get_platform_projects_by_project_apps_by_app(project, app, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_by_app_with_http_info(project, app, opts)
+      data
+    end
+
+    # Returns one application, with its live phase, health and secret sync.
+    # Returns one application, with its live phase, health and secret sync.  It returns a single application of the caller&#39;s org together with what the cluster currently reports for it: the operator Service CR&#39;s phase and health, and whether its sealed env has synced. An app this org and project do not have is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def get_platform_projects_by_project_apps_by_app_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps_by_app ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps_by_app"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_projects_by_project_apps_by_app"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps_by_app",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps_by_app\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns an app's deployment history.
+    # Returns an app's deployment history.  It lists every deployment recorded for one of the caller org's applications, newest version first, each with its version, status, source, commit and image. Failed and superseded attempts are included — that is the point of a history. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<DeploymentView>]
+    def get_platform_projects_by_project_apps_by_app_deployments(project, app, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_by_app_deployments_with_http_info(project, app, opts)
+      data
+    end
+
+    # Returns an app&#39;s deployment history.
+    # Returns an app&#39;s deployment history.  It lists every deployment recorded for one of the caller org&#39;s applications, newest version first, each with its version, status, source, commit and image. Failed and superseded attempts are included — that is the point of a history. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<DeploymentView>, Integer, Hash)>] Array<DeploymentView> data, response status code and response headers
+    def get_platform_projects_by_project_apps_by_app_deployments_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps_by_app_deployments ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/deployments'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<DeploymentView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps_by_app_deployments",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps_by_app_deployments\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one deployment of one app.
+    # Returns one deployment of one app.  It returns a single deployment by id, scoped to the named application of the caller's org — so an id belonging to another app or another tenant is 404, not a read. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param id [String] ID is the deployment&#39;s id, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [DeploymentView]
+    def get_platform_projects_by_project_apps_by_app_deployments_by_id(project, app, id, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_by_app_deployments_by_id_with_http_info(project, app, id, opts)
+      data
+    end
+
+    # Returns one deployment of one app.
+    # Returns one deployment of one app.  It returns a single deployment by id, scoped to the named application of the caller&#39;s org — so an id belonging to another app or another tenant is 404, not a read. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param id [String] ID is the deployment&#39;s id, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeploymentView, Integer, Hash)>] DeploymentView data, response status code and response headers
+    def get_platform_projects_by_project_apps_by_app_deployments_by_id_with_http_info(project, app, id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id"
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/deployments/{id}'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeploymentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps_by_app_deployments_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns real logs for a deployment — the build's, then the app's.
+    # Returns real logs for a deployment — the build's, then the app's.  It returns the deployment's recorded status timeline together with LIVE pod logs pulled from the cluster: the build pod's output while a git build is running, and the running app's output once it is deployed. The `source` field says which of the two the body is — `build`, `app` or `none` — so a console can label the pane honestly.  It never fabricates log content. When no pod exists yet, or the cluster is unreachable, it degrades to the recorded timeline and says so. Every cluster read is confined to the caller org's own namespaces and time-boxed. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param id [String] ID is the deployment&#39;s id, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [DeployLogs]
+    def get_platform_projects_by_project_apps_by_app_deployments_by_id_logs(project, app, id, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_by_app_deployments_by_id_logs_with_http_info(project, app, id, opts)
+      data
+    end
+
+    # Returns real logs for a deployment — the build&#39;s, then the app&#39;s.
+    # Returns real logs for a deployment — the build&#39;s, then the app&#39;s.  It returns the deployment&#39;s recorded status timeline together with LIVE pod logs pulled from the cluster: the build pod&#39;s output while a git build is running, and the running app&#39;s output once it is deployed. The &#x60;source&#x60; field says which of the two the body is — &#x60;build&#x60;, &#x60;app&#x60; or &#x60;none&#x60; — so a console can label the pane honestly.  It never fabricates log content. When no pod exists yet, or the cluster is unreachable, it degrades to the recorded timeline and says so. Every cluster read is confined to the caller org&#39;s own namespaces and time-boxed. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param id [String] ID is the deployment&#39;s id, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeployLogs, Integer, Hash)>] DeployLogs data, response status code and response headers
+    def get_platform_projects_by_project_apps_by_app_deployments_by_id_logs_with_http_info(project, app, id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id_logs ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id_logs"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id_logs"
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id_logs"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/deployments/{id}/logs'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s)).sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeployLogs'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps_by_app_deployments_by_id_logs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps_by_app_deployments_by_id_logs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns every hostname this app answers on.
+    # Returns every hostname this app answers on.  It lists the app's hosts: the permanent default host it was born with, any org-subtree hosts attached to it, and every custom host claimed for it with its verification state and, while pending, the DNS challenge records to publish. Live endpoint status for each host is observed from the cluster. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<DomainView>]
+    def get_platform_projects_by_project_apps_by_app_domains(project, app, opts = {})
+      data, _status_code, _headers = get_platform_projects_by_project_apps_by_app_domains_with_http_info(project, app, opts)
+      data
+    end
+
+    # Returns every hostname this app answers on.
+    # Returns every hostname this app answers on.  It lists the app&#39;s hosts: the permanent default host it was born with, any org-subtree hosts attached to it, and every custom host claimed for it with its verification state and, while pending, the DNS challenge records to publish. Live endpoint status for each host is observed from the cluster. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<DomainView>, Integer, Hash)>] Array<DomainView> data, response status code and response headers
+    def get_platform_projects_by_project_apps_by_app_domains_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_projects_by_project_apps_by_app_domains ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_domains"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.get_platform_projects_by_project_apps_by_app_domains"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/domains'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<DomainView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_projects_by_project_apps_by_app_domains",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_projects_by_project_apps_by_app_domains\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the versions that actually reached the cluster.
+    # Returns the versions that actually reached the cluster.  It lists the org's releases: the deployments that were genuinely applied to the cluster, with the app they belong to, their version, environment, status and when they were released. A deployment that failed or is still building is NOT a release and is excluded — reaching the cluster is what makes one. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [ReleaseBoard]
+    def get_platform_releases(opts = {})
+      data, _status_code, _headers = get_platform_releases_with_http_info(opts)
+      data
+    end
+
+    # Returns the versions that actually reached the cluster.
+    # Returns the versions that actually reached the cluster.  It lists the org&#39;s releases: the deployments that were genuinely applied to the cluster, with the app they belong to, their version, environment, status and when they were released. A deployment that failed or is still building is NOT a release and is excluded — reaching the cluster is what makes one. Requires a validated principal; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ReleaseBoard, Integer, Hash)>] ReleaseBoard data, response status code and response headers
+    def get_platform_releases_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.get_platform_releases ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/releases'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ReleaseBoard'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.get_platform_releases",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#get_platform_releases\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deploy an app through cd.hanzo.ai
+    # Builds a git repository into an image and writes the declaration that names it — a values file in `hanzoai/universe` under `charts/app/values/<namespace>/<name>.yaml`, which the `fleet` ApplicationSet renders as one Application. That file IS the deployment: nothing else has to be applied.  `mode` decides whether anything can go live. The default, `branch`, pushes to `deploy/<namespace>/<name>/<tag>` and returns a review URL; the generator reads main, so a branch declaration deploys NOTHING and merging the review is the deliberate act. `commit` writes main, and proves the image is pullable first — a declaration naming an image the registry cannot serve is an ImagePullBackOff with no rollback path.  Omit `tag` to build; give it to declare an image an earlier call already built, which is how a green build is released without rebuilding it.  An org is its name: the values DIRECTORY, the destination NAMESPACE and the AppProject FENCE are all `<org>`, and the image is `<registry>/<org>/<app>`. None of them is a request field — the directory decides what CD admits the sync under and the repository decides what the cluster pulls, so a caller who could name either could reach outside its own org.  `org` is an ACT-AS, not a placement field: it defaults to the caller's own, and naming another requires SuperAdmin. So does naming a RESERVED org — the platform's own namespace family (the brands and their environments, the control and delivery planes, `admin`) — even when it is the caller's own, because an IAM org named `kube-system` does not own Kubernetes. Both refuse rather than downgrade, so an escape attempt is never indistinguishable from a normal request.  A host outside the caller's org subtree is refused: claim and verify a custom domain first.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_platform_apps(opts = {})
+      post_platform_apps_with_http_info(opts)
+      nil
+    end
+
+    # Deploy an app through cd.hanzo.ai
+    # Builds a git repository into an image and writes the declaration that names it — a values file in &#x60;hanzoai/universe&#x60; under &#x60;charts/app/values/&lt;namespace&gt;/&lt;name&gt;.yaml&#x60;, which the &#x60;fleet&#x60; ApplicationSet renders as one Application. That file IS the deployment: nothing else has to be applied.  &#x60;mode&#x60; decides whether anything can go live. The default, &#x60;branch&#x60;, pushes to &#x60;deploy/&lt;namespace&gt;/&lt;name&gt;/&lt;tag&gt;&#x60; and returns a review URL; the generator reads main, so a branch declaration deploys NOTHING and merging the review is the deliberate act. &#x60;commit&#x60; writes main, and proves the image is pullable first — a declaration naming an image the registry cannot serve is an ImagePullBackOff with no rollback path.  Omit &#x60;tag&#x60; to build; give it to declare an image an earlier call already built, which is how a green build is released without rebuilding it.  An org is its name: the values DIRECTORY, the destination NAMESPACE and the AppProject FENCE are all &#x60;&lt;org&gt;&#x60;, and the image is &#x60;&lt;registry&gt;/&lt;org&gt;/&lt;app&gt;&#x60;. None of them is a request field — the directory decides what CD admits the sync under and the repository decides what the cluster pulls, so a caller who could name either could reach outside its own org.  &#x60;org&#x60; is an ACT-AS, not a placement field: it defaults to the caller&#39;s own, and naming another requires SuperAdmin. So does naming a RESERVED org — the platform&#39;s own namespace family (the brands and their environments, the control and delivery planes, &#x60;admin&#x60;) — even when it is the caller&#39;s own, because an IAM org named &#x60;kube-system&#x60; does not own Kubernetes. Both refuse rather than downgrade, so an escape attempt is never indistinguishable from a normal request.  A host outside the caller&#39;s org subtree is refused: claim and verify a custom domain first.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_platform_apps_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_apps ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/apps'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_apps",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Rolls a platform service's pods, in a named environment.
+    # Rolls a platform service's pods, in a named environment.  It triggers a rolling restart of one platform service's Deployment by stamping a fresh restart annotation, and answers 202 with the app, the namespace, the environment and the timestamp. It restarts pods; it does NOT change the image — a version change is the release path, not this.  SuperAdmin ONLY, and deliberately narrower than the read gate beside it. The only namespaces this board touches are the platform's own tier, so a restart here recycles a SHARED service every tenant depends on. A brand-org admin is a customer-org admin, not a platform operator: observing the board is bounded and audited, and restarting production identity is not.  `?env=main|test|dev` is REQUIRED — a bare call does not default to production, which is what closes the fat-finger and confused-deputy hazard — and any other value is 400. A service with no Deployment to restart in that environment is 404.
+    # @param app [String] App is the service&#39;s CR name, from the path. It must be a DNS-1123 label.
+    # @param restart_ref [RestartRef] 
+    # @param [Hash] opts the optional parameters
+    # @return [Restarted]
+    def post_platform_fleet_by_app_deploy(app, restart_ref, opts = {})
+      data, _status_code, _headers = post_platform_fleet_by_app_deploy_with_http_info(app, restart_ref, opts)
+      data
+    end
+
+    # Rolls a platform service&#39;s pods, in a named environment.
+    # Rolls a platform service&#39;s pods, in a named environment.  It triggers a rolling restart of one platform service&#39;s Deployment by stamping a fresh restart annotation, and answers 202 with the app, the namespace, the environment and the timestamp. It restarts pods; it does NOT change the image — a version change is the release path, not this.  SuperAdmin ONLY, and deliberately narrower than the read gate beside it. The only namespaces this board touches are the platform&#39;s own tier, so a restart here recycles a SHARED service every tenant depends on. A brand-org admin is a customer-org admin, not a platform operator: observing the board is bounded and audited, and restarting production identity is not.  &#x60;?env&#x3D;main|test|dev&#x60; is REQUIRED — a bare call does not default to production, which is what closes the fat-finger and confused-deputy hazard — and any other value is 400. A service with no Deployment to restart in that environment is 404.
+    # @param app [String] App is the service&#39;s CR name, from the path. It must be a DNS-1123 label.
+    # @param restart_ref [RestartRef] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Restarted, Integer, Hash)>] Restarted data, response status code and response headers
+    def post_platform_fleet_by_app_deploy_with_http_info(app, restart_ref, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_fleet_by_app_deploy ...'
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_fleet_by_app_deploy"
+      end
+      # verify the required parameter 'restart_ref' is set
+      if @api_client.config.client_side_validation && restart_ref.nil?
+        fail ArgumentError, "Missing the required parameter 'restart_ref' when calling PlatformApi.post_platform_fleet_by_app_deploy"
+      end
+      # resource path
+      local_var_path = '/v1/platform/fleet/{app}/deploy'.sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(restart_ref)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Restarted'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_fleet_by_app_deploy",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_fleet_by_app_deploy\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Receive a push from the forge and trigger its build
+    # The forge's push-to-deploy endpoint. git.hanzo.ai runs as a separate server, so its pushes never reach this fleet's own receive-pack; without this a push to the host we call canonical builds nothing. A verified push is handed to the SAME two clients a native push travels — the single-registrant deploy trigger, and the many-subscriber lifecycle stream that notifies and indexes — and the build decision itself stays downstream in the one place that knows what a push means.  PUBLIC at the JWT layer, because the forge carries no Hanzo session: AUTHENTICATION IS THE SIGNATURE. The HMAC covers the raw bytes and is verified BEFORE the payload is parsed, so an unauthenticated body is never decoded. The secret is read from KMS; a deployment that cannot read it answers 503 and processes nothing, rather than trusting a delivery it could not check. The body is read UNCOMPRESSED — a request declaring a Content-Encoding is refused 415 before it is touched, because decoding one is unbounded work bought with a few bytes and no credential. A bad signature is 401, a payload over 8 MiB is 413, and a malformed one 400.  A verified push that reaches both clients answers 200 with fired true and the NUMBER OF BUILDS it launched — zero is ordinary, since most pushes track no application, and it is the answer 'fired' cannot give. A push that could not be dispatched answers 500: the delivery page shows it red, and the Replay that prompts reaches a fresh attempt rather than being declined as already landed.  The deliveries deliberately ignored answer 200 with a reason and nothing else: a payload that is not a push, a ref DELETE (a zero `after` has no commit to build), a BOT-authored push (release automation pushes as the forge's own Actions user, and a release must never rebuild itself), a push from a forge namespace that maps to no org, and a redelivery of a push already fired. Branches and tags both reach the build trigger, because releases are cut by tag and filtering here would silently stop publishing.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Push] :push 
+    # @return [Verdict]
+    def post_platform_hook(opts = {})
+      data, _status_code, _headers = post_platform_hook_with_http_info(opts)
+      data
+    end
+
+    # Receive a push from the forge and trigger its build
+    # The forge&#39;s push-to-deploy endpoint. git.hanzo.ai runs as a separate server, so its pushes never reach this fleet&#39;s own receive-pack; without this a push to the host we call canonical builds nothing. A verified push is handed to the SAME two clients a native push travels — the single-registrant deploy trigger, and the many-subscriber lifecycle stream that notifies and indexes — and the build decision itself stays downstream in the one place that knows what a push means.  PUBLIC at the JWT layer, because the forge carries no Hanzo session: AUTHENTICATION IS THE SIGNATURE. The HMAC covers the raw bytes and is verified BEFORE the payload is parsed, so an unauthenticated body is never decoded. The secret is read from KMS; a deployment that cannot read it answers 503 and processes nothing, rather than trusting a delivery it could not check. The body is read UNCOMPRESSED — a request declaring a Content-Encoding is refused 415 before it is touched, because decoding one is unbounded work bought with a few bytes and no credential. A bad signature is 401, a payload over 8 MiB is 413, and a malformed one 400.  A verified push that reaches both clients answers 200 with fired true and the NUMBER OF BUILDS it launched — zero is ordinary, since most pushes track no application, and it is the answer &#39;fired&#39; cannot give. A push that could not be dispatched answers 500: the delivery page shows it red, and the Replay that prompts reaches a fresh attempt rather than being declined as already landed.  The deliveries deliberately ignored answer 200 with a reason and nothing else: a payload that is not a push, a ref DELETE (a zero &#x60;after&#x60; has no commit to build), a BOT-authored push (release automation pushes as the forge&#39;s own Actions user, and a release must never rebuild itself), a push from a forge namespace that maps to no org, and a redelivery of a push already fired. Branches and tags both reach the build trigger, because releases are cut by tag and filtering here would silently stop publishing.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Push] :push 
+    # @return [Array<(Verdict, Integer, Hash)>] Verdict data, response status code and response headers
+    def post_platform_hook_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_hook ...'
+      end
+      # resource path
+      local_var_path = '/v1/platform/hook'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'push'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Verdict'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_hook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_hook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Creates an application from a git repo or a container image.
+    # Creates an application from a git repo or a container image.  It registers a new application under one of the caller org's projects and answers 201 with it. Creating does NOT deploy: the app lands in `draft` and nothing reaches the cluster until /deploy.  `source` is `git` — which requires `repo.url` — or `image`, which requires `image.repository`; anything else is 400. A git app builds with zero-config `pack` by default and may opt into `dockerfile`; an image app never builds. The repo URL and Dockerfile path are validated here against the SAME allowlist the privileged build enforces, so an unsafe source is refused before it is ever persisted.  The `slug` is the app's identity in the cluster: given or derived from `name`, it must match `^[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$`, and a slug already used in this project is 409. `replicas` and `storageGb` are clamped to the deployment's limits rather than refused.  Env keys must match `^[A-Za-z_][A-Za-z0-9_]*$`. A variable marked `secret: true` is SEALED into KMS and its plaintext is never written to the database — and if KMS is unavailable the create fails 503 rather than falling back to storing a secret in the clear.  The app is seeded with its canonical default host, so it has a working HTTPS URL the moment it deploys. A bare custom domain cannot be attached here — it has to go through add-domain and DNS verification first. Requires a validated principal; 403 without one, and every cluster object it will later create lands in that org's own `tenant-<org>` namespace.
+    # @param project [String] Project is the project to create the application under, from the path.
+    # @param create_app_req [CreateAppReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [AppView]
+    def post_platform_projects_by_project_apps(project, create_app_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_with_http_info(project, create_app_req, opts)
+      data
+    end
+
+    # Creates an application from a git repo or a container image.
+    # Creates an application from a git repo or a container image.  It registers a new application under one of the caller org&#39;s projects and answers 201 with it. Creating does NOT deploy: the app lands in &#x60;draft&#x60; and nothing reaches the cluster until /deploy.  &#x60;source&#x60; is &#x60;git&#x60; — which requires &#x60;repo.url&#x60; — or &#x60;image&#x60;, which requires &#x60;image.repository&#x60;; anything else is 400. A git app builds with zero-config &#x60;pack&#x60; by default and may opt into &#x60;dockerfile&#x60;; an image app never builds. The repo URL and Dockerfile path are validated here against the SAME allowlist the privileged build enforces, so an unsafe source is refused before it is ever persisted.  The &#x60;slug&#x60; is the app&#39;s identity in the cluster: given or derived from &#x60;name&#x60;, it must match &#x60;^[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$&#x60;, and a slug already used in this project is 409. &#x60;replicas&#x60; and &#x60;storageGb&#x60; are clamped to the deployment&#39;s limits rather than refused.  Env keys must match &#x60;^[A-Za-z_][A-Za-z0-9_]*$&#x60;. A variable marked &#x60;secret: true&#x60; is SEALED into KMS and its plaintext is never written to the database — and if KMS is unavailable the create fails 503 rather than falling back to storing a secret in the clear.  The app is seeded with its canonical default host, so it has a working HTTPS URL the moment it deploys. A bare custom domain cannot be attached here — it has to go through add-domain and DNS verification first. Requires a validated principal; 403 without one, and every cluster object it will later create lands in that org&#39;s own &#x60;tenant-&lt;org&gt;&#x60; namespace.
+    # @param project [String] Project is the project to create the application under, from the path.
+    # @param create_app_req [CreateAppReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def post_platform_projects_by_project_apps_with_http_info(project, create_app_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps"
+      end
+      # verify the required parameter 'create_app_req' is set
+      if @api_client.config.client_side_validation && create_app_req.nil?
+        fail ArgumentError, "Missing the required parameter 'create_app_req' when calling PlatformApi.post_platform_projects_by_project_apps"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps'.sub('{' + 'project' + '}', CGI.escape(project.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_app_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deploys the app — building it first if it comes from git.
+    # Deploys the app — building it first if it comes from git.  It starts a new, monotonically versioned deployment of the app and answers 202 with the deployment record. A 202 is an ACCEPTED deployment, not a live one.  An IMAGE app deploys the tag you name (falling back to the app's tag, then `latest`) by writing its operator Service CR; the operator reconciles it to running. A GIT app launches an in-cluster BuildKit Job at `commit` — or the app's branch — and comes back in `building`; the Service CR is applied later, by the reconciler, once the Job succeeds. The reconciler is restart-safe, so a build in flight survives a cloud restart.  Deploys are bounded per org: over the concurrent-deploy cap is 429 and NOTHING is recorded, so a rejected deploy leaves no phantom in the history. An unreachable cluster is 503 but still records an honest `error` deployment, because a deploy that was attempted and failed must not be indistinguishable from one never made. Every other failure is likewise recorded in its real terminal state.  This is metered work: a git build is billed to the org's ledger in wall-clock build minutes once the Job finishes, and the running deployment is billed for its compute per tick for as long as it stays live. Requires a validated principal; 403 without one, and everything is written into that org's own `tenant-<org>` namespace.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param deploy_req [DeployReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [DeploymentView]
+    def post_platform_projects_by_project_apps_by_app_deploy(project, app, deploy_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_deploy_with_http_info(project, app, deploy_req, opts)
+      data
+    end
+
+    # Deploys the app — building it first if it comes from git.
+    # Deploys the app — building it first if it comes from git.  It starts a new, monotonically versioned deployment of the app and answers 202 with the deployment record. A 202 is an ACCEPTED deployment, not a live one.  An IMAGE app deploys the tag you name (falling back to the app&#39;s tag, then &#x60;latest&#x60;) by writing its operator Service CR; the operator reconciles it to running. A GIT app launches an in-cluster BuildKit Job at &#x60;commit&#x60; — or the app&#39;s branch — and comes back in &#x60;building&#x60;; the Service CR is applied later, by the reconciler, once the Job succeeds. The reconciler is restart-safe, so a build in flight survives a cloud restart.  Deploys are bounded per org: over the concurrent-deploy cap is 429 and NOTHING is recorded, so a rejected deploy leaves no phantom in the history. An unreachable cluster is 503 but still records an honest &#x60;error&#x60; deployment, because a deploy that was attempted and failed must not be indistinguishable from one never made. Every other failure is likewise recorded in its real terminal state.  This is metered work: a git build is billed to the org&#39;s ledger in wall-clock build minutes once the Job finishes, and the running deployment is billed for its compute per tick for as long as it stays live. Requires a validated principal; 403 without one, and everything is written into that org&#39;s own &#x60;tenant-&lt;org&gt;&#x60; namespace.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param deploy_req [DeployReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeploymentView, Integer, Hash)>] DeploymentView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_deploy_with_http_info(project, app, deploy_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_deploy ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_deploy"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_deploy"
+      end
+      # verify the required parameter 'deploy_req' is set
+      if @api_client.config.client_side_validation && deploy_req.nil?
+        fail ArgumentError, "Missing the required parameter 'deploy_req' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_deploy"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/deploy'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(deploy_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeploymentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_deploy",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_deploy\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Attaches a hostname — instantly if you already own it, otherwise with a DNS challenge.
+    # Attaches a hostname — instantly if you already own it, otherwise with a DNS challenge.  It attaches `host` to the app, and which of two things happens depends on who owns the name. A host inside the caller org's own subtree is structurally owned, so it goes ACTIVE immediately and answers 201. A bring-your-own host is claimed as PENDING and answers the DNS challenge records to publish; it is NOT rendered into the app's ingress until /verify passes.  Claims are globally unique. A host already claimed by another organization is 409, and so is one claimed by a different app in your own; re-adding this app's OWN claim is idempotent and answers its current state at 200. The default host is always attached and re-adding it is 409. A host under the platform's shared apex that is not the caller's own subtree is 403 — it belongs to whoever owns that subtree and can never be grabbed through the custom path.  `host` must be a valid DNS hostname; anything else is 400. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param add_domain_req [AddDomainReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [DomainView]
+    def post_platform_projects_by_project_apps_by_app_domains(project, app, add_domain_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_domains_with_http_info(project, app, add_domain_req, opts)
+      data
+    end
+
+    # Attaches a hostname — instantly if you already own it, otherwise with a DNS challenge.
+    # Attaches a hostname — instantly if you already own it, otherwise with a DNS challenge.  It attaches &#x60;host&#x60; to the app, and which of two things happens depends on who owns the name. A host inside the caller org&#39;s own subtree is structurally owned, so it goes ACTIVE immediately and answers 201. A bring-your-own host is claimed as PENDING and answers the DNS challenge records to publish; it is NOT rendered into the app&#39;s ingress until /verify passes.  Claims are globally unique. A host already claimed by another organization is 409, and so is one claimed by a different app in your own; re-adding this app&#39;s OWN claim is idempotent and answers its current state at 200. The default host is always attached and re-adding it is 409. A host under the platform&#39;s shared apex that is not the caller&#39;s own subtree is 403 — it belongs to whoever owns that subtree and can never be grabbed through the custom path.  &#x60;host&#x60; must be a valid DNS hostname; anything else is 400. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param add_domain_req [AddDomainReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DomainView, Integer, Hash)>] DomainView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_domains_with_http_info(project, app, add_domain_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_domains ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains"
+      end
+      # verify the required parameter 'add_domain_req' is set
+      if @api_client.config.client_side_validation && add_domain_req.nil?
+        fail ArgumentError, "Missing the required parameter 'add_domain_req' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/domains'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(add_domain_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DomainView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_domains",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_domains\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Checks a custom domain's DNS and turns it on if it passes.
+    # Checks a custom domain's DNS and turns it on if it passes.  It runs the DNS challenge check for a pending custom host and, when it passes, marks the host verified and renders it into the app's ingress so it starts serving.  A check that RAN and did not pass is not an error: it answers 200 with the host still pending and the reason in `detail`, so a console can show the operator what DNS is actually returning. An already-verified host answers as-is without re-checking. A host not claimed by this app is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param host [String] Host is the hostname, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [DomainView]
+    def post_platform_projects_by_project_apps_by_app_domains_by_host_verify(project, app, host, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_domains_by_host_verify_with_http_info(project, app, host, opts)
+      data
+    end
+
+    # Checks a custom domain&#39;s DNS and turns it on if it passes.
+    # Checks a custom domain&#39;s DNS and turns it on if it passes.  It runs the DNS challenge check for a pending custom host and, when it passes, marks the host verified and renders it into the app&#39;s ingress so it starts serving.  A check that RAN and did not pass is not an error: it answers 200 with the host still pending and the reason in &#x60;detail&#x60;, so a console can show the operator what DNS is actually returning. An already-verified host answers as-is without re-checking. A host not claimed by this app is 404. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param host [String] Host is the hostname, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DomainView, Integer, Hash)>] DomainView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_domains_by_host_verify_with_http_info(project, app, host, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_domains_by_host_verify ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains_by_host_verify"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains_by_host_verify"
+      end
+      # verify the required parameter 'host' is set
+      if @api_client.config.client_side_validation && host.nil?
+        fail ArgumentError, "Missing the required parameter 'host' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_domains_by_host_verify"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/domains/{host}/verify'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s)).sub('{' + 'host' + '}', CGI.escape(host.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DomainView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_domains_by_host_verify",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_domains_by_host_verify\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Puts a branch on its own URL.
+    # Puts a branch on its own URL.  It deploys an already-built `image` to a per-branch preview and answers its URL, the branch, the preview's slug and the deployment. The preview is a FIRST-CLASS application named `<app>-<branch>` in the same project and tenant namespace, with its own default host — so it is completely isolated from production while reusing the same deploy mechanic. Re-previewing a branch converges that same target in place rather than stacking another one.  It carries NO environment variables, deliberately: a preview never inherits production's secrets. It also does not build — `image` is required and must already exist, and `branch` defaults to the parent app's. A branch that does not resolve to a valid slug distinct from the parent's is 400. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the parent application lives under, from the path.
+    # @param app [String] App is the parent application&#39;s slug, from the path.
+    # @param preview_req [PreviewReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [PreviewView]
+    def post_platform_projects_by_project_apps_by_app_preview(project, app, preview_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_preview_with_http_info(project, app, preview_req, opts)
+      data
+    end
+
+    # Puts a branch on its own URL.
+    # Puts a branch on its own URL.  It deploys an already-built &#x60;image&#x60; to a per-branch preview and answers its URL, the branch, the preview&#39;s slug and the deployment. The preview is a FIRST-CLASS application named &#x60;&lt;app&gt;-&lt;branch&gt;&#x60; in the same project and tenant namespace, with its own default host — so it is completely isolated from production while reusing the same deploy mechanic. Re-previewing a branch converges that same target in place rather than stacking another one.  It carries NO environment variables, deliberately: a preview never inherits production&#39;s secrets. It also does not build — &#x60;image&#x60; is required and must already exist, and &#x60;branch&#x60; defaults to the parent app&#39;s. A branch that does not resolve to a valid slug distinct from the parent&#39;s is 400. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the parent application lives under, from the path.
+    # @param app [String] App is the parent application&#39;s slug, from the path.
+    # @param preview_req [PreviewReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PreviewView, Integer, Hash)>] PreviewView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_preview_with_http_info(project, app, preview_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_preview ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_preview"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_preview"
+      end
+      # verify the required parameter 'preview_req' is set
+      if @api_client.config.client_side_validation && preview_req.nil?
+        fail ArgumentError, "Missing the required parameter 'preview_req' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_preview"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/preview'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(preview_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PreviewView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_preview",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_preview\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Promotes an already-built release to the app.
+    # Promotes an already-built release to the app.  It redeploys an image that already exists — named either by `deploymentId`, which promotes that deployment's exact built image, or by `tag`, resolved the same way a deploy resolves one. One of the two is required; neither is 400.  Promotion never builds. A deployment that carries no built image cannot be promoted and is 400, and a deployment id outside this app is 404. It runs through the same deploy core as everything else, so it takes a NEW version number and is subject to the same per-org concurrency cap. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param promote_req [PromoteReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [DeploymentView]
+    def post_platform_projects_by_project_apps_by_app_promote(project, app, promote_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_promote_with_http_info(project, app, promote_req, opts)
+      data
+    end
+
+    # Promotes an already-built release to the app.
+    # Promotes an already-built release to the app.  It redeploys an image that already exists — named either by &#x60;deploymentId&#x60;, which promotes that deployment&#39;s exact built image, or by &#x60;tag&#x60;, resolved the same way a deploy resolves one. One of the two is required; neither is 400.  Promotion never builds. A deployment that carries no built image cannot be promoted and is 400, and a deployment id outside this app is 404. It runs through the same deploy core as everything else, so it takes a NEW version number and is subject to the same per-org concurrency cap. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param promote_req [PromoteReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeploymentView, Integer, Hash)>] DeploymentView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_promote_with_http_info(project, app, promote_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_promote ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_promote"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_promote"
+      end
+      # verify the required parameter 'promote_req' is set
+      if @api_client.config.client_side_validation && promote_req.nil?
+        fail ArgumentError, "Missing the required parameter 'promote_req' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_promote"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/promote'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(promote_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeploymentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_promote",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_promote\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Goes back to the previous release.
+    # Goes back to the previous release.  It redeploys a prior image: the one named by `deploymentId`, or — with no body — the newest earlier deployment that carries a real built image and did not error, skipping the release currently live. An app with nothing earlier to return to is 400.  A rollback is a deploy of an old image, not a rewind: it takes a NEW version number and appends to the history rather than erasing what came after. Both lookups are scoped to this app and org, so another tenant's image can never be rolled in. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param rollback_req [RollbackReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [DeploymentView]
+    def post_platform_projects_by_project_apps_by_app_rollback(project, app, rollback_req, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_rollback_with_http_info(project, app, rollback_req, opts)
+      data
+    end
+
+    # Goes back to the previous release.
+    # Goes back to the previous release.  It redeploys a prior image: the one named by &#x60;deploymentId&#x60;, or — with no body — the newest earlier deployment that carries a real built image and did not error, skipping the release currently live. An app with nothing earlier to return to is 400.  A rollback is a deploy of an old image, not a rewind: it takes a NEW version number and appends to the history rather than erasing what came after. Both lookups are scoped to this app and org, so another tenant&#39;s image can never be rolled in. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param rollback_req [RollbackReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeploymentView, Integer, Hash)>] DeploymentView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_rollback_with_http_info(project, app, rollback_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_rollback ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_rollback"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_rollback"
+      end
+      # verify the required parameter 'rollback_req' is set
+      if @api_client.config.client_side_validation && rollback_req.nil?
+        fail ArgumentError, "Missing the required parameter 'rollback_req' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_rollback"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/rollback'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(rollback_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeploymentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_rollback",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_rollback\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Starts a stopped app back up.
+    # Starts a stopped app back up.  It scales the app's Service back to its configured replica count and marks it live, answering the updated application. It does not redeploy: the image already on the Service CR is what comes back.  The billing watermark is reset to now as part of starting, so the org is charged for THIS live span and never for the gap the app spent stopped. An app with no Service CR is 404, an unreachable cluster is 503, and a cluster that refuses the scale is 502. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [AppView]
+    def post_platform_projects_by_project_apps_by_app_start(project, app, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_start_with_http_info(project, app, opts)
+      data
+    end
+
+    # Starts a stopped app back up.
+    # Starts a stopped app back up.  It scales the app&#39;s Service back to its configured replica count and marks it live, answering the updated application. It does not redeploy: the image already on the Service CR is what comes back.  The billing watermark is reset to now as part of starting, so the org is charged for THIS live span and never for the gap the app spent stopped. An app with no Service CR is 404, an unreachable cluster is 503, and a cluster that refuses the scale is 502. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_start_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_start ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_start"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_start"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/start'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_start",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_start\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Stops an app without deleting it.
+    # Stops an app without deleting it.  It scales the app's Service to zero replicas and marks it stopped, answering the updated application. Nothing else is removed — the record, its env, its domains and its deployment history all survive, and /start brings it back at the same replica count.  An app that is not deployed has no Service CR to scale and is 404. An unreachable cluster is 503 and a cluster that refuses the scale is 502. Because the pods stop, so does the compute metering. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [AppView]
+    def post_platform_projects_by_project_apps_by_app_stop(project, app, opts = {})
+      data, _status_code, _headers = post_platform_projects_by_project_apps_by_app_stop_with_http_info(project, app, opts)
+      data
+    end
+
+    # Stops an app without deleting it.
+    # Stops an app without deleting it.  It scales the app&#39;s Service to zero replicas and marks it stopped, answering the updated application. Nothing else is removed — the record, its env, its domains and its deployment history all survive, and /start brings it back at the same replica count.  An app that is not deployed has no Service CR to scale and is 404. An unreachable cluster is 503 and a cluster that refuses the scale is 502. Because the pods stop, so does the compute metering. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def post_platform_projects_by_project_apps_by_app_stop_with_http_info(project, app, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_projects_by_project_apps_by_app_stop ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_stop"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.post_platform_projects_by_project_apps_by_app_stop"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/stop'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_projects_by_project_apps_by_app_stop",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_projects_by_project_apps_by_app_stop\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Runs a container image and gives back a URL.
+    # Runs a container image and gives back a URL.  The one-call shortcut over project → app → deploy: give it a `name` and an `image` and it creates or updates an image-source application in your org's DEFAULT project, deploys it through the same operator Service-CR writer everything else uses, and answers its id, name, live URL, status and shape. Re-running the same name UPDATES it in place, so the call is idempotent by name.  What it produces is a first-class application, not a special object: it is listable, stoppable and redeployable through the /v1/platform routes like any other app.  `minScale` is the replica floor. `maxScale` above it declares an autoscaling ceiling; `maxScale: 0` means no autoscaler at all — a fixed run at the floor. Both are clamped to the deployment's limits. `runtime` and `shape` are accepted for the client contract and echoed back: the image is the runtime unit and sizing is the operator's default.  It is BILLING-GATED before it touches the cluster: a flat per-run fee is authorized against the org's own prepaid balance first, so an org that cannot pay is refused without anything being created. An unreachable cluster is 503 — a run never reports a URL it did not create. Secret env is sealed into KMS and fails closed without it.  Requires a validated principal; 403 without one. The org is resolved from that validated identity and is what both pays and owns the namespace — it is never read from the body.
+    # @param run_req [RunReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [RunView]
+    def post_platform_run(run_req, opts = {})
+      data, _status_code, _headers = post_platform_run_with_http_info(run_req, opts)
+      data
+    end
+
+    # Runs a container image and gives back a URL.
+    # Runs a container image and gives back a URL.  The one-call shortcut over project → app → deploy: give it a &#x60;name&#x60; and an &#x60;image&#x60; and it creates or updates an image-source application in your org&#39;s DEFAULT project, deploys it through the same operator Service-CR writer everything else uses, and answers its id, name, live URL, status and shape. Re-running the same name UPDATES it in place, so the call is idempotent by name.  What it produces is a first-class application, not a special object: it is listable, stoppable and redeployable through the /v1/platform routes like any other app.  &#x60;minScale&#x60; is the replica floor. &#x60;maxScale&#x60; above it declares an autoscaling ceiling; &#x60;maxScale: 0&#x60; means no autoscaler at all — a fixed run at the floor. Both are clamped to the deployment&#39;s limits. &#x60;runtime&#x60; and &#x60;shape&#x60; are accepted for the client contract and echoed back: the image is the runtime unit and sizing is the operator&#39;s default.  It is BILLING-GATED before it touches the cluster: a flat per-run fee is authorized against the org&#39;s own prepaid balance first, so an org that cannot pay is refused without anything being created. An unreachable cluster is 503 — a run never reports a URL it did not create. Secret env is sealed into KMS and fails closed without it.  Requires a validated principal; 403 without one. The org is resolved from that validated identity and is what both pays and owns the namespace — it is never read from the body.
+    # @param run_req [RunReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RunView, Integer, Hash)>] RunView data, response status code and response headers
+    def post_platform_run_with_http_info(run_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_run ...'
+      end
+      # verify the required parameter 'run_req' is set
+      if @api_client.config.client_side_validation && run_req.nil?
+        fail ArgumentError, "Missing the required parameter 'run_req' when calling PlatformApi.post_platform_run"
+      end
+      # resource path
+      local_var_path = '/v1/platform/run'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(run_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RunView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_run",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_run\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Triggers a native build — an image, or the binaries a repo declares.
+    # Triggers a native build — an image, or the binaries a repo declares.  The fabric's own build trigger, and what `hanzo build` and git-push-to-deploy call. It answers 202 with the build job id: a queued build, not a pushed artifact.  Two lanes, and a build is exactly one of them. The IMAGE lane takes `repo` and the output `image` and launches a BuildKit Job that pushes it. The ARTIFACT lane takes `binaries` — the same recipe the repo's hanzo.yml declares — and publishes to object storage instead; it must carry no `image`, because a build produces binaries or an image, never both.  PRIVILEGED, and A BUILD BELONGS TO THE ORGANIZATION ITS CREDENTIAL NAMES. Two credentials, never a third:    - one that NAMES an organization — a person who administers it (the `hanzo     build` path, so one IAM login authorizes a build with no separate build     token), or that organization's own machine identity (the pipeline path). The     build is attributed to that org and confined to what it owns.   - the shared build-callback token, compared in constant time. It names NO     organization, which is both why the fabric's own release can publish across     brands with it and why anything that CAN name one is read first.  Both are bounded by the owned-registry allowlist. The org path is bounded again, by the org: the image's registry namespace must be one that organization owns, so it publishes into its own brand and can never overwrite another's through the shared push credential. The same confinement applies to the artifact lane's repo owner. There is no request field naming an organization — the attribution is read off the credential, so there is nothing for a caller to write it with.  The output image is parsed and validated as a single well-formed OCI ref before any authorization decision reads it, so a crafted ref cannot smuggle a build-exporter attribute past the check.
+    # @param runner_build_req [RunnerBuildReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [RunnerBuildResp]
+    def post_platform_runner(runner_build_req, opts = {})
+      data, _status_code, _headers = post_platform_runner_with_http_info(runner_build_req, opts)
+      data
+    end
+
+    # Triggers a native build — an image, or the binaries a repo declares.
+    # Triggers a native build — an image, or the binaries a repo declares.  The fabric&#39;s own build trigger, and what &#x60;hanzo build&#x60; and git-push-to-deploy call. It answers 202 with the build job id: a queued build, not a pushed artifact.  Two lanes, and a build is exactly one of them. The IMAGE lane takes &#x60;repo&#x60; and the output &#x60;image&#x60; and launches a BuildKit Job that pushes it. The ARTIFACT lane takes &#x60;binaries&#x60; — the same recipe the repo&#39;s hanzo.yml declares — and publishes to object storage instead; it must carry no &#x60;image&#x60;, because a build produces binaries or an image, never both.  PRIVILEGED, and A BUILD BELONGS TO THE ORGANIZATION ITS CREDENTIAL NAMES. Two credentials, never a third:    - one that NAMES an organization — a person who administers it (the &#x60;hanzo     build&#x60; path, so one IAM login authorizes a build with no separate build     token), or that organization&#39;s own machine identity (the pipeline path). The     build is attributed to that org and confined to what it owns.   - the shared build-callback token, compared in constant time. It names NO     organization, which is both why the fabric&#39;s own release can publish across     brands with it and why anything that CAN name one is read first.  Both are bounded by the owned-registry allowlist. The org path is bounded again, by the org: the image&#39;s registry namespace must be one that organization owns, so it publishes into its own brand and can never overwrite another&#39;s through the shared push credential. The same confinement applies to the artifact lane&#39;s repo owner. There is no request field naming an organization — the attribution is read off the credential, so there is nothing for a caller to write it with.  The output image is parsed and validated as a single well-formed OCI ref before any authorization decision reads it, so a crafted ref cannot smuggle a build-exporter attribute past the check.
+    # @param runner_build_req [RunnerBuildReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RunnerBuildResp, Integer, Hash)>] RunnerBuildResp data, response status code and response headers
+    def post_platform_runner_with_http_info(runner_build_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.post_platform_runner ...'
+      end
+      # verify the required parameter 'runner_build_req' is set
+      if @api_client.config.client_side_validation && runner_build_req.nil?
+        fail ArgumentError, "Missing the required parameter 'runner_build_req' when calling PlatformApi.post_platform_runner"
+      end
+      # resource path
+      local_var_path = '/v1/platform/runner'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(runner_build_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RunnerBuildResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.post_platform_runner",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#post_platform_runner\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replaces an app's environment variables.
+    # Replaces an app's environment variables.  It writes the app's whole environment set and answers the updated application. This is the one post-create write path for env, and it REPLACES rather than merges: a variable absent from the body is gone, and a secret dropped from the set leaves the app's Secret on its next deploy.  Keys must match `^[A-Za-z_][A-Za-z0-9_]*$`. A value marked `secret: true` is sealed into KMS and blanked in the database, so plaintext is never persisted — and the write fails 503 if KMS is unavailable rather than storing one in the clear.  The rule worth knowing: this does not restart anything. Once the app has been deployed the secret sync is re-declared immediately so the operator re-materialises the Secret, but RUNNING pods keep the environment they started with until their next deploy or restart. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param set_env_req [SetEnvReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [AppView]
+    def put_platform_projects_by_project_apps_by_app_env(project, app, set_env_req, opts = {})
+      data, _status_code, _headers = put_platform_projects_by_project_apps_by_app_env_with_http_info(project, app, set_env_req, opts)
+      data
+    end
+
+    # Replaces an app&#39;s environment variables.
+    # Replaces an app&#39;s environment variables.  It writes the app&#39;s whole environment set and answers the updated application. This is the one post-create write path for env, and it REPLACES rather than merges: a variable absent from the body is gone, and a secret dropped from the set leaves the app&#39;s Secret on its next deploy.  Keys must match &#x60;^[A-Za-z_][A-Za-z0-9_]*$&#x60;. A value marked &#x60;secret: true&#x60; is sealed into KMS and blanked in the database, so plaintext is never persisted — and the write fails 503 if KMS is unavailable rather than storing one in the clear.  The rule worth knowing: this does not restart anything. Once the app has been deployed the secret sync is re-declared immediately so the operator re-materialises the Secret, but RUNNING pods keep the environment they started with until their next deploy or restart. Requires a validated principal; 403 without one.
+    # @param project [String] Project is the project the application lives under, from the path.
+    # @param app [String] App is the application&#39;s slug, from the path.
+    # @param set_env_req [SetEnvReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AppView, Integer, Hash)>] AppView data, response status code and response headers
+    def put_platform_projects_by_project_apps_by_app_env_with_http_info(project, app, set_env_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PlatformApi.put_platform_projects_by_project_apps_by_app_env ...'
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling PlatformApi.put_platform_projects_by_project_apps_by_app_env"
+      end
+      # verify the required parameter 'app' is set
+      if @api_client.config.client_side_validation && app.nil?
+        fail ArgumentError, "Missing the required parameter 'app' when calling PlatformApi.put_platform_projects_by_project_apps_by_app_env"
+      end
+      # verify the required parameter 'set_env_req' is set
+      if @api_client.config.client_side_validation && set_env_req.nil?
+        fail ArgumentError, "Missing the required parameter 'set_env_req' when calling PlatformApi.put_platform_projects_by_project_apps_by_app_env"
+      end
+      # resource path
+      local_var_path = '/v1/platform/projects/{project}/apps/{app}/env'.sub('{' + 'project' + '}', CGI.escape(project.to_s)).sub('{' + 'app' + '}', CGI.escape(app.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(set_env_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AppView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"PlatformApi.put_platform_projects_by_project_apps_by_app_env",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PlatformApi#put_platform_projects_by_project_apps_by_app_env\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end