volcano-sdk 0.32.7 → 0.34.0

data/lib/volcano/durable_approvals.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module Volcano
+  # Lists, reads, and decides the approvals durable workflows request.
+  #
+  # Every operation takes the project id and the client's platform token.
+  # Reads also accept a project access token, including a read-only one.
+  # Deciding takes a person: a project access token is refused with
+  # Error::PermissionDeniedError.
+  class DurableApprovals
+    include DurableArguments
+    include DurableApprovalResponses
+    include DurableApprovalStatsResponses
+
+    # Bounds mirrored from the wire contract, for the reason DurableArguments gives.
+    MAX_FUNCTION_LENGTH = 255
+    MAX_COMMENT_LENGTH = 2000
+
+    def initialize(client, transport)
+      @client = client
+      @transport = transport
+    end
+
+    LIST_FILTERS = %i[status function execution_id from to page limit].freeze
+    private_constant :LIST_FILTERS
+
+    # Lists approvals, newest first, filtered by any of +status+, +function+,
+    # +execution_id+, +from+, +to+, +page+, and +limit+, given as keywords.
+    # +function+ is a durable function's id or name; a name also matches
+    # approvals from a deleted function of that name. +from+ is inclusive and
+    # +to+ exclusive, each a Time or an ISO 8601 string with an offset.
+    def list(project_id, filters = {})
+      project = identifier(project_id, 'project_id')
+      options = list_options(filters)
+      response = Transport.invoke do
+        @transport.list_durable_approvals(authorization: @client.session_token, project_id: project, options: options)
+      end
+      durable_approval_page(Transport.body(response, 200))
+    end
+
+    def get(project_id, approval_id)
+      project = identifier(project_id, 'project_id')
+      approval = identifier(approval_id, 'approval_id')
+      response = Transport.invoke do
+        @transport.get_durable_approval(
+          authorization: @client.session_token, project_id: project, approval_id: approval
+        )
+      end
+      durable_approval(Transport.body(response, 200))
+    end
+
+    # Counts approvals by outcome, overall, per workflow, and per UTC day of
+    # request. The window defaults to the 30 days before +to+, which defaults
+    # to now, and covers at most 366 days.
+    def stats(project_id, function: nil, from: nil, to: nil)
+      project = identifier(project_id, 'project_id')
+      options = window(function, from, to).compact
+      response = Transport.invoke do
+        @transport.get_durable_approval_stats(
+          authorization: @client.session_token, project_id: project, options: options
+        )
+      end
+      durable_approval_stats(Transport.body(response, 200))
+    end
+
+    # Approves a pending approval; the workflow resumes with the decision.
+    # Approving again returns the approval unchanged. Deciding one that was
+    # denied, has expired, or was cancelled raises Error::ConflictError, whose
+    # +code+ is +approval_decided+, +approval_expired+, or +approval_cancelled+.
+    def approve(project_id, approval_id, comment: nil)
+      decide(project_id, approval_id, comment) do |token, project, approval, note|
+        @transport.approve_durable_approval(
+          authorization: token, project_id: project, approval_id: approval, comment: note
+        )
+      end
+    end
+
+    # Denies a pending approval. A denial is a value the workflow branches on,
+    # not an error in it. Repeats and conflicts behave as for #approve.
+    def deny(project_id, approval_id, comment: nil)
+      decide(project_id, approval_id, comment) do |token, project, approval, note|
+        @transport.deny_durable_approval(
+          authorization: token, project_id: project, approval_id: approval, comment: note
+        )
+      end
+    end
+
+    private
+
+    def decide(project_id, approval_id, comment)
+      project = identifier(project_id, 'project_id')
+      approval = identifier(approval_id, 'approval_id')
+      note = comment_argument(comment)
+      response = Transport.invoke { yield(@client.session_token, project, approval, note) }
+      durable_approval(Transport.body(response, 200))
+    end
+
+    def list_options(filters)
+      status, function, execution_id, from, to, page, limit = list_filters(filters).values_at(*LIST_FILTERS)
+      validate_paging(page, limit)
+      window(function, from, to).merge(
+        status: optional_identifier(status, 'status'),
+        execution_id: optional_identifier(execution_id, 'execution_id'), page: page, limit: limit
+      ).compact
+    end
+
+    # Refuses a misspelled filter, as an unknown keyword would be.
+    def list_filters(filters)
+      raise TypeError, 'filters must be a Hash' unless filters.is_a?(Hash)
+
+      unknown = filters.keys - LIST_FILTERS
+      raise ArgumentError, "unknown keywords: #{unknown.join(', ')}" unless unknown.empty?
+
+      filters
+    end
+
+    def window(function, from, to)
+      { function: function_filter(function), from: timestamp_argument(from, 'from'), to: timestamp_argument(to, 'to') }
+    end
+
+    def optional_identifier(value, field)
+      value.nil? ? nil : identifier(value, field)
+    end
+
+    def function_filter(value)
+      return if value.nil?
+
+      name = value.is_a?(String) ? value.strip : ''
+      return name.freeze if !name.empty? && name.length <= MAX_FUNCTION_LENGTH
+
+      raise ArgumentError, "function must be a durable function id or name of 1 to #{MAX_FUNCTION_LENGTH} characters"
+    end
+
+    def comment_argument(value)
+      return if value.nil?
+      return value.dup.freeze if value.is_a?(String) && value.length <= MAX_COMMENT_LENGTH
+
+      raise ArgumentError, "comment must be a String of at most #{MAX_COMMENT_LENGTH} characters"
+    end
+  end
+end

data/lib/volcano/durable_arguments.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module Volcano
+  # Checks durable arguments before the generated client does. It enforces the
+  # same bounds but raises its own message, naming the operation and the option
+  # key it knows the value by; checked here, the caller reads a message about
+  # the argument they passed, the way Functions#invoke does for a function name.
+  module DurableArguments
+    # The page size the platform serves at most, mirrored from the wire contract.
+    MAX_PAGE_SIZE = 100
+    RFC3339_OFFSET = /(?:[Zz]|[+-]\d{2}:\d{2})\z/
+    private_constant :RFC3339_OFFSET
+
+    private
+
+    # An empty path segment would address the collection instead of the
+    # resource, which is a different request rather than a failed one.
+    def identifier(value, field)
+      raise ArgumentError, "#{field} must be a non-empty String" unless value.is_a?(String) && !value.strip.empty?
+
+      value.strip.freeze
+    end
+
+    def validate_paging(page, limit)
+      raise ArgumentError, 'page must be a positive Integer' unless page.nil? || positive_integer?(page)
+
+      validate_page_limit(limit)
+    end
+
+    def validate_page_limit(limit)
+      return if limit.nil? || (limit.is_a?(Integer) && positive_integer?(limit) && limit <= MAX_PAGE_SIZE)
+
+      raise ArgumentError, "limit must be an Integer between 1 and #{MAX_PAGE_SIZE}"
+    end
+
+    def positive_integer?(value)
+      value.is_a?(Integer) && value.positive?
+    end
+
+    # Sent in UTC with nanoseconds, so a bound keeps the caller's precision.
+    def timestamp_argument(value, field)
+      return if value.nil?
+
+      (value.is_a?(Time) ? value : offset_time(value)).getutc.iso8601(9)
+    rescue ArgumentError, TypeError
+      raise ArgumentError, "#{field} must be a Time or an ISO 8601 timestamp with an offset", cause: nil
+    end
+
+    # Time.iso8601 reads a string without an offset in the host's time zone.
+    def offset_time(value)
+      raise TypeError unless value.is_a?(String) && RFC3339_OFFSET.match?(value)
+
+      Time.iso8601(value)
+    end
+  end
+  private_constant :DurableArguments
+end

data/lib/volcano/durable_models.rb

@@ -165,10 +165,6 @@ module Volcano
       value
     end
 
-    def present_string?(value)
-      value.is_a?(String) && !value.strip.empty?
-    end
-
     def parse_time(value)
       return Time.iso8601(value) if value.is_a?(String)
       return value if value.nil? || value.is_a?(Time)

data/lib/volcano/errors.rb

@@ -16,6 +16,11 @@ module Volcano
     end
 
     class AuthenticationError < VolcanoError; end
+
+    # Raised for HTTP 403: the credential is valid but may not do this. It
+    # remains an AuthenticationError so existing handlers still catch it.
+    class PermissionDeniedError < AuthenticationError; end
+
     class ValidationError < VolcanoError; end
     class NotFoundError < VolcanoError; end
     class ConflictError < VolcanoError; end

data/lib/volcano/generated/lib/volcano-generated/api/anon_keys_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
@@ -72,7 +72,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AnonKey'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.create_anon_key",
@@ -141,7 +141,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AnonKey'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.get_anon_key",
@@ -242,7 +242,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'ListAnonKeys200Response'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.list_anon_keys",
@@ -311,7 +311,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AnonKey'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.regenerate_anon_key",
@@ -380,7 +380,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.revoke_anon_key",
@@ -449,7 +449,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AnonKey'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AnonKeysApi.set_default_anon_key",

data/lib/volcano/generated/lib/volcano-generated/api/auth_admin_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
@@ -20,7 +20,7 @@ module Volcano::Generated
       @api_client = api_client
     end
     # Ban a user
-    # Bans a user temporarily or permanently. Banned users cannot sign in and all their active sessions are immediately revoked.  - Omit `banned_until` for a permanent ban - Provide `banned_until` ISO timestamp for a temporary ban 
+    # Bans a user temporarily or permanently. Banned users cannot sign in and all their active sessions are immediately revoked. Omitting banned_until clears any previous expiry. Deleted accounts cannot be banned.  - Omit `banned_until` for a permanent ban - Provide `banned_until` ISO timestamp for a temporary ban 
     # @param id [String] Project ID
     # @param user_id [String] 
     # @param [Hash] opts the optional parameters
@@ -32,7 +32,7 @@ module Volcano::Generated
     end
 
     # Ban a user
-    # Bans a user temporarily or permanently. Banned users cannot sign in and all their active sessions are immediately revoked.  - Omit `banned_until` for a permanent ban - Provide `banned_until` ISO timestamp for a temporary ban 
+    # Bans a user temporarily or permanently. Banned users cannot sign in and all their active sessions are immediately revoked. Omitting banned_until clears any previous expiry. Deleted accounts cannot be banned.  - Omit `banned_until` for a permanent ban - Provide `banned_until` ISO timestamp for a temporary ban 
     # @param id [String] Project ID
     # @param user_id [String] 
     # @param [Hash] opts the optional parameters
@@ -76,7 +76,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'BanUserResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.ban_auth_user",
@@ -143,7 +143,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.delete_all_user_sessions",
@@ -210,7 +210,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.delete_auth_user",
@@ -283,7 +283,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.delete_user_session",
@@ -303,7 +303,7 @@ module Volcano::Generated
     end
 
     # Get auth user insights
-    # Returns current auth-user totals, rolling 30-day active users, and zero-filled signup and successful sign-in counts for an inclusive UTC date range. Weeks start on Monday. Sign-in counts and active-user activity begin when collection is deployed. Historical signup counts are backfilled from users present at deployment. Token refreshes affect active users but not the sign-in series. 
+    # Returns current and deleted auth-user totals, rolling 24-hour and 30-day active users, and zero-filled signup, deletion, net-growth, and successful sign-in counts for an inclusive UTC date range. Weeks start on Monday. Signups remain counted after deletion; net growth is signups minus deletions. Deleted users contribute to active counts until their last activity leaves the rolling window. Token refreshes affect active users but not the sign-in series. Collection starts at deployment, with signup history backfilled from accounts still present then. Earlier hard-deleted accounts cannot be recovered. 
     # @param id [String] Project ID
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from Inclusive UTC start date. Defaults to 29 days before `to`.
@@ -316,7 +316,7 @@ module Volcano::Generated
     end
 
     # Get auth user insights
-    # Returns current auth-user totals, rolling 30-day active users, and zero-filled signup and successful sign-in counts for an inclusive UTC date range. Weeks start on Monday. Sign-in counts and active-user activity begin when collection is deployed. Historical signup counts are backfilled from users present at deployment. Token refreshes affect active users but not the sign-in series. 
+    # Returns current and deleted auth-user totals, rolling 24-hour and 30-day active users, and zero-filled signup, deletion, net-growth, and successful sign-in counts for an inclusive UTC date range. Weeks start on Monday. Signups remain counted after deletion; net growth is signups minus deletions. Deleted users contribute to active counts until their last activity leaves the rolling window. Token refreshes affect active users but not the sign-in series. Collection starts at deployment, with signup history backfilled from accounts still present then. Earlier hard-deleted accounts cannot be recovered. 
     # @param id [String] Project ID
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from Inclusive UTC start date. Defaults to 29 days before `to`.
@@ -355,7 +355,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthInsightsResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.get_auth_insights",
@@ -422,7 +422,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthUser'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.get_auth_user",
@@ -530,7 +530,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'PaginatedAuthUsers'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.list_auth_users",
@@ -648,7 +648,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthGetMySessions200Response'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.list_user_sessions",
@@ -668,7 +668,7 @@ module Volcano::Generated
     end
 
     # Unban a user
-    # Removes a ban from a user, restoring their ability to sign in. The user's status is set back to 'active'. 
+    # Removes a ban from a user, restoring their ability to sign in. The user's status is set back to 'active'. Deleted accounts cannot be restored. 
     # @param id [String] Project ID
     # @param user_id [String] 
     # @param [Hash] opts the optional parameters
@@ -679,7 +679,7 @@ module Volcano::Generated
     end
 
     # Unban a user
-    # Removes a ban from a user, restoring their ability to sign in. The user's status is set back to 'active'. 
+    # Removes a ban from a user, restoring their ability to sign in. The user's status is set back to 'active'. Deleted accounts cannot be restored. 
     # @param id [String] Project ID
     # @param user_id [String] 
     # @param [Hash] opts the optional parameters
@@ -717,7 +717,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'UnbanUserResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthAdminApi.unban_auth_user",

data/lib/volcano/generated/lib/volcano-generated/api/auth_configuration_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
@@ -68,7 +68,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.configure_auth_methods",
@@ -88,7 +88,7 @@ module Volcano::Generated
     end
 
     # Create email template
-    # Creates a custom email template for the project. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed 
+    # Creates a custom email template for the project. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed 
     # @param id [String] Project ID
     # @param create_email_template_request [CreateEmailTemplateRequest] 
     # @param [Hash] opts the optional parameters
@@ -99,7 +99,7 @@ module Volcano::Generated
     end
 
     # Create email template
-    # Creates a custom email template for the project. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed 
+    # Creates a custom email template for the project. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed 
     # @param id [String] Project ID
     # @param create_email_template_request [CreateEmailTemplateRequest] 
     # @param [Hash] opts the optional parameters
@@ -142,7 +142,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'EmailTemplate'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.create_email_template",
@@ -209,7 +209,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.delete_auth_page_layout",
@@ -270,7 +270,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.delete_auth_page_theme",
@@ -290,7 +290,7 @@ module Volcano::Generated
     end
 
     # Delete email template
-    # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403. 
+    # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403. 
     # @param id [String] Project ID
     # @param type [String] 
     # @param [Hash] opts the optional parameters
@@ -301,7 +301,7 @@ module Volcano::Generated
     end
 
     # Delete email template
-    # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403. 
+    # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403. 
     # @param id [String] Project ID
     # @param type [String] 
     # @param [Hash] opts the optional parameters
@@ -344,7 +344,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.delete_email_template",
@@ -405,7 +405,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthConfig'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.get_auth_config",
@@ -474,7 +474,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthHostedPageResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.get_auth_hosted_page",
@@ -537,7 +537,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'GetAuthMethods200Response'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.get_auth_methods",
@@ -598,7 +598,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthPageAppearanceResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.get_auth_page_appearance",
@@ -793,7 +793,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'EmailTemplate'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.get_email_template",
@@ -1007,7 +1007,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'ListEmailTemplates200Response'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.list_email_templates",
@@ -1085,7 +1085,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'PreviewAuthPageResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.preview_auth_page",
@@ -1391,7 +1391,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'TestEmailResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.test_email_config",
@@ -1461,7 +1461,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthConfig'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.update_auth_config",
@@ -1541,7 +1541,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'AuthHostedPageResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.update_auth_hosted_page",
@@ -1619,7 +1619,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'UpdateAuthPageLayoutRequest'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.update_auth_page_layout",
@@ -1691,7 +1691,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'UpdateAuthPageThemeRequest'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.update_auth_page_theme",
@@ -1711,7 +1711,7 @@ module Volcano::Generated
     end
 
     # Update email template
-    # Updates a custom email template. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403 (including after a SUPERAGENT→HOBBY downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults. 
+    # Updates a custom email template. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403 (including after a downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults. 
     # @param id [String] Project ID
     # @param type [String] 
     # @param update_email_template_request [UpdateEmailTemplateRequest] 
@@ -1723,7 +1723,7 @@ module Volcano::Generated
     end
 
     # Update email template
-    # Updates a custom email template. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403 (including after a SUPERAGENT→HOBBY downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults. 
+    # Updates a custom email template. Custom email templates are a SUPERAGENT feature: requests from a HOBBY project owner are rejected with 403 (including after a downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults. 
     # @param id [String] Project ID
     # @param type [String] 
     # @param update_email_template_request [UpdateEmailTemplateRequest] 
@@ -1776,7 +1776,7 @@ module Volcano::Generated
       return_type = opts[:debug_return_type] || 'EmailTemplate'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['UserToken']
+      auth_names = opts[:debug_auth_names] || ['UserToken', 'ProjectAccessToken']
 
       new_options = opts.merge(
         :operation => :"AuthConfigurationApi.update_email_template",