rocket_stack_sdk 1.0.2 → 1.0.4

data/docs/SchedulerApi.md

@@ -1,6 +1,6 @@
 # RocketStackSdk::SchedulerApi
 
-All URIs are relative to *https://api.rocketstack.dev*
+All URIs are relative to *https://ctrl.rocketstack.sh*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
@@ -9,6 +9,7 @@ All URIs are relative to *https://api.rocketstack.dev*
 | [**delete_schedule**](SchedulerApi.md#delete_schedule) | **DELETE** /schedules/{id} | Delete a schedule |
 | [**get_schedule**](SchedulerApi.md#get_schedule) | **GET** /schedules/{id} | Get a schedule by ID |
 | [**get_schedule_status**](SchedulerApi.md#get_schedule_status) | **GET** /schedules/{id}/status | Get schedule execution status |
+| [**list_schedule_invocations**](SchedulerApi.md#list_schedule_invocations) | **GET** /schedules/{id}/invocations | List schedule invocation history |
 | [**list_schedules**](SchedulerApi.md#list_schedules) | **GET** /schedules | List schedules |
 | [**update_schedule**](SchedulerApi.md#update_schedule) | **PATCH** /schedules/{id} | Update a schedule |
 
@@ -102,7 +103,7 @@ RocketStackSdk.configure do |config|
 end
 
 api_instance = RocketStackSdk::SchedulerApi.new
-create_schedule_request = RocketStackSdk::CreateScheduleRequest.new({name: 'name_example', run_at: 'run_at_example', delivery_target: RocketStackSdk::CreateCronJobRequestDeliveryTarget.new({type: 'function'})}) # CreateScheduleRequest | 
+create_schedule_request = RocketStackSdk::CreateScheduleRequest.new({name: 'name_example', run_at: 'run_at_example', delivery_target: RocketStackSdk::CreateCronJobRequestDeliveryTarget.new({type: 'function', function_id: 'function_id_example', webhook_url: 'webhook_url_example'})}) # CreateScheduleRequest | 
 
 begin
   # Create a new one-off schedule
@@ -358,6 +359,83 @@ end
 - **Accept**: application/json
 
 
+## list_schedule_invocations
+
+> <ListCronInvocations200Response> list_schedule_invocations(id, opts)
+
+List schedule invocation history
+
+Returns a paginated list of delivery attempts and outcomes for a one-off schedule.
+
+### Examples
+
+```ruby
+require 'time'
+require 'rocket_stack_sdk'
+# setup authorization
+RocketStackSdk.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = RocketStackSdk::SchedulerApi.new
+id = 'id_example' # String | 
+opts = {
+  limit: 8.14, # Float | 
+  cursor: 'cursor_example', # String | 
+  outcome: 'delivered' # String | 
+}
+
+begin
+  # List schedule invocation history
+  result = api_instance.list_schedule_invocations(id, opts)
+  p result
+rescue RocketStackSdk::ApiError => e
+  puts "Error when calling SchedulerApi->list_schedule_invocations: #{e}"
+end
+```
+
+#### Using the list_schedule_invocations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListCronInvocations200Response>, Integer, Hash)> list_schedule_invocations_with_http_info(id, opts)
+
+```ruby
+begin
+  # List schedule invocation history
+  data, status_code, headers = api_instance.list_schedule_invocations_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListCronInvocations200Response>
+rescue RocketStackSdk::ApiError => e
+  puts "Error when calling SchedulerApi->list_schedule_invocations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **limit** | **Float** |  | [optional] |
+| **cursor** | **String** |  | [optional] |
+| **outcome** | **String** |  | [optional] |
+
+### Return type
+
+[**ListCronInvocations200Response**](ListCronInvocations200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_schedules
 
 > <ListSchedules200Response> list_schedules(opts)
@@ -414,7 +492,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **limit** | **Float** |  | [optional][default to 50] |
+| **limit** | **Float** |  | [optional] |
 | **cursor** | **String** |  | [optional] |
 
 ### Return type

data/docs/StorageApi.md

@@ -1,6 +1,6 @@
 # RocketStackSdk::StorageApi
 
-All URIs are relative to *https://api.rocketstack.dev*
+All URIs are relative to *https://ctrl.rocketstack.sh*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
@@ -101,7 +101,7 @@ RocketStackSdk.configure do |config|
 end
 
 api_instance = RocketStackSdk::StorageApi.new
-path = 'path_example' # String | 
+path = 'path_example' # String | Object path without leading slash. Segments: letters, digits, dots, underscores, hyphens only.
 opts = {
   public: true # Boolean | 
 }
@@ -137,7 +137,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **path** | **String** |  |  |
+| **path** | **String** | Object path without leading slash. Segments: letters, digits, dots, underscores, hyphens only. |  |
 | **public** | **Boolean** |  | [optional] |
 
 ### Return type
@@ -353,8 +353,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **prefix** | **String** |  | [optional] |
-| **visibility** | **String** |  | [optional][default to 'all'] |
-| **limit** | **Integer** |  | [optional][default to 50] |
+| **visibility** | **String** |  | [optional] |
+| **limit** | **Integer** |  | [optional] |
 | **cursor** | **String** |  | [optional] |
 
 ### Return type

data/docs/UpdateCronJobRequestSchedule.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **expression** | **String** |  | [optional] |
-| **format** | **String** |  | [optional][default to 'unix5'] |
+| **format** | **String** |  | [optional] |
 | **timezone** | **String** |  | [optional] |
 
 ## Example

data/docs/UpdateScheduleRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **run_at** | **String** |  | [optional] |
+| **run_at** | **String** | RFC 3339 datetime with timezone (e.g. 2026-03-15T14:30:00Z). Must be in the future (max 365 days). | [optional] |
 | **delivery_target** | [**CreateCronJobRequestDeliveryTarget**](CreateCronJobRequestDeliveryTarget.md) |  | [optional] |
 | **paused** | **Boolean** |  | [optional] |
 | **payload_template** | **Hash<String, Object>** |  | [optional] |

data/lib/rocket_stack_sdk/api/cron_api.rb

@@ -1,9 +1,9 @@
 =begin
-#Rocketstack API
+#Rocketstack Control Plane API
 
-#API for Functions, Queues, KV, Storage, Cron, and Scheduler.
+#Combined API for Functions, Queues, KV, Storage, Cron, and Scheduler.
 
-The version of the OpenAPI document: 1.0.1
+The version of the OpenAPI document: 1.0.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0
@@ -91,7 +91,7 @@ module RocketStackSdk
     # Deletes a cron job and its associated AWS resources.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
-    # @return [CreateCronJob201Response]
+    # @return [DeleteCronJob200Response]
     def delete_cron_job(id, opts = {})
       data, _status_code, _headers = delete_cron_job_with_http_info(id, opts)
       data
@@ -101,7 +101,7 @@ module RocketStackSdk
     # Deletes a cron job and its associated AWS resources.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(CreateCronJob201Response, Integer, Hash)>] CreateCronJob201Response data, response status code and response headers
+    # @return [Array<(DeleteCronJob200Response, Integer, Hash)>] DeleteCronJob200Response data, response status code and response headers
     def delete_cron_job_with_http_info(id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: CronApi.delete_cron_job ...'
@@ -128,7 +128,7 @@ module RocketStackSdk
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CreateCronJob201Response'
+      return_type = opts[:debug_return_type] || 'DeleteCronJob200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']
@@ -213,10 +213,94 @@ module RocketStackSdk
       return data, status_code, headers
     end
 
+    # List cron invocation history
+    # Returns a paginated list of delivery attempts and outcomes for a cron job.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit 
+    # @option opts [String] :cursor 
+    # @option opts [String] :outcome 
+    # @return [ListCronInvocations200Response]
+    def list_cron_invocations(id, opts = {})
+      data, _status_code, _headers = list_cron_invocations_with_http_info(id, opts)
+      data
+    end
+
+    # List cron invocation history
+    # Returns a paginated list of delivery attempts and outcomes for a cron job.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :limit 
+    # @option opts [String] :cursor 
+    # @option opts [String] :outcome 
+    # @return [Array<(ListCronInvocations200Response, Integer, Hash)>] ListCronInvocations200Response data, response status code and response headers
+    def list_cron_invocations_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CronApi.list_cron_invocations ...'
+      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 CronApi.list_cron_invocations"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CronApi.list_cron_invocations, 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 CronApi.list_cron_invocations, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["delivered", "retrying", "discarded", "abandoned", "enqueued"]
+      if @api_client.config.client_side_validation && opts[:'outcome'] && !allowable_values.include?(opts[:'outcome'])
+        fail ArgumentError, "invalid value for \"outcome\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/cron/{id}/invocations'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'outcome'] = opts[:'outcome'] if !opts[:'outcome'].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] || 'ListCronInvocations200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"CronApi.list_cron_invocations",
+        :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: CronApi#list_cron_invocations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List cron jobs
     # Returns a paginated list of cron jobs for the tenant.
     # @param [Hash] opts the optional parameters
-    # @option opts [Float] :limit  (default to 50)
+    # @option opts [Float] :limit 
     # @option opts [String] :cursor 
     # @return [ListCronJobs200Response]
     def list_cron_jobs(opts = {})
@@ -227,7 +311,7 @@ module RocketStackSdk
     # List cron jobs
     # Returns a paginated list of cron jobs for the tenant.
     # @param [Hash] opts the optional parameters
-    # @option opts [Float] :limit  (default to 50)
+    # @option opts [Float] :limit 
     # @option opts [String] :cursor 
     # @return [Array<(ListCronJobs200Response, Integer, Hash)>] ListCronJobs200Response data, response status code and response headers
     def list_cron_jobs_with_http_info(opts = {})

data/lib/rocket_stack_sdk/api/functions_api.rb

@@ -1,9 +1,9 @@
 =begin
-#Rocketstack API
+#Rocketstack Control Plane API
 
-#API for Functions, Queues, KV, Storage, Cron, and Scheduler.
+#Combined API for Functions, Queues, KV, Storage, Cron, and Scheduler.
 
-The version of the OpenAPI document: 1.0.1
+The version of the OpenAPI document: 1.0.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0
@@ -247,6 +247,69 @@ module RocketStackSdk
       return data, status_code, headers
     end
 
+    # Get function code
+    # Downloads the actual deployed Lambda code package and returns editable source files.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetFunctionCode200Response]
+    def get_function_code(id, opts = {})
+      data, _status_code, _headers = get_function_code_with_http_info(id, opts)
+      data
+    end
+
+    # Get function code
+    # Downloads the actual deployed Lambda code package and returns editable source files.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetFunctionCode200Response, Integer, Hash)>] GetFunctionCode200Response data, response status code and response headers
+    def get_function_code_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FunctionsApi.get_function_code ...'
+      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 FunctionsApi.get_function_code"
+      end
+      # resource path
+      local_var_path = '/functions/{id}/code'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetFunctionCode200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FunctionsApi.get_function_code",
+        :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: FunctionsApi#get_function_code\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Invoke a function
     # Synchronously or asynchronously invokes a deployed function with the provided payload.
     # @param id [String] 
@@ -320,7 +383,7 @@ module RocketStackSdk
     # List functions
     # Returns a paginated list of functions for the tenant.
     # @param [Hash] opts the optional parameters
-    # @option opts [Float] :limit  (default to 50)
+    # @option opts [Float] :limit 
     # @option opts [String] :cursor 
     # @return [ListFunctions200Response]
     def list_functions(opts = {})
@@ -331,7 +394,7 @@ module RocketStackSdk
     # List functions
     # Returns a paginated list of functions for the tenant.
     # @param [Hash] opts the optional parameters
-    # @option opts [Float] :limit  (default to 50)
+    # @option opts [Float] :limit 
     # @option opts [String] :cursor 
     # @return [Array<(ListFunctions200Response, Integer, Hash)>] ListFunctions200Response data, response status code and response headers
     def list_functions_with_http_info(opts = {})

data/lib/rocket_stack_sdk/api/kv_api.rb

@@ -1,9 +1,9 @@
 =begin
-#Rocketstack API
+#Rocketstack Control Plane API
 
-#API for Functions, Queues, KV, Storage, Cron, and Scheduler.
+#Combined API for Functions, Queues, KV, Storage, Cron, and Scheduler.
 
-The version of the OpenAPI document: 1.0.1
+The version of the OpenAPI document: 1.0.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0
@@ -20,34 +20,30 @@ module RocketStackSdk
       @api_client = api_client
     end
     # Delete a KV item
-    # Deletes a key-value item by key (single path segment).
-    # @param key [String] 
+    # Deletes a key-value item by key.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @return [DeleteKvItem200Response]
-    def delete_kv_item(key, opts = {})
-      data, _status_code, _headers = delete_kv_item_with_http_info(key, opts)
+    def delete_kv_item(wildcard, opts = {})
+      data, _status_code, _headers = delete_kv_item_with_http_info(wildcard, opts)
       data
     end
 
     # Delete a KV item
-    # Deletes a key-value item by key (single path segment).
-    # @param key [String] 
+    # Deletes a key-value item by key.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(DeleteKvItem200Response, Integer, Hash)>] DeleteKvItem200Response data, response status code and response headers
-    def delete_kv_item_with_http_info(key, opts = {})
+    def delete_kv_item_with_http_info(wildcard, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: KvApi.delete_kv_item ...'
       end
-      # verify the required parameter 'key' is set
-      if @api_client.config.client_side_validation && key.nil?
-        fail ArgumentError, "Missing the required parameter 'key' when calling KvApi.delete_kv_item"
+      # verify the required parameter 'wildcard' is set
+      if @api_client.config.client_side_validation && wildcard.nil?
+        fail ArgumentError, "Missing the required parameter 'wildcard' when calling KvApi.delete_kv_item"
       end
-      if @api_client.config.client_side_validation && key.to_s.length < 1
-        fail ArgumentError, 'invalid value for "key" when calling KvApi.delete_kv_item, the character length must be greater than or equal to 1.'
-      end
-
       # resource path
-      local_var_path = '/kv/items/{key}'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+      local_var_path = '/kv/items/{wildcard}'.sub('{' + 'wildcard' + '}', CGI.escape(wildcard.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -87,34 +83,30 @@ module RocketStackSdk
     end
 
     # Get a KV item by key
-    # Retrieves a single key-value item. The key is specified as a single path segment (slashes not supported in path).
-    # @param key [String] 
+    # Retrieves a single key-value item by key.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @return [GetKvItem200Response]
-    def get_kv_item(key, opts = {})
-      data, _status_code, _headers = get_kv_item_with_http_info(key, opts)
+    def get_kv_item(wildcard, opts = {})
+      data, _status_code, _headers = get_kv_item_with_http_info(wildcard, opts)
       data
     end
 
     # Get a KV item by key
-    # Retrieves a single key-value item. The key is specified as a single path segment (slashes not supported in path).
-    # @param key [String] 
+    # Retrieves a single key-value item by key.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetKvItem200Response, Integer, Hash)>] GetKvItem200Response data, response status code and response headers
-    def get_kv_item_with_http_info(key, opts = {})
+    def get_kv_item_with_http_info(wildcard, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: KvApi.get_kv_item ...'
       end
-      # verify the required parameter 'key' is set
-      if @api_client.config.client_side_validation && key.nil?
-        fail ArgumentError, "Missing the required parameter 'key' when calling KvApi.get_kv_item"
-      end
-      if @api_client.config.client_side_validation && key.to_s.length < 1
-        fail ArgumentError, 'invalid value for "key" when calling KvApi.get_kv_item, the character length must be greater than or equal to 1.'
+      # verify the required parameter 'wildcard' is set
+      if @api_client.config.client_side_validation && wildcard.nil?
+        fail ArgumentError, "Missing the required parameter 'wildcard' when calling KvApi.get_kv_item"
       end
-
       # resource path
-      local_var_path = '/kv/items/{key}'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+      local_var_path = '/kv/items/{wildcard}'.sub('{' + 'wildcard' + '}', CGI.escape(wildcard.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -157,7 +149,7 @@ module RocketStackSdk
     # Returns a paginated list of KV items, optionally filtered by prefix.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :prefix 
-    # @option opts [Integer] :limit  (default to 50)
+    # @option opts [Integer] :limit 
     # @option opts [String] :cursor 
     # @return [ListKvItems200Response]
     def list_kv_items(opts = {})
@@ -169,7 +161,7 @@ module RocketStackSdk
     # Returns a paginated list of KV items, optionally filtered by prefix.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :prefix 
-    # @option opts [Integer] :limit  (default to 50)
+    # @option opts [Integer] :limit 
     # @option opts [String] :cursor 
     # @return [Array<(ListKvItems200Response, Integer, Hash)>] ListKvItems200Response data, response status code and response headers
     def list_kv_items_with_http_info(opts = {})
@@ -232,36 +224,32 @@ module RocketStackSdk
     end
 
     # Create or update a KV item
-    # Creates or updates a key-value item. Supports TTL and conditional writes via ifVersion. Key is a single path segment.
-    # @param key [String] 
+    # Creates or updates a key-value item. Supports TTL and conditional writes via ifVersion. Use ttlSeconds OR expiresAt, never both.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [PutKvItemRequest] :put_kv_item_request 
     # @return [PutKvItem200Response]
-    def put_kv_item(key, opts = {})
-      data, _status_code, _headers = put_kv_item_with_http_info(key, opts)
+    def put_kv_item(wildcard, opts = {})
+      data, _status_code, _headers = put_kv_item_with_http_info(wildcard, opts)
       data
     end
 
     # Create or update a KV item
-    # Creates or updates a key-value item. Supports TTL and conditional writes via ifVersion. Key is a single path segment.
-    # @param key [String] 
+    # Creates or updates a key-value item. Supports TTL and conditional writes via ifVersion. Use ttlSeconds OR expiresAt, never both.
+    # @param wildcard [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [PutKvItemRequest] :put_kv_item_request 
     # @return [Array<(PutKvItem200Response, Integer, Hash)>] PutKvItem200Response data, response status code and response headers
-    def put_kv_item_with_http_info(key, opts = {})
+    def put_kv_item_with_http_info(wildcard, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: KvApi.put_kv_item ...'
       end
-      # verify the required parameter 'key' is set
-      if @api_client.config.client_side_validation && key.nil?
-        fail ArgumentError, "Missing the required parameter 'key' when calling KvApi.put_kv_item"
-      end
-      if @api_client.config.client_side_validation && key.to_s.length < 1
-        fail ArgumentError, 'invalid value for "key" when calling KvApi.put_kv_item, the character length must be greater than or equal to 1.'
+      # verify the required parameter 'wildcard' is set
+      if @api_client.config.client_side_validation && wildcard.nil?
+        fail ArgumentError, "Missing the required parameter 'wildcard' when calling KvApi.put_kv_item"
       end
-
       # resource path
-      local_var_path = '/kv/items/{key}'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+      local_var_path = '/kv/items/{wildcard}'.sub('{' + 'wildcard' + '}', CGI.escape(wildcard.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}