smplkit 2.0.13 → 2.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a13c17482f6490edfe110ef2d8b196839e80a2cb51c1e5f2fbd9db1fa4dcc0c2
-  data.tar.gz: 30616e5d717587b16c3ba62bfc7ddf2ffe5ec36fa5517191bbad54c7d0645432
+  metadata.gz: 0cabb5a834e2ad1fbd07f37cec7079c2a2ef5cf34b9df9da510b6379fac0e47c
+  data.tar.gz: 6d6db271c08f2687eb2c7106be1311567d121e5a1062bc29ecf9ded909c7ddc3
 SHA512:
-  metadata.gz: ced9a4d2af5b33f5ac3bb2be41c204f1ba1a43dc99d3bcedeccedc9c80dbebc5c5dd072964211320c14032682a89178328405232b9f421bf232b548f50705803
-  data.tar.gz: 3f8c1dbb987307370be1b09db8e2c486217ecea0666cc9f7387bcf5cdac7d3b5fdf88218e4c0dfe74312094254acef38fcffc651f8c9df33811cef1aceb7888d
+  metadata.gz: 5cc0a9c24c531ec24d3b1d7da6dae7158195e97d4622ac5533cf349a43a7de53a85ac85bc3259e7463a8ab658a2facdf391212636cf9269e79d64132c8b6b59a
+  data.tar.gz: 731ddca19710d25548ea9c6e02151324a2c3b4ecfa90071e957cbbcfed0547fd3f989793a524a73562782426148b0ce41c43c8898bd68baa5f7b0c244bc0e348

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/account_api.rb

@@ -249,26 +249,26 @@ module SmplkitGeneratedClient::App
 
     # Update Current Account
     # Update the current account's settings.
-    # @param account_response [AccountResponse] 
+    # @param account_request [AccountRequest] 
     # @param [Hash] opts the optional parameters
     # @return [AccountResponse]
-    def update_account(account_response, opts = {})
-      data, _status_code, _headers = update_account_with_http_info(account_response, opts)
+    def update_account(account_request, opts = {})
+      data, _status_code, _headers = update_account_with_http_info(account_request, opts)
       data
     end
 
     # Update Current Account
     # Update the current account's settings.
-    # @param account_response [AccountResponse] 
+    # @param account_request [AccountRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountResponse, Integer, Hash)>] AccountResponse data, response status code and response headers
-    def update_account_with_http_info(account_response, opts = {})
+    def update_account_with_http_info(account_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AccountApi.update_account ...'
       end
-      # verify the required parameter 'account_response' is set
-      if @api_client.config.client_side_validation && account_response.nil?
-        fail ArgumentError, "Missing the required parameter 'account_response' when calling AccountApi.update_account"
+      # verify the required parameter 'account_request' is set
+      if @api_client.config.client_side_validation && account_request.nil?
+        fail ArgumentError, "Missing the required parameter 'account_request' when calling AccountApi.update_account"
       end
       # resource path
       local_var_path = '/api/v1/accounts/current'
@@ -290,7 +290,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(account_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(account_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'AccountResponse'
@@ -316,7 +316,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Wipe Account Data
-    # Delete every config, flag, logger, log group, context, context type, environment, and customer API key (except the caller's current key) on the account. The ``common`` config is preserved as a structural anchor but its items are reset. Requires ``OWNER`` role and a ``{\"confirm\": true}`` body — anything else returns 400. Pass ``\"generate_sample_data\": true`` to re-seed the account with the standard sample dataset after the wipe completes (best-effort; seed failures are logged but do not fail the wipe). Returns 204 on success; if any sub-delete fails the response is 500.
+    # Delete every config, flag, logger, log group, context, context type, environment, and customer API key (except the caller's current key) on the account. The `common` config is preserved as a structural anchor but its items are reset. Requires `OWNER` role and a body of `{\"confirm\": true}` — any other value returns 400. Pass `\"generate_sample_data\": true` to re-seed the account with the standard sample dataset after the wipe (best-effort; seeding failures are logged but do not fail the wipe). Returns 204 on success; 500 if any sub-delete fails.
     # @param account_wipe_request [AccountWipeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -326,7 +326,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Wipe Account Data
-    # Delete every config, flag, logger, log group, context, context type, environment, and customer API key (except the caller&#39;s current key) on the account. The &#x60;&#x60;common&#x60;&#x60; config is preserved as a structural anchor but its items are reset. Requires &#x60;&#x60;OWNER&#x60;&#x60; role and a &#x60;&#x60;{\&quot;confirm\&quot;: true}&#x60;&#x60; body — anything else returns 400. Pass &#x60;&#x60;\&quot;generate_sample_data\&quot;: true&#x60;&#x60; to re-seed the account with the standard sample dataset after the wipe completes (best-effort; seed failures are logged but do not fail the wipe). Returns 204 on success; if any sub-delete fails the response is 500.
+    # Delete every config, flag, logger, log group, context, context type, environment, and customer API key (except the caller&#39;s current key) on the account. The &#x60;common&#x60; config is preserved as a structural anchor but its items are reset. Requires &#x60;OWNER&#x60; role and a body of &#x60;{\&quot;confirm\&quot;: true}&#x60; — any other value returns 400. Pass &#x60;\&quot;generate_sample_data\&quot;: true&#x60; to re-seed the account with the standard sample dataset after the wipe (best-effort; seeding failures are logged but do not fail the wipe). Returns 204 on success; 500 if any sub-delete fails.
     # @param account_wipe_request [AccountWipeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/api_keys_api.rb

@@ -21,26 +21,26 @@ module SmplkitGeneratedClient::App
     end
     # Create API Key
     # Create a new API key. The id and key value are server-generated.
-    # @param api_key_response [ApiKeyResponse] 
+    # @param api_key_request [ApiKeyRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ApiKeyResponse]
-    def create_api_key(api_key_response, opts = {})
-      data, _status_code, _headers = create_api_key_with_http_info(api_key_response, opts)
+    def create_api_key(api_key_request, opts = {})
+      data, _status_code, _headers = create_api_key_with_http_info(api_key_request, opts)
       data
     end
 
     # Create API Key
     # Create a new API key. The id and key value are server-generated.
-    # @param api_key_response [ApiKeyResponse] 
+    # @param api_key_request [ApiKeyRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ApiKeyResponse, Integer, Hash)>] ApiKeyResponse data, response status code and response headers
-    def create_api_key_with_http_info(api_key_response, opts = {})
+    def create_api_key_with_http_info(api_key_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: APIKeysApi.create_api_key ...'
       end
-      # verify the required parameter 'api_key_response' is set
-      if @api_client.config.client_side_validation && api_key_response.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key_response' when calling APIKeysApi.create_api_key"
+      # verify the required parameter 'api_key_request' is set
+      if @api_client.config.client_side_validation && api_key_request.nil?
+        fail ArgumentError, "Missing the required parameter 'api_key_request' when calling APIKeysApi.create_api_key"
       end
       # resource path
       local_var_path = '/api/v1/api_keys'
@@ -62,7 +62,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(api_key_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(api_key_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'ApiKeyResponse'
@@ -339,21 +339,21 @@ module SmplkitGeneratedClient::App
     # Update API Key
     # Update an API key by id.
     # @param id [String] 
-    # @param api_key_response [ApiKeyResponse] 
+    # @param api_key_request [ApiKeyRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ApiKeyResponse]
-    def update_api_key(id, api_key_response, opts = {})
-      data, _status_code, _headers = update_api_key_with_http_info(id, api_key_response, opts)
+    def update_api_key(id, api_key_request, opts = {})
+      data, _status_code, _headers = update_api_key_with_http_info(id, api_key_request, opts)
       data
     end
 
     # Update API Key
     # Update an API key by id.
     # @param id [String] 
-    # @param api_key_response [ApiKeyResponse] 
+    # @param api_key_request [ApiKeyRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ApiKeyResponse, Integer, Hash)>] ApiKeyResponse data, response status code and response headers
-    def update_api_key_with_http_info(id, api_key_response, opts = {})
+    def update_api_key_with_http_info(id, api_key_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: APIKeysApi.update_api_key ...'
       end
@@ -361,9 +361,9 @@ module SmplkitGeneratedClient::App
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling APIKeysApi.update_api_key"
       end
-      # verify the required parameter 'api_key_response' is set
-      if @api_client.config.client_side_validation && api_key_response.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key_response' when calling APIKeysApi.update_api_key"
+      # verify the required parameter 'api_key_request' is set
+      if @api_client.config.client_side_validation && api_key_request.nil?
+        fail ArgumentError, "Missing the required parameter 'api_key_request' when calling APIKeysApi.update_api_key"
       end
       # resource path
       local_var_path = '/api/v1/api_keys/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -385,7 +385,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(api_key_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(api_key_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'ApiKeyResponse'

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/billing_api.rb

@@ -83,7 +83,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Add Payment Method
-    # Register a Stripe payment method (``pm_...``) as a persistent resource. The frontend obtains the Stripe ID via SetupIntent + Stripe Elements, then POSTs it here. Body shape and server behavior per ADR-044 §5.1.
+    # Register a Stripe payment method (`pm_...`) on the account. The client first creates the Stripe payment method using a SetupIntent and Stripe Elements, then submits its identifier here to persist it.
     # @param add_payment_method_body [AddPaymentMethodBody] 
     # @param [Hash] opts the optional parameters
     # @return [PaymentMethodResponse]
@@ -93,7 +93,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Add Payment Method
-    # Register a Stripe payment method (``pm_...``) as a persistent resource. The frontend obtains the Stripe ID via SetupIntent + Stripe Elements, then POSTs it here. Body shape and server behavior per ADR-044 §5.1.
+    # Register a Stripe payment method (`pm_...`) on the account. The client first creates the Stripe payment method using a SetupIntent and Stripe Elements, then submits its identifier here to persist it.
     # @param add_payment_method_body [AddPaymentMethodBody] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PaymentMethodResponse, Integer, Hash)>] PaymentMethodResponse data, response status code and response headers
@@ -219,7 +219,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Delete Payment Method
-    # Detach the payment method from Stripe and soft-delete the local row. Returns 409 if this is the only PM and the account has an active paid subscription. If the deleted row was default, the oldest remaining row is promoted.
+    # Delete a payment method. Returns 409 if this is the only payment method on file and the account has an active paid subscription. If the deleted payment method was the default, the oldest remaining payment method is promoted to default.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -229,7 +229,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Delete Payment Method
-    # Detach the payment method from Stripe and soft-delete the local row. Returns 409 if this is the only PM and the account has an active paid subscription. If the deleted row was default, the oldest remaining row is promoted.
+    # Delete a payment method. Returns 409 if this is the only payment method on file and the account has an active paid subscription. If the deleted payment method was the default, the oldest remaining payment method is promoted to default.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -356,7 +356,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Execute Setup Intent
-    # Create a Stripe SetupIntent for saving a payment method.  Returns a ``client_secret`` that the frontend passes to Stripe's Payment Element so the customer can securely enter card details without an immediate charge.
+    # Create a Stripe SetupIntent for adding a payment method without an immediate charge. Returns the `client_secret` to pass to Stripe Elements in the browser.
     # @param [Hash] opts the optional parameters
     # @return [SetupIntentResponse]
     def execute_setup_intent(opts = {})
@@ -365,7 +365,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Execute Setup Intent
-    # Create a Stripe SetupIntent for saving a payment method.  Returns a &#x60;&#x60;client_secret&#x60;&#x60; that the frontend passes to Stripe&#39;s Payment Element so the customer can securely enter card details without an immediate charge.
+    # Create a Stripe SetupIntent for adding a payment method without an immediate charge. Returns the &#x60;client_secret&#x60; to pass to Stripe Elements in the browser.
     # @param [Hash] opts the optional parameters
     # @return [Array<(SetupIntentResponse, Integer, Hash)>] SetupIntentResponse data, response status code and response headers
     def execute_setup_intent_with_http_info(opts = {})
@@ -413,7 +413,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Get Invoice
-    # Return a single invoice by ID. Supports content negotiation via Accept header:  - ``application/pdf`` — PDF bytes proxy-streamed from Stripe - ``application/vnd.api+json`` / ``application/json`` / absent — JSON:API resource - Any other value — 406 Not Acceptable
+    # Return a single invoice by id. Supports content negotiation via the `Accept` header:  - `application/pdf` — streams the invoice PDF. - `application/vnd.api+json`, `application/json`, or absent — returns   the JSON:API invoice resource. - Any other value — `406 Not Acceptable`.
     # @param invoice_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [InvoiceSingleResponse]
@@ -423,7 +423,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Get Invoice
-    # Return a single invoice by ID. Supports content negotiation via Accept header:  - &#x60;&#x60;application/pdf&#x60;&#x60; — PDF bytes proxy-streamed from Stripe - &#x60;&#x60;application/vnd.api+json&#x60;&#x60; / &#x60;&#x60;application/json&#x60;&#x60; / absent — JSON:API resource - Any other value — 406 Not Acceptable
+    # Return a single invoice by id. Supports content negotiation via the &#x60;Accept&#x60; header:  - &#x60;application/pdf&#x60; — streams the invoice PDF. - &#x60;application/vnd.api+json&#x60;, &#x60;application/json&#x60;, or absent — returns   the JSON:API invoice resource. - Any other value — &#x60;406 Not Acceptable&#x60;.
     # @param invoice_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(InvoiceSingleResponse, Integer, Hash)>] InvoiceSingleResponse data, response status code and response headers
@@ -710,7 +710,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Set Default Payment Method
-    # Mark this payment method as the account's default. Idempotent — a no-op 200 if already default.
+    # Mark this payment method as the account's default. Idempotent: returns 200 with no changes when the payment method is already the default.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [PaymentMethodResponse]
@@ -720,7 +720,7 @@ module SmplkitGeneratedClient::App
     end
 
     # Set Default Payment Method
-    # Mark this payment method as the account&#39;s default. Idempotent — a no-op 200 if already default.
+    # Mark this payment method as the account&#39;s default. Idempotent: returns 200 with no changes when the payment method is already the default.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PaymentMethodResponse, Integer, Hash)>] PaymentMethodResponse data, response status code and response headers
@@ -899,23 +899,23 @@ module SmplkitGeneratedClient::App
     end
 
     # Update Payment Method
-    # Update the mutable fields (``billing_details``, ``exp_month``, ``exp_year``). The ``default`` field is not mutable via PUT — see ADR-044 §5.2; use the ``set_default`` action instead.
+    # Update the mutable fields of a payment method (`billing_details`, `exp_month`, `exp_year`). The `default` flag is not mutable via PUT — use the `set_default` action instead.
     # @param id [String] 
-    # @param payment_method_response [PaymentMethodResponse] 
+    # @param payment_method_request [PaymentMethodRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PaymentMethodResponse]
-    def update_payment_method(id, payment_method_response, opts = {})
-      data, _status_code, _headers = update_payment_method_with_http_info(id, payment_method_response, opts)
+    def update_payment_method(id, payment_method_request, opts = {})
+      data, _status_code, _headers = update_payment_method_with_http_info(id, payment_method_request, opts)
       data
     end
 
     # Update Payment Method
-    # Update the mutable fields (&#x60;&#x60;billing_details&#x60;&#x60;, &#x60;&#x60;exp_month&#x60;&#x60;, &#x60;&#x60;exp_year&#x60;&#x60;). The &#x60;&#x60;default&#x60;&#x60; field is not mutable via PUT — see ADR-044 §5.2; use the &#x60;&#x60;set_default&#x60;&#x60; action instead.
+    # Update the mutable fields of a payment method (&#x60;billing_details&#x60;, &#x60;exp_month&#x60;, &#x60;exp_year&#x60;). The &#x60;default&#x60; flag is not mutable via PUT — use the &#x60;set_default&#x60; action instead.
     # @param id [String] 
-    # @param payment_method_response [PaymentMethodResponse] 
+    # @param payment_method_request [PaymentMethodRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PaymentMethodResponse, Integer, Hash)>] PaymentMethodResponse data, response status code and response headers
-    def update_payment_method_with_http_info(id, payment_method_response, opts = {})
+    def update_payment_method_with_http_info(id, payment_method_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: BillingApi.update_payment_method ...'
       end
@@ -923,9 +923,9 @@ module SmplkitGeneratedClient::App
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling BillingApi.update_payment_method"
       end
-      # verify the required parameter 'payment_method_response' is set
-      if @api_client.config.client_side_validation && payment_method_response.nil?
-        fail ArgumentError, "Missing the required parameter 'payment_method_response' when calling BillingApi.update_payment_method"
+      # verify the required parameter 'payment_method_request' is set
+      if @api_client.config.client_side_validation && payment_method_request.nil?
+        fail ArgumentError, "Missing the required parameter 'payment_method_request' when calling BillingApi.update_payment_method"
       end
       # resource path
       local_var_path = '/api/v1/payment_methods/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -947,7 +947,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(payment_method_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(payment_method_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'PaymentMethodResponse'

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/context_types_api.rb

@@ -21,26 +21,26 @@ module SmplkitGeneratedClient::App
     end
     # Create Context Type
     # Create a new context type. The caller provides the id (key) in the request body.
-    # @param context_type_response [ContextTypeResponse] 
+    # @param context_type_request [ContextTypeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ContextTypeResponse]
-    def create_context_type(context_type_response, opts = {})
-      data, _status_code, _headers = create_context_type_with_http_info(context_type_response, opts)
+    def create_context_type(context_type_request, opts = {})
+      data, _status_code, _headers = create_context_type_with_http_info(context_type_request, opts)
       data
     end
 
     # Create Context Type
     # Create a new context type. The caller provides the id (key) in the request body.
-    # @param context_type_response [ContextTypeResponse] 
+    # @param context_type_request [ContextTypeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ContextTypeResponse, Integer, Hash)>] ContextTypeResponse data, response status code and response headers
-    def create_context_type_with_http_info(context_type_response, opts = {})
+    def create_context_type_with_http_info(context_type_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ContextTypesApi.create_context_type ...'
       end
-      # verify the required parameter 'context_type_response' is set
-      if @api_client.config.client_side_validation && context_type_response.nil?
-        fail ArgumentError, "Missing the required parameter 'context_type_response' when calling ContextTypesApi.create_context_type"
+      # verify the required parameter 'context_type_request' is set
+      if @api_client.config.client_side_validation && context_type_request.nil?
+        fail ArgumentError, "Missing the required parameter 'context_type_request' when calling ContextTypesApi.create_context_type"
       end
       # resource path
       local_var_path = '/api/v1/context_types'
@@ -62,7 +62,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_type_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_type_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'ContextTypeResponse'
@@ -273,21 +273,21 @@ module SmplkitGeneratedClient::App
     # Update Context Type
     # Update a context type by id.
     # @param id [String] 
-    # @param context_type_response [ContextTypeResponse] 
+    # @param context_type_request [ContextTypeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ContextTypeResponse]
-    def update_context_type(id, context_type_response, opts = {})
-      data, _status_code, _headers = update_context_type_with_http_info(id, context_type_response, opts)
+    def update_context_type(id, context_type_request, opts = {})
+      data, _status_code, _headers = update_context_type_with_http_info(id, context_type_request, opts)
       data
     end
 
     # Update Context Type
     # Update a context type by id.
     # @param id [String] 
-    # @param context_type_response [ContextTypeResponse] 
+    # @param context_type_request [ContextTypeRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ContextTypeResponse, Integer, Hash)>] ContextTypeResponse data, response status code and response headers
-    def update_context_type_with_http_info(id, context_type_response, opts = {})
+    def update_context_type_with_http_info(id, context_type_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ContextTypesApi.update_context_type ...'
       end
@@ -295,9 +295,9 @@ module SmplkitGeneratedClient::App
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling ContextTypesApi.update_context_type"
       end
-      # verify the required parameter 'context_type_response' is set
-      if @api_client.config.client_side_validation && context_type_response.nil?
-        fail ArgumentError, "Missing the required parameter 'context_type_response' when calling ContextTypesApi.update_context_type"
+      # verify the required parameter 'context_type_request' is set
+      if @api_client.config.client_side_validation && context_type_request.nil?
+        fail ArgumentError, "Missing the required parameter 'context_type_request' when calling ContextTypesApi.update_context_type"
       end
       # resource path
       local_var_path = '/api/v1/context_types/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -319,7 +319,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_type_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_type_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'ContextTypeResponse'

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/contexts_api.rb

@@ -274,23 +274,23 @@ module SmplkitGeneratedClient::App
     end
 
     # Update Context
-    # Update a context instance by composite id (type:key). Only the human-readable display name is mutable through this endpoint; context_type and observed attributes are written by the SDK ingestion path.
+    # Update a context instance by composite id (type:key). Only the human-readable display name is mutable here; `context_type` and observed `attributes` are written by SDK registration and ignored on this endpoint.
     # @param id [String] 
-    # @param context_response [ContextResponse] 
+    # @param context_request [ContextRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ContextResponse]
-    def update_context(id, context_response, opts = {})
-      data, _status_code, _headers = update_context_with_http_info(id, context_response, opts)
+    def update_context(id, context_request, opts = {})
+      data, _status_code, _headers = update_context_with_http_info(id, context_request, opts)
       data
     end
 
     # Update Context
-    # Update a context instance by composite id (type:key). Only the human-readable display name is mutable through this endpoint; context_type and observed attributes are written by the SDK ingestion path.
+    # Update a context instance by composite id (type:key). Only the human-readable display name is mutable here; `context_type` and observed `attributes` are written by SDK registration and ignored on this endpoint.
     # @param id [String] 
-    # @param context_response [ContextResponse] 
+    # @param context_request [ContextRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ContextResponse, Integer, Hash)>] ContextResponse data, response status code and response headers
-    def update_context_with_http_info(id, context_response, opts = {})
+    def update_context_with_http_info(id, context_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ContextsApi.update_context ...'
       end
@@ -298,9 +298,9 @@ module SmplkitGeneratedClient::App
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling ContextsApi.update_context"
       end
-      # verify the required parameter 'context_response' is set
-      if @api_client.config.client_side_validation && context_response.nil?
-        fail ArgumentError, "Missing the required parameter 'context_response' when calling ContextsApi.update_context"
+      # verify the required parameter 'context_request' is set
+      if @api_client.config.client_side_validation && context_request.nil?
+        fail ArgumentError, "Missing the required parameter 'context_request' when calling ContextsApi.update_context"
       end
       # resource path
       local_var_path = '/api/v1/contexts/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -322,7 +322,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(context_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'ContextResponse'

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/environments_api.rb

@@ -21,26 +21,26 @@ module SmplkitGeneratedClient::App
     end
     # Create Environment
     # Create a new environment. The caller provides the id (key) in the request body.
-    # @param environment_response [EnvironmentResponse] 
+    # @param environment_request [EnvironmentRequest] 
     # @param [Hash] opts the optional parameters
     # @return [EnvironmentResponse]
-    def create_environment(environment_response, opts = {})
-      data, _status_code, _headers = create_environment_with_http_info(environment_response, opts)
+    def create_environment(environment_request, opts = {})
+      data, _status_code, _headers = create_environment_with_http_info(environment_request, opts)
       data
     end
 
     # Create Environment
     # Create a new environment. The caller provides the id (key) in the request body.
-    # @param environment_response [EnvironmentResponse] 
+    # @param environment_request [EnvironmentRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(EnvironmentResponse, Integer, Hash)>] EnvironmentResponse data, response status code and response headers
-    def create_environment_with_http_info(environment_response, opts = {})
+    def create_environment_with_http_info(environment_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: EnvironmentsApi.create_environment ...'
       end
-      # verify the required parameter 'environment_response' is set
-      if @api_client.config.client_side_validation && environment_response.nil?
-        fail ArgumentError, "Missing the required parameter 'environment_response' when calling EnvironmentsApi.create_environment"
+      # verify the required parameter 'environment_request' is set
+      if @api_client.config.client_side_validation && environment_request.nil?
+        fail ArgumentError, "Missing the required parameter 'environment_request' when calling EnvironmentsApi.create_environment"
       end
       # resource path
       local_var_path = '/api/v1/environments'
@@ -62,7 +62,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(environment_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(environment_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'EnvironmentResponse'
@@ -273,21 +273,21 @@ module SmplkitGeneratedClient::App
     # Update Environment
     # Update an environment by id.
     # @param id [String] 
-    # @param environment_response [EnvironmentResponse] 
+    # @param environment_request [EnvironmentRequest] 
     # @param [Hash] opts the optional parameters
     # @return [EnvironmentResponse]
-    def update_environment(id, environment_response, opts = {})
-      data, _status_code, _headers = update_environment_with_http_info(id, environment_response, opts)
+    def update_environment(id, environment_request, opts = {})
+      data, _status_code, _headers = update_environment_with_http_info(id, environment_request, opts)
       data
     end
 
     # Update Environment
     # Update an environment by id.
     # @param id [String] 
-    # @param environment_response [EnvironmentResponse] 
+    # @param environment_request [EnvironmentRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(EnvironmentResponse, Integer, Hash)>] EnvironmentResponse data, response status code and response headers
-    def update_environment_with_http_info(id, environment_response, opts = {})
+    def update_environment_with_http_info(id, environment_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: EnvironmentsApi.update_environment ...'
       end
@@ -295,9 +295,9 @@ module SmplkitGeneratedClient::App
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling EnvironmentsApi.update_environment"
       end
-      # verify the required parameter 'environment_response' is set
-      if @api_client.config.client_side_validation && environment_response.nil?
-        fail ArgumentError, "Missing the required parameter 'environment_response' when calling EnvironmentsApi.update_environment"
+      # verify the required parameter 'environment_request' is set
+      if @api_client.config.client_side_validation && environment_request.nil?
+        fail ArgumentError, "Missing the required parameter 'environment_request' when calling EnvironmentsApi.update_environment"
       end
       # resource path
       local_var_path = '/api/v1/environments/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -319,7 +319,7 @@ module SmplkitGeneratedClient::App
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(environment_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(environment_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'EnvironmentResponse'

data/lib/smplkit/_generated/app/lib/smplkit_app_client/api/metrics_api.rb

@@ -88,7 +88,7 @@ module SmplkitGeneratedClient::App
     end
 
     # List Metric Names
-    # Return distinct metric names (with a representative unit) for this account.  Used by the dashboard to discover which product sections to render. Plain JSON response (not JSON:API) — this is metadata, not a metric resource.
+    # Return distinct metric names recorded for the account, each with a representative unit. Plain-JSON response (not JSON:API) — this is metadata for discovery, not a metric resource.
     # @param [Hash] opts the optional parameters
     # @return [MetricNamesResponse]
     def list_metric_names(opts = {})
@@ -97,7 +97,7 @@ module SmplkitGeneratedClient::App
     end
 
     # List Metric Names
-    # Return distinct metric names (with a representative unit) for this account.  Used by the dashboard to discover which product sections to render. Plain JSON response (not JSON:API) — this is metadata, not a metric resource.
+    # Return distinct metric names recorded for the account, each with a representative unit. Plain-JSON response (not JSON:API) — this is metadata for discovery, not a metric resource.
     # @param [Hash] opts the optional parameters
     # @return [Array<(MetricNamesResponse, Integer, Hash)>] MetricNamesResponse data, response status code and response headers
     def list_metric_names_with_http_info(opts = {})