vellum_ai 1.2.4 → 1.3.0

data/lib/vellum_ai/types/workflow_deployment_read.rb

@@ -8,6 +8,7 @@ require "ostruct"
 require "json"
 
 module Vellum
+# A Workflow Deployment's full details.
   class WorkflowDeploymentRead
   # @return [String] 
     attr_reader :id
@@ -19,10 +20,7 @@ module Vellum
 #  * `ACTIVE` - Active
 #  * `ARCHIVED` - Archived
     attr_reader :status
-  # @return [Vellum::EnvironmentEnum] The environment this workflow deployment is used in
-#  * `DEVELOPMENT` - Development
-#  * `STAGING` - Staging
-#  * `PRODUCTION` - Production
+  # @return [Vellum::EnvironmentEnum] Deprecated. The value returned will always be 'PRODUCTION'.
     attr_reader :environment
   # @return [DateTime] 
     attr_reader :created
@@ -53,10 +51,7 @@ module Vellum
     # @param status [Vellum::EntityStatus] The current status of the workflow deployment
 #  * `ACTIVE` - Active
 #  * `ARCHIVED` - Archived
-    # @param environment [Vellum::EnvironmentEnum] The environment this workflow deployment is used in
-#  * `DEVELOPMENT` - Development
-#  * `STAGING` - Staging
-#  * `PRODUCTION` - Production
+    # @param environment [Vellum::EnvironmentEnum] Deprecated. The value returned will always be 'PRODUCTION'.
     # @param created [DateTime] 
     # @param last_deployed_on [DateTime] 
     # @param last_deployed_history_item_id [String] The ID of the history item associated with this Workflow Deployment's LATEST

data/lib/vellum_ai/types/workflow_push_deployment_config_request.rb

@@ -12,6 +12,8 @@ module Vellum
     attr_reader :description
   # @return [Array<String>] 
     attr_reader :release_tags
+  # @return [String] 
+    attr_reader :release_description
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -24,15 +26,17 @@ module Vellum
     # @param name [String] 
     # @param description [String] 
     # @param release_tags [Array<String>] 
+    # @param release_description [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::WorkflowPushDeploymentConfigRequest]
-    def initialize(label: OMIT, name: OMIT, description: OMIT, release_tags: OMIT, additional_properties: nil)
+    def initialize(label: OMIT, name: OMIT, description: OMIT, release_tags: OMIT, release_description: OMIT, additional_properties: nil)
       @label = label if label != OMIT
       @name = name if name != OMIT
       @description = description if description != OMIT
       @release_tags = release_tags if release_tags != OMIT
+      @release_description = release_description if release_description != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "label": label, "name": name, "description": description, "release_tags": release_tags }.reject do | _k, v |
+      @_field_set = { "label": label, "name": name, "description": description, "release_tags": release_tags, "release_description": release_description }.reject do | _k, v |
   v == OMIT
 end
     end
@@ -47,11 +51,13 @@ end
       name = parsed_json["name"]
       description = parsed_json["description"]
       release_tags = parsed_json["release_tags"]
+      release_description = parsed_json["release_description"]
       new(
         label: label,
         name: name,
         description: description,
         release_tags: release_tags,
+        release_description: release_description,
         additional_properties: struct
       )
     end
@@ -72,6 +78,7 @@ end
       obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
       obj.release_tags&.is_a?(Array) != false || raise("Passed value for field obj.release_tags is not the expected type, validation failed.")
+      obj.release_description&.is_a?(String) != false || raise("Passed value for field obj.release_description is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/types/workflow_request_audio_input_request.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_audio_request"
+require "ostruct"
+require "json"
+
+module Vellum
+# The input for an audio variable in a Workflow.
+  class WorkflowRequestAudioInputRequest
+  # @return [String] The variable's name, as defined in the Workflow.
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumAudioRequest] 
+    attr_reader :value
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param name [String] The variable's name, as defined in the Workflow.
+    # @param type [String] 
+    # @param value [Vellum::VellumAudioRequest] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::WorkflowRequestAudioInputRequest]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of WorkflowRequestAudioInputRequest
+    #
+    # @param json_object [String] 
+    # @return [Vellum::WorkflowRequestAudioInputRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumAudioRequest.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of WorkflowRequestAudioInputRequest to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumAudioRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_request_document_input_request.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_document_request"
+require "ostruct"
+require "json"
+
+module Vellum
+# The input for a document variable in a Workflow.
+  class WorkflowRequestDocumentInputRequest
+  # @return [String] The variable's name, as defined in the Workflow.
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumDocumentRequest] 
+    attr_reader :value
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param name [String] The variable's name, as defined in the Workflow.
+    # @param type [String] 
+    # @param value [Vellum::VellumDocumentRequest] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::WorkflowRequestDocumentInputRequest]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of WorkflowRequestDocumentInputRequest
+    #
+    # @param json_object [String] 
+    # @return [Vellum::WorkflowRequestDocumentInputRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumDocumentRequest.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of WorkflowRequestDocumentInputRequest to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumDocumentRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_request_image_input_request.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_image_request"
+require "ostruct"
+require "json"
+
+module Vellum
+# The input for an image variable in a Workflow.
+  class WorkflowRequestImageInputRequest
+  # @return [String] The variable's name, as defined in the Workflow.
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumImageRequest] 
+    attr_reader :value
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param name [String] The variable's name, as defined in the Workflow.
+    # @param type [String] 
+    # @param value [Vellum::VellumImageRequest] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::WorkflowRequestImageInputRequest]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of WorkflowRequestImageInputRequest
+    #
+    # @param json_object [String] 
+    # @return [Vellum::WorkflowRequestImageInputRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumImageRequest.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of WorkflowRequestImageInputRequest to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumImageRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_request_input_request.rb

@@ -4,6 +4,10 @@ require_relative "workflow_request_string_input_request"
 require_relative "workflow_request_json_input_request"
 require_relative "workflow_request_chat_history_input_request"
 require_relative "workflow_request_number_input_request"
+require_relative "workflow_request_audio_input_request"
+require_relative "workflow_request_video_input_request"
+require_relative "workflow_request_image_input_request"
+require_relative "workflow_request_document_input_request"
 
 module Vellum
   class WorkflowRequestInputRequest
@@ -51,6 +55,46 @@ end
   return Vellum::WorkflowRequestNumberInputRequest.from_json(json_object: struct)
 else
   return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowRequestAudioInputRequest.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowRequestAudioInputRequest.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowRequestVideoInputRequest.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowRequestVideoInputRequest.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowRequestImageInputRequest.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowRequestImageInputRequest.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowRequestDocumentInputRequest.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowRequestDocumentInputRequest.from_json(json_object: struct)
+else
+  return nil
 end
       rescue StandardError
         # noop
@@ -84,6 +128,26 @@ end
       rescue StandardError
         # noop
       end
+      begin
+        return Vellum::WorkflowRequestAudioInputRequest.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowRequestVideoInputRequest.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowRequestImageInputRequest.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowRequestDocumentInputRequest.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
       raise("Passed value matched no type within the union, validation failed.")
     end
   end

data/lib/vellum_ai/types/workflow_request_video_input_request.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_video_request"
+require "ostruct"
+require "json"
+
+module Vellum
+# The input for a video variable in a Workflow.
+  class WorkflowRequestVideoInputRequest
+  # @return [String] The variable's name, as defined in the Workflow.
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumVideoRequest] 
+    attr_reader :value
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param name [String] The variable's name, as defined in the Workflow.
+    # @param type [String] 
+    # @param value [Vellum::VellumVideoRequest] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::WorkflowRequestVideoInputRequest]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of WorkflowRequestVideoInputRequest
+    #
+    # @param json_object [String] 
+    # @return [Vellum::WorkflowRequestVideoInputRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumVideoRequest.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of WorkflowRequestVideoInputRequest to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumVideoRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/workflow_sandboxes/client.rb

@@ -19,7 +19,6 @@ module Vellum
       @request_client = request_client
     end
     # @param id [String] A UUID string identifying this workflow sandbox.
-    # @param workflow_id [String] An ID identifying the Workflow you'd like to deploy.
     # @param workflow_deployment_id [String] The Vellum-generated ID of the Workflow Deployment you'd like to update. Cannot
 #  specify both this and workflow_deployment_name. Leave null to create a new
 #  Workflow Deployment.
@@ -40,8 +39,8 @@ module Vellum
 #    environment: Vellum::Environment::PRODUCTION,
 #    api_key: "YOUR_API_KEY"
 #  )
-#  api.workflow_sandboxes.deploy_workflow(id: "id", workflow_id: "workflow_id")
-    def deploy_workflow(id:, workflow_id:, workflow_deployment_id: nil, workflow_deployment_name: nil, label: nil, release_tags: nil, release_description: nil, request_options: nil)
+#  api.workflow_sandboxes.deploy_workflow(id: "id")
+    def deploy_workflow(id:, workflow_deployment_id: nil, workflow_deployment_name: nil, label: nil, release_tags: nil, release_description: nil, request_options: nil)
       response = @request_client.conn.post do | req |
   unless request_options&.timeout_in_seconds.nil?
     req.options.timeout = request_options.timeout_in_seconds
@@ -59,7 +58,7 @@ module Vellum
     req.params = { **(request_options&.additional_query_parameters || {}) }.compact
   end
   req.body = { **(request_options&.additional_body_parameters || {}), workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, label: label, release_tags: release_tags, release_description: release_description }.compact
-  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflow-sandboxes/#{id}/workflows/#{workflow_id}/deploy"
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflow-sandboxes/#{id}/deploy"
 end
       Vellum::WorkflowDeploymentRead.from_json(json_object: response.body)
     end
@@ -113,7 +112,6 @@ end
       @request_client = request_client
     end
     # @param id [String] A UUID string identifying this workflow sandbox.
-    # @param workflow_id [String] An ID identifying the Workflow you'd like to deploy.
     # @param workflow_deployment_id [String] The Vellum-generated ID of the Workflow Deployment you'd like to update. Cannot
 #  specify both this and workflow_deployment_name. Leave null to create a new
 #  Workflow Deployment.
@@ -134,8 +132,8 @@ end
 #    environment: Vellum::Environment::PRODUCTION,
 #    api_key: "YOUR_API_KEY"
 #  )
-#  api.workflow_sandboxes.deploy_workflow(id: "id", workflow_id: "workflow_id")
-    def deploy_workflow(id:, workflow_id:, workflow_deployment_id: nil, workflow_deployment_name: nil, label: nil, release_tags: nil, release_description: nil, request_options: nil)
+#  api.workflow_sandboxes.deploy_workflow(id: "id")
+    def deploy_workflow(id:, workflow_deployment_id: nil, workflow_deployment_name: nil, label: nil, release_tags: nil, release_description: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -154,7 +152,7 @@ end
     req.params = { **(request_options&.additional_query_parameters || {}) }.compact
   end
   req.body = { **(request_options&.additional_body_parameters || {}), workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, label: label, release_tags: release_tags, release_description: release_description }.compact
-  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflow-sandboxes/#{id}/workflows/#{workflow_id}/deploy"
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflow-sandboxes/#{id}/deploy"
 end
         Vellum::WorkflowDeploymentRead.from_json(json_object: response.body)
       end

data/lib/vellum_ai/workflows/client.rb

@@ -23,14 +23,17 @@ module Vellum
     # @param exclude_display [Boolean] 
     # @param include_json [Boolean] 
     # @param include_sandbox [Boolean] 
+    # @param release_tag [String] Release tag to use when pulling from deployment (implies deployment-only lookup)
     # @param strict [Boolean] 
+    # @param version [String] Semantic version range to validate against the Workflow SDK version (e.g.,
+#  '>=1.0.0,<1.2.3')
     # @param request_options [Vellum::RequestOptions] 
     # @yield on_data[chunk, overall_received_bytes, env] Leverage the Faraday on_data callback which
 #  will receive tuples of strings, the sum of characters received so far, and the
 #  response environment. The latter will allow access to the response status,
 #  headers and reason, as well as the request info.
     # @return [Void]
-    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, strict: nil, request_options: nil, &on_data)
+    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, release_tag: nil, strict: nil, version: nil, request_options: nil, &on_data)
       response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
     req.options.timeout = request_options.timeout_in_seconds
@@ -45,7 +48,7 @@ module Vellum
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
   req.options.on_data = on_data
-  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "strict": strict }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "release_tag": release_tag, "strict": strict, "version": version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -59,6 +62,7 @@ end
     #   * :name (String) 
     #   * :description (String) 
     #   * :release_tags (Array<String>) 
+    #   * :release_description (String) 
     # @param artifact [String, IO] 
     # @param dry_run [Boolean] 
     # @param strict [Boolean] 
@@ -104,14 +108,17 @@ end
     # @param exclude_display [Boolean] 
     # @param include_json [Boolean] 
     # @param include_sandbox [Boolean] 
+    # @param release_tag [String] Release tag to use when pulling from deployment (implies deployment-only lookup)
     # @param strict [Boolean] 
+    # @param version [String] Semantic version range to validate against the Workflow SDK version (e.g.,
+#  '>=1.0.0,<1.2.3')
     # @param request_options [Vellum::RequestOptions] 
     # @yield on_data[chunk, overall_received_bytes, env] Leverage the Faraday on_data callback which
 #  will receive tuples of strings, the sum of characters received so far, and the
 #  response environment. The latter will allow access to the response status,
 #  headers and reason, as well as the request info.
     # @return [Void]
-    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, strict: nil, request_options: nil, &on_data)
+    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, release_tag: nil, strict: nil, version: nil, request_options: nil, &on_data)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -127,7 +134,7 @@ end
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
   req.options.on_data = on_data
-  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "strict": strict }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "release_tag": release_tag, "strict": strict, "version": version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -142,6 +149,7 @@ end
     #   * :name (String) 
     #   * :description (String) 
     #   * :release_tags (Array<String>) 
+    #   * :release_description (String) 
     # @param artifact [String, IO] 
     # @param dry_run [Boolean] 
     # @param strict [Boolean]