volcano-sdk 0.32.7 → 0.34.0

data/lib/volcano/generated/lib/volcano-generated/api/durable_functions_api.rb

@@ -1,7 +1,7 @@
 =begin
-#Volcano Hosting API
+#Volcano API
 
-#Public API for Volcano Hosting clients, SDKs, and CLI tooling (Port 8000).  This specification intentionally excludes first-party/internal APIs. See api/openapi-internal.yaml for non-public internal and Builder operations.
+#Public API for Volcano clients, SDKs, and CLI tooling (Port 8000).  This specification intentionally excludes first-party/internal APIs. See api/openapi-internal.yaml for non-public internal and Builder operations.
 
 The version of the OpenAPI document: 3.0.0
 Contact: support@volcano.dev
@@ -19,6 +19,82 @@ module Volcano::Generated
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Approve a durable approval
+    # Approves a pending approval. The workflow resumes with the decision.  Only a person can decide: use the dashboard or a platform token from `volcano login`. Project access tokens are refused with `403`.  Approving an approval that is already approved returns it unchanged. If the workflow cannot be reached right away, the decision still stands and Volcano keeps delivering it. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [DurableApprovalDecisionRequest] :durable_approval_decision_request 
+    # @return [DurableApproval]
+    def approve_durable_approval(id, approval_id, opts = {})
+      data, _status_code, _headers = approve_durable_approval_with_http_info(id, approval_id, opts)
+      data
+    end
+
+    # Approve a durable approval
+    # Approves a pending approval. The workflow resumes with the decision.  Only a person can decide: use the dashboard or a platform token from `volcano login`. Project access tokens are refused with `403`.  Approving an approval that is already approved returns it unchanged. If the workflow cannot be reached right away, the decision still stands and Volcano keeps delivering it. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [DurableApprovalDecisionRequest] :durable_approval_decision_request 
+    # @return [Array<(DurableApproval, Integer, Hash)>] DurableApproval data, response status code and response headers
+    def approve_durable_approval_with_http_info(id, approval_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.approve_durable_approval ...'
+      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 DurableFunctionsApi.approve_durable_approval"
+      end
+      # verify the required parameter 'approval_id' is set
+      if @api_client.config.client_side_validation && approval_id.nil?
+        fail ArgumentError, "Missing the required parameter 'approval_id' when calling DurableFunctionsApi.approve_durable_approval"
+      end
+      # resource path
+      local_var_path = '/projects/{id}/durable-approvals/{approvalId}/approve'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'approvalId' + '}', CGI.escape(approval_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']
+      # 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[:'durable_approval_decision_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DurableApproval'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.approve_durable_approval",
+        :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: DurableFunctionsApi#approve_durable_approval\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create or update a durable function
     # Upload a durable function source bundle. Creates the function on the first call for a name and redeploys it on every call after that, the same create-or-update contract `POST /projects/{id}/functions` has.  Volcano builds and deploys asynchronously. A deployment that starts immediately returns `status: provisioning`, then transitions to `active` or `failed`; a deployment that has to wait for a running one is exposed through `pending_deployment_id`. Existing executions keep running against the runtime they started on.  The `durable` configuration is derived from the project's plan rather than supplied here, and is fixed once the function exists. A name already held by a standard function is rejected with 409: a function cannot change kind. 
     # @param id [String] Project ID
@@ -27,7 +103,8 @@ module Volcano::Generated
     # @param runtime [String] Runtime environment. Required. Durable execution needs the durable authoring API, which ships for these runtimes only; any other runtime is rejected with 400 and the response names the ones that work. Note that a durable Python function needs a newer runtime than a standard one defaults to. &#x60;GET /functions/runtimes&#x60; reports &#x60;durable_capable&#x60; per runtime. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :handler The name of the function to invoke. Defaults to \\\&quot;handler\\\&quot; if not specified. (default to 'handler')
-    # @option opts [Boolean] :is_public Whether anon keys with &#x60;functions.invoke&#x60; may start an execution. Redeploying is the only way to change it, since the collection has no update endpoint; omit it to keep the current visibility, and a new function starts private.  The standard collection&#39;s synchronous invocation fields — &#x60;invocation_mode&#x60;, &#x60;http_auth_mode&#x60;, &#x60;openapi_spec&#x60; — configure a request path no durable route serves, and are rejected with 400 rather than ignored. 
+    # @option opts [FunctionVisibility] :visibility Who may start an execution. Redeploying is the only way to change it, since the collection has no update endpoint; omit it to keep the current visibility, and a new function starts &#x60;private&#x60;.  The standard collection&#39;s synchronous invocation fields — &#x60;invocation_mode&#x60;, &#x60;http_auth_mode&#x60;, &#x60;openapi_spec&#x60; — configure a request path no durable route serves, and are rejected with 400 rather than ignored. 
+    # @option opts [Boolean] :is_public Deprecated alias for &#x60;visibility&#x60;: &#x60;true&#x60; means &#x60;public&#x60; and &#x60;false&#x60; means &#x60;authenticated&#x60;. Sending both with different meanings returns 400. 
     # @option opts [String] :variable_scope Which project variables this function receives. &#x60;all&#x60; (the default) gives it every project variable; &#x60;scoped&#x60; gives it only the variables it selects. Omitting this leaves an existing function&#39;s scope unchanged. 
     # @option opts [String] :variables JSON-encoded array of project variable names this function requires, on top of the ones detected in its source. A declared name the project does not define is rejected with 400; a detected name it does not define is ignored. Only used when &#x60;variable_scope&#x60; is &#x60;scoped&#x60;. Omitting this leaves an existing function&#39;s declared names unchanged. 
     # @return [DurableFunction]
@@ -44,7 +121,8 @@ module Volcano::Generated
     # @param runtime [String] Runtime environment. Required. Durable execution needs the durable authoring API, which ships for these runtimes only; any other runtime is rejected with 400 and the response names the ones that work. Note that a durable Python function needs a newer runtime than a standard one defaults to. &#x60;GET /functions/runtimes&#x60; reports &#x60;durable_capable&#x60; per runtime. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :handler The name of the function to invoke. Defaults to \\\&quot;handler\\\&quot; if not specified. (default to 'handler')
-    # @option opts [Boolean] :is_public Whether anon keys with &#x60;functions.invoke&#x60; may start an execution. Redeploying is the only way to change it, since the collection has no update endpoint; omit it to keep the current visibility, and a new function starts private.  The standard collection&#39;s synchronous invocation fields — &#x60;invocation_mode&#x60;, &#x60;http_auth_mode&#x60;, &#x60;openapi_spec&#x60; — configure a request path no durable route serves, and are rejected with 400 rather than ignored. 
+    # @option opts [FunctionVisibility] :visibility Who may start an execution. Redeploying is the only way to change it, since the collection has no update endpoint; omit it to keep the current visibility, and a new function starts &#x60;private&#x60;.  The standard collection&#39;s synchronous invocation fields — &#x60;invocation_mode&#x60;, &#x60;http_auth_mode&#x60;, &#x60;openapi_spec&#x60; — configure a request path no durable route serves, and are rejected with 400 rather than ignored. 
+    # @option opts [Boolean] :is_public Deprecated alias for &#x60;visibility&#x60;: &#x60;true&#x60; means &#x60;public&#x60; and &#x60;false&#x60; means &#x60;authenticated&#x60;. Sending both with different meanings returns 400. 
     # @option opts [String] :variable_scope Which project variables this function receives. &#x60;all&#x60; (the default) gives it every project variable; &#x60;scoped&#x60; gives it only the variables it selects. Omitting this leaves an existing function&#39;s scope unchanged. 
     # @option opts [String] :variables JSON-encoded array of project variable names this function requires, on top of the ones detected in its source. A declared name the project does not define is rejected with 400; a detected name it does not define is ignored. Only used when &#x60;variable_scope&#x60; is &#x60;scoped&#x60;. Omitting this leaves an existing function&#39;s declared names unchanged. 
     # @return [Array<(DurableFunction, Integer, Hash)>] DurableFunction data, response status code and response headers
@@ -108,6 +186,7 @@ module Volcano::Generated
       form_params['code'] = code
       form_params['runtime'] = runtime
       form_params['handler'] = opts[:'handler'] if !opts[:'handler'].nil?
+      form_params['visibility'] = opts[:'visibility'] if !opts[:'visibility'].nil?
       form_params['is_public'] = opts[:'is_public'] if !opts[:'is_public'].nil?
       form_params['variable_scope'] = opts[:'variable_scope'] if !opts[:'variable_scope'].nil?
       form_params['variables'] = opts[:'variables'] if !opts[:'variables'].nil?
@@ -219,7 +298,7 @@ module Volcano::Generated
     end
 
     # Delete a durable function
-    # Accepted for asynchronous teardown; the work continues after the response. The function's executions go with it: history stops being readable whatever `retention_days` had left, and the executions still running stop counting against the project's concurrency cap. Stop an execution first if you need it to end before the function does. 
+    # Accepted for asynchronous teardown; the work continues after the response. The function's executions go with it: executions still in flight are stopped, and history stops being readable whatever `retention_days` had left.  Stopping is asynchronous at the platform, and it does not interrupt a step already running -- that step runs to its next checkpoint. So a delete ends an execution rather than halting it mid-step; stop the execution yourself first if you need to observe it ending. 
     # @param id [String] Project ID
     # @param function_id [String] Durable function ID, or its name within the project
     # @param [Hash] opts the optional parameters
@@ -230,7 +309,7 @@ module Volcano::Generated
     end
 
     # Delete a durable function
-    # Accepted for asynchronous teardown; the work continues after the response. The function&#39;s executions go with it: history stops being readable whatever &#x60;retention_days&#x60; had left, and the executions still running stop counting against the project&#39;s concurrency cap. Stop an execution first if you need it to end before the function does. 
+    # Accepted for asynchronous teardown; the work continues after the response. The function&#39;s executions go with it: executions still in flight are stopped, and history stops being readable whatever &#x60;retention_days&#x60; had left.  Stopping is asynchronous at the platform, and it does not interrupt a step already running -- that step runs to its next checkpoint. So a delete ends an execution rather than halting it mid-step; stop the execution yourself first if you need to observe it ending. 
     # @param id [String] Project ID
     # @param function_id [String] Durable function ID, or its name within the project
     # @param [Hash] opts the optional parameters
@@ -360,6 +439,231 @@ module Volcano::Generated
       return data, status_code, headers
     end
 
+    # Deny a durable approval
+    # Denies a pending approval. The workflow resumes with the decision; a denial is a value the workflow branches on, not an error.  Only a person can decide: use the dashboard or a platform token from `volcano login`. Project access tokens are refused with `403`.  Denying an approval that is already denied returns it unchanged. If the workflow cannot be reached right away, the decision still stands and Volcano keeps delivering it. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [DurableApprovalDecisionRequest] :durable_approval_decision_request 
+    # @return [DurableApproval]
+    def deny_durable_approval(id, approval_id, opts = {})
+      data, _status_code, _headers = deny_durable_approval_with_http_info(id, approval_id, opts)
+      data
+    end
+
+    # Deny a durable approval
+    # Denies a pending approval. The workflow resumes with the decision; a denial is a value the workflow branches on, not an error.  Only a person can decide: use the dashboard or a platform token from &#x60;volcano login&#x60;. Project access tokens are refused with &#x60;403&#x60;.  Denying an approval that is already denied returns it unchanged. If the workflow cannot be reached right away, the decision still stands and Volcano keeps delivering it. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [DurableApprovalDecisionRequest] :durable_approval_decision_request 
+    # @return [Array<(DurableApproval, Integer, Hash)>] DurableApproval data, response status code and response headers
+    def deny_durable_approval_with_http_info(id, approval_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.deny_durable_approval ...'
+      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 DurableFunctionsApi.deny_durable_approval"
+      end
+      # verify the required parameter 'approval_id' is set
+      if @api_client.config.client_side_validation && approval_id.nil?
+        fail ArgumentError, "Missing the required parameter 'approval_id' when calling DurableFunctionsApi.deny_durable_approval"
+      end
+      # resource path
+      local_var_path = '/projects/{id}/durable-approvals/{approvalId}/deny'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'approvalId' + '}', CGI.escape(approval_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']
+      # 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[:'durable_approval_decision_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DurableApproval'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.deny_durable_approval",
+        :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: DurableFunctionsApi#deny_durable_approval\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a durable approval
+    # Returns one approval: what the workflow asked, the durable function and execution that asked it, its deadline, and the decision once one is made.  Project access tokens can read approvals, including read-only ones. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @return [DurableApproval]
+    def get_durable_approval(id, approval_id, opts = {})
+      data, _status_code, _headers = get_durable_approval_with_http_info(id, approval_id, opts)
+      data
+    end
+
+    # Get a durable approval
+    # Returns one approval: what the workflow asked, the durable function and execution that asked it, its deadline, and the decision once one is made.  Project access tokens can read approvals, including read-only ones. 
+    # @param id [String] Project ID
+    # @param approval_id [String] Durable approval ID
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DurableApproval, Integer, Hash)>] DurableApproval data, response status code and response headers
+    def get_durable_approval_with_http_info(id, approval_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.get_durable_approval ...'
+      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 DurableFunctionsApi.get_durable_approval"
+      end
+      # verify the required parameter 'approval_id' is set
+      if @api_client.config.client_side_validation && approval_id.nil?
+        fail ArgumentError, "Missing the required parameter 'approval_id' when calling DurableFunctionsApi.get_durable_approval"
+      end
+      # resource path
+      local_var_path = '/projects/{id}/durable-approvals/{approvalId}'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'approvalId' + '}', CGI.escape(approval_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] || 'DurableApproval'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.get_durable_approval",
+        :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: DurableFunctionsApi#get_durable_approval\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get durable approval statistics
+    # Counts the project's approvals by outcome over a time window, overall, per workflow, and per day. The window defaults to the last 30 days and can cover up to a year. An approval is counted on the day it was requested.  Project access tokens can read statistics, including read-only ones. 
+    # @param id [String] Project ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :function Only approvals requested by this durable function, given by id or by name. A name also matches approvals from a deleted function of that name. 
+    # @option opts [Time] :from Start of the window. Defaults to 30 days before &#x60;to&#x60;.
+    # @option opts [Time] :to End of the window. Defaults to now.
+    # @return [DurableApprovalStats]
+    def get_durable_approval_stats(id, opts = {})
+      data, _status_code, _headers = get_durable_approval_stats_with_http_info(id, opts)
+      data
+    end
+
+    # Get durable approval statistics
+    # Counts the project&#39;s approvals by outcome over a time window, overall, per workflow, and per day. The window defaults to the last 30 days and can cover up to a year. An approval is counted on the day it was requested.  Project access tokens can read statistics, including read-only ones. 
+    # @param id [String] Project ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :function Only approvals requested by this durable function, given by id or by name. A name also matches approvals from a deleted function of that name. 
+    # @option opts [Time] :from Start of the window. Defaults to 30 days before &#x60;to&#x60;.
+    # @option opts [Time] :to End of the window. Defaults to now.
+    # @return [Array<(DurableApprovalStats, Integer, Hash)>] DurableApprovalStats data, response status code and response headers
+    def get_durable_approval_stats_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.get_durable_approval_stats ...'
+      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 DurableFunctionsApi.get_durable_approval_stats"
+      end
+      if @api_client.config.client_side_validation && !opts[:'function'].nil? && opts[:'function'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"function"]" when calling DurableFunctionsApi.get_durable_approval_stats, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'function'].nil? && opts[:'function'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"function"]" when calling DurableFunctionsApi.get_durable_approval_stats, the character length must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/projects/{id}/durable-approvals/stats'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'function'] = opts[:'function'] if !opts[:'function'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].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] || 'DurableApprovalStats'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.get_durable_approval_stats",
+        :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: DurableFunctionsApi#get_durable_approval_stats\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get a durable execution
     # Returns the execution's current state, including its `result` once it has succeeded. Poll this to wait for an execution to finish. 
     # @param id [String] Project ID
@@ -575,6 +879,185 @@ module Volcano::Generated
       return data, status_code, headers
     end
 
+    # List durable approvals
+    # Lists the approvals durable workflows in the project have requested, newest first. Pending approvals are the ones a workflow is waiting on; decided, expired, and cancelled ones are kept for a year.  Project access tokens can list approvals, including read-only ones. 
+    # @param id [String] Project ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (1-indexed) for offset pagination. Declares no schema default so the request validator does not inject one: handlers that omit &#x60;page&#x60; see it unset (nil) and default to 1 in code, while cursor-first endpoints (e.g. the project deployments feed) can detect its absence to stay in keyset/search mode. Supplying &#x60;page&#x60; selects offset pagination. 
+    # @option opts [Integer] :limit Number of items per page (max 100) (default to 10)
+    # @option opts [DurableApprovalStatus] :status Return only approvals in this status.
+    # @option opts [String] :function Only approvals requested by this durable function, given by id or by name. A name also matches approvals from a deleted function of that name. 
+    # @option opts [String] :execution_id Return only approvals requested by this durable execution.
+    # @option opts [Time] :from Return only approvals requested at or after this time.
+    # @option opts [Time] :to Return only approvals requested before this time.
+    # @return [PaginatedDurableApprovals]
+    def list_durable_approvals(id, opts = {})
+      data, _status_code, _headers = list_durable_approvals_with_http_info(id, opts)
+      data
+    end
+
+    # List durable approvals
+    # Lists the approvals durable workflows in the project have requested, newest first. Pending approvals are the ones a workflow is waiting on; decided, expired, and cancelled ones are kept for a year.  Project access tokens can list approvals, including read-only ones. 
+    # @param id [String] Project ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (1-indexed) for offset pagination. Declares no schema default so the request validator does not inject one: handlers that omit &#x60;page&#x60; see it unset (nil) and default to 1 in code, while cursor-first endpoints (e.g. the project deployments feed) can detect its absence to stay in keyset/search mode. Supplying &#x60;page&#x60; selects offset pagination. 
+    # @option opts [Integer] :limit Number of items per page (max 100) (default to 10)
+    # @option opts [DurableApprovalStatus] :status Return only approvals in this status.
+    # @option opts [String] :function Only approvals requested by this durable function, given by id or by name. A name also matches approvals from a deleted function of that name. 
+    # @option opts [String] :execution_id Return only approvals requested by this durable execution.
+    # @option opts [Time] :from Return only approvals requested at or after this time.
+    # @option opts [Time] :to Return only approvals requested before this time.
+    # @return [Array<(PaginatedDurableApprovals, Integer, Hash)>] PaginatedDurableApprovals data, response status code and response headers
+    def list_durable_approvals_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.list_durable_approvals ...'
+      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 DurableFunctionsApi.list_durable_approvals"
+      end
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling DurableFunctionsApi.list_durable_approvals, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling DurableFunctionsApi.list_durable_approvals, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling DurableFunctionsApi.list_durable_approvals, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'function'].nil? && opts[:'function'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"function"]" when calling DurableFunctionsApi.list_durable_approvals, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'function'].nil? && opts[:'function'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"function"]" when calling DurableFunctionsApi.list_durable_approvals, the character length must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/projects/{id}/durable-approvals'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'function'] = opts[:'function'] if !opts[:'function'].nil?
+      query_params[:'execution_id'] = opts[:'execution_id'] if !opts[:'execution_id'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].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] || 'PaginatedDurableApprovals'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.list_durable_approvals",
+        :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: DurableFunctionsApi#list_durable_approvals\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List a durable execution's operations
+    # Returns the execution's trace: every operation it began — each step, wait, poll, child context, map item and parallel branch — with when it started and ended, how it ended, and each attempt of a retried step. `invocations` are the windows the function's code was actually running; the gaps between them are time the execution spent suspended, which is not charged.  A finished execution's trace is final and `complete` is `true`. A running one is refreshed when it is read, and can be up to about ten seconds behind; `synced_at` says when it was last refreshed. Inputs, results and other payloads are never included.  The list is not paginated: an execution is limited to 3,000 operations, and a trace is read whole. 
+    # @param id [String] Project ID
+    # @param function_id [String] Durable function ID, or its name within the project
+    # @param execution_id [String] Durable execution ID
+    # @param [Hash] opts the optional parameters
+    # @return [DurableExecutionOperationList]
+    def list_durable_execution_operations(id, function_id, execution_id, opts = {})
+      data, _status_code, _headers = list_durable_execution_operations_with_http_info(id, function_id, execution_id, opts)
+      data
+    end
+
+    # List a durable execution&#39;s operations
+    # Returns the execution&#39;s trace: every operation it began — each step, wait, poll, child context, map item and parallel branch — with when it started and ended, how it ended, and each attempt of a retried step. &#x60;invocations&#x60; are the windows the function&#39;s code was actually running; the gaps between them are time the execution spent suspended, which is not charged.  A finished execution&#39;s trace is final and &#x60;complete&#x60; is &#x60;true&#x60;. A running one is refreshed when it is read, and can be up to about ten seconds behind; &#x60;synced_at&#x60; says when it was last refreshed. Inputs, results and other payloads are never included.  The list is not paginated: an execution is limited to 3,000 operations, and a trace is read whole. 
+    # @param id [String] Project ID
+    # @param function_id [String] Durable function ID, or its name within the project
+    # @param execution_id [String] Durable execution ID
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DurableExecutionOperationList, Integer, Hash)>] DurableExecutionOperationList data, response status code and response headers
+    def list_durable_execution_operations_with_http_info(id, function_id, execution_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.list_durable_execution_operations ...'
+      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 DurableFunctionsApi.list_durable_execution_operations"
+      end
+      # verify the required parameter 'function_id' is set
+      if @api_client.config.client_side_validation && function_id.nil?
+        fail ArgumentError, "Missing the required parameter 'function_id' when calling DurableFunctionsApi.list_durable_execution_operations"
+      end
+      # verify the required parameter 'execution_id' is set
+      if @api_client.config.client_side_validation && execution_id.nil?
+        fail ArgumentError, "Missing the required parameter 'execution_id' when calling DurableFunctionsApi.list_durable_execution_operations"
+      end
+      # resource path
+      local_var_path = '/projects/{id}/durable-functions/{functionId}/executions/{executionId}/operations'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'functionId' + '}', CGI.escape(function_id.to_s)).sub('{' + 'executionId' + '}', CGI.escape(execution_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] || 'DurableExecutionOperationList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['UserToken']
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.list_durable_execution_operations",
+        :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: DurableFunctionsApi#list_durable_execution_operations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List a durable function's executions
     # Returns the platform's last observed status for each execution; listing does not poll each one. Fetch a single execution for its live state. 
     # @param id [String] Project ID
@@ -907,6 +1390,74 @@ module Volcano::Generated
       return data, status_code, headers
     end
 
+    # Request an approval from inside a workflow
+    # Registers an approval request for a running durable execution. The Volcano SDK calls this from `ctx.waitForApproval`; applications do not call it directly.  `execution_ref` and `callback_id` are opaque values the SDK reads from the running workflow. Together they are the request's credential, so the operation takes no other authentication. The approval belongs to the project that owns the execution, and expires when the workflow's own approval timeout does.  Retrying is safe: a request for an approval that is already registered returns it with `200`. 
+    # @param request_durable_approval_request [RequestDurableApprovalRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [DurableApprovalRegistration]
+    def request_durable_approval(request_durable_approval_request, opts = {})
+      data, _status_code, _headers = request_durable_approval_with_http_info(request_durable_approval_request, opts)
+      data
+    end
+
+    # Request an approval from inside a workflow
+    # Registers an approval request for a running durable execution. The Volcano SDK calls this from &#x60;ctx.waitForApproval&#x60;; applications do not call it directly.  &#x60;execution_ref&#x60; and &#x60;callback_id&#x60; are opaque values the SDK reads from the running workflow. Together they are the request&#39;s credential, so the operation takes no other authentication. The approval belongs to the project that owns the execution, and expires when the workflow&#39;s own approval timeout does.  Retrying is safe: a request for an approval that is already registered returns it with &#x60;200&#x60;. 
+    # @param request_durable_approval_request [RequestDurableApprovalRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DurableApprovalRegistration, Integer, Hash)>] DurableApprovalRegistration data, response status code and response headers
+    def request_durable_approval_with_http_info(request_durable_approval_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DurableFunctionsApi.request_durable_approval ...'
+      end
+      # verify the required parameter 'request_durable_approval_request' is set
+      if @api_client.config.client_side_validation && request_durable_approval_request.nil?
+        fail ArgumentError, "Missing the required parameter 'request_durable_approval_request' when calling DurableFunctionsApi.request_durable_approval"
+      end
+      # resource path
+      local_var_path = '/durable-approvals'
+
+      # 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(request_durable_approval_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DurableApprovalRegistration'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"DurableFunctionsApi.request_durable_approval",
+        :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: DurableFunctionsApi#request_durable_approval\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Start a durable execution
     # Starts an execution and returns its handle. Never returns a result: an execution can outlive any request a client could hold open, so the result is read back from `GET /projects/{id}/durable-functions/{functionId}/executions/{executionId}`.  The request body is the execution's input and must be valid JSON if present. An empty body starts the execution with no input.  Send `X-Volcano-Execution-Name` to make the start idempotent: repeating a start with the same name returns the existing execution instead of beginning a second one.  Each execution counts against the project's durable execution allowance, the operations it performs count against the durable operations allowance when it finishes, and the number of executions in flight at once is capped by the plan. 
     # @param id [String] Project ID
@@ -996,7 +1547,7 @@ module Volcano::Generated
     end
 
     # Start a durable execution from an application
-    # Starts an execution of a durable function using an application credential, and returns its handle.  This is the durable counterpart of `POST /functions/{functionId}/invoke`, and it is the endpoint an application calls. Like that one, it is not project-scoped: an anon key, a service key and an auth user token each carry their own project. The project-scoped collection under `/projects/{id}/durable-functions/...` remains the owner's management surface.  **With a service key or an auth user token:** any durable function in the project.  **With an anon key:** requires the `functions.invoke` permission, and the function must have `is_public: true`.  Starting is all this endpoint does. Reading a result or stopping an execution requires the project owner's token, because an anon key is shared by everyone who loads the page and an execution is addressed by id alone.  Send `X-Volcano-Execution-Name` to make the start idempotent: repeating a start with the same name returns the existing execution instead of beginning a second one.  Each execution counts once against the project's durable execution allowance, however many times the start is retried under the same execution name, and the number in flight at once is capped by the plan. The operations the execution performs are counted against the durable operations allowance when it finishes. 
+    # Starts an execution of a durable function using an application credential, and returns its handle.  This is the durable counterpart of `POST /functions/{functionId}/invoke`, and it is the endpoint an application calls. Like that one, it is not project-scoped: an anon key, a service key and an auth user token each carry their own project. The project-scoped collection under `/projects/{id}/durable-functions/...` remains the owner's management surface.  **With a service key:** any durable function in the project.  **With an auth user token:** a durable function whose `visibility` is `authenticated` or `public`.  **With an anon key:** requires the `functions.invoke` permission, and the function must have `visibility: public`.  A `private` durable function answers every credential but a service key exactly as a missing one, with 404.  Starting is all this endpoint does. Reading a result or stopping an execution requires the project owner's token, because an anon key is shared by everyone who loads the page and an execution is addressed by id alone.  Send `X-Volcano-Execution-Name` to make the start idempotent: repeating a start with the same name returns the existing execution instead of beginning a second one.  Each execution counts once against the project's durable execution allowance, however many times the start is retried under the same execution name, and the number in flight at once is capped by the plan. The operations the execution performs are counted against the durable operations allowance when it finishes. 
     # @param function_id [String] Durable function ID, or its name within the project
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_volcano_execution_name Idempotency key for this execution. Generated when omitted. A repeat under a name that already names a running execution returns that execution and is not charged again.  Letters, digits, &#x60;-&#x60;, &#x60;_&#x60; and &#x60;.&#x60;, up to 255 characters. Anything else is rejected with &#x60;400&#x60;. 
@@ -1008,7 +1559,7 @@ module Volcano::Generated
     end
 
     # Start a durable execution from an application
-    # Starts an execution of a durable function using an application credential, and returns its handle.  This is the durable counterpart of &#x60;POST /functions/{functionId}/invoke&#x60;, and it is the endpoint an application calls. Like that one, it is not project-scoped: an anon key, a service key and an auth user token each carry their own project. The project-scoped collection under &#x60;/projects/{id}/durable-functions/...&#x60; remains the owner&#39;s management surface.  **With a service key or an auth user token:** any durable function in the project.  **With an anon key:** requires the &#x60;functions.invoke&#x60; permission, and the function must have &#x60;is_public: true&#x60;.  Starting is all this endpoint does. Reading a result or stopping an execution requires the project owner&#39;s token, because an anon key is shared by everyone who loads the page and an execution is addressed by id alone.  Send &#x60;X-Volcano-Execution-Name&#x60; to make the start idempotent: repeating a start with the same name returns the existing execution instead of beginning a second one.  Each execution counts once against the project&#39;s durable execution allowance, however many times the start is retried under the same execution name, and the number in flight at once is capped by the plan. The operations the execution performs are counted against the durable operations allowance when it finishes. 
+    # Starts an execution of a durable function using an application credential, and returns its handle.  This is the durable counterpart of &#x60;POST /functions/{functionId}/invoke&#x60;, and it is the endpoint an application calls. Like that one, it is not project-scoped: an anon key, a service key and an auth user token each carry their own project. The project-scoped collection under &#x60;/projects/{id}/durable-functions/...&#x60; remains the owner&#39;s management surface.  **With a service key:** any durable function in the project.  **With an auth user token:** a durable function whose &#x60;visibility&#x60; is &#x60;authenticated&#x60; or &#x60;public&#x60;.  **With an anon key:** requires the &#x60;functions.invoke&#x60; permission, and the function must have &#x60;visibility: public&#x60;.  A &#x60;private&#x60; durable function answers every credential but a service key exactly as a missing one, with 404.  Starting is all this endpoint does. Reading a result or stopping an execution requires the project owner&#39;s token, because an anon key is shared by everyone who loads the page and an execution is addressed by id alone.  Send &#x60;X-Volcano-Execution-Name&#x60; to make the start idempotent: repeating a start with the same name returns the existing execution instead of beginning a second one.  Each execution counts once against the project&#39;s durable execution allowance, however many times the start is retried under the same execution name, and the number in flight at once is capped by the plan. The operations the execution performs are counted against the durable operations allowance when it finishes. 
     # @param function_id [String] Durable function ID, or its name within the project
     # @param [Hash] opts the optional parameters
     # @option opts [String] :x_volcano_execution_name Idempotency key for this execution. Generated when omitted. A repeat under a name that already names a running execution returns that execution and is not charged again.  Letters, digits, &#x60;-&#x60;, &#x60;_&#x60; and &#x60;.&#x60;, up to 255 characters. Anything else is rejected with &#x60;400&#x60;.