vellum_ai 1.10.9 → 1.11.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 130a7100771ff919699318c13d6b0fb1a63b3cced17536a55273f25b21415274
-  data.tar.gz: 77450c38111fd477491f7cb3437aa6e4d280a3d5fb1b2495ff8c1bd2a64dd29d
+  metadata.gz: a60ad69d455a95ad07f2fc8f372c4b33f02ff1d029706aa9bda14a4e02ac654e
+  data.tar.gz: 942fd246875f6513a390560f37eacaf9e8ca9c121d79f5a64066a0b56a91639f
 SHA512:
-  metadata.gz: b9ef0aada48fa7e131b0f36f096efd78a6a611686d46fa00174022e0154a7d27d7da50d13a18d95291ab3188835e15bf71bfbcada497820be29d35fd61f5252b
-  data.tar.gz: 1d69346feb2071466bd3c7539f0f74235de94a20e1dcf7a0df86c354c164e0de20584336a0e2fcc694860e627ea0aa4d793539bee615309348e56648ac7bd3f6
+  metadata.gz: ff5e52bda3751837cede9f49267451deb82d64af6d7002862e21dce749b2da24659c855520075e93ef7fa4182faa759ee00646831ef55521fc282fb400dc9408
+  data.tar.gz: c7bdcd32fa746bcc784e4f2979333350f26718c7c1a4501204e136d423c0837a885b6b3b1041077d78a780fb23d464daf6fc362d4f3482c7506f745b372b0235

data/lib/requests.rb

@@ -56,7 +56,7 @@ end
     end
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.10.9' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.11.3' }
       headers["X-API-KEY"] = ((@api_key.is_a? Method) ? @api_key.call : @api_key) unless @api_key.nil?
  headers
     end
@@ -107,7 +107,7 @@ end
     end
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.10.9' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.11.3' }
       headers["X-API-KEY"] = ((@api_key.is_a? Method) ? @api_key.call : @api_key) unless @api_key.nil?
  headers
     end

data/lib/types_export.rb

@@ -187,6 +187,7 @@ require_relative "vellum_ai/types/rejected_execute_prompt_response"
 require_relative "vellum_ai/types/execute_prompt_response"
 require_relative "vellum_ai/types/components_schemas_composio_execute_tool_request"
 require_relative "vellum_ai/types/components_schemas_composio_execute_tool_response"
+require_relative "vellum_ai/types/execute_workflow_async_response"
 require_relative "vellum_ai/types/execute_workflow_response"
 require_relative "vellum_ai/types/fulfilled_execute_workflow_workflow_result_event"
 require_relative "vellum_ai/types/rejected_execute_workflow_workflow_result_event"

data/lib/vellum_ai/ad_hoc/client.rb

@@ -33,6 +33,7 @@ module Vellum
     #   * :extensions (Hash)
     #     * :color (String) 
     #     * :description (String) 
+    #   * :schema (Hash{String => Object}) 
     # @param parameters [Hash] Request of type Vellum::PromptParameters, as a Hash
     #   * :stop (Array<String>) 
     #   * :temperature (Float) 
@@ -121,6 +122,7 @@ end
     #   * :extensions (Hash)
     #     * :color (String) 
     #     * :description (String) 
+    #   * :schema (Hash{String => Object}) 
     # @param parameters [Hash] Request of type Vellum::PromptParameters, as a Hash
     #   * :stop (Array<String>) 
     #   * :temperature (Float) 

data/lib/vellum_ai/documents/client.rb

@@ -189,13 +189,15 @@ end
 #  to be re-indexed.
     # @param label [String] A human-friendly name for this document. Typically the filename.
     # @param contents [String, IO] 
+    # @param url [String] A URL from which the document can be downloaded. Either contents or url must be
+#  provided.
     # @param keywords [Array<String>] Optionally include a list of keywords that'll be associated with this document.
 #  Used when performing keyword searches.
     # @param metadata [String] A stringified JSON object containing any metadata associated with the document
 #  that you'd like to filter upon later.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadDocumentResponse]
-    def upload(add_to_index_names: nil, external_id: nil, label:, contents:, keywords: nil, metadata: nil, request_options: nil)
+    def upload(add_to_index_names: nil, external_id: nil, label:, contents: nil, url: nil, keywords: nil, metadata: 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
@@ -212,7 +214,9 @@ end
   unless request_options.nil? || request_options&.additional_query_parameters.nil?
     req.params = { **(request_options&.additional_query_parameters || {}) }.compact
   end
-  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: Vellum::FileUtilities.as_faraday_multipart(file_like: contents), keywords: keywords, metadata: metadata }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: unless contents.nil?
+  Vellum::FileUtilities.as_faraday_multipart(file_like: contents)
+end, url: url, keywords: keywords, metadata: metadata }.compact
   req.url "#{@request_client.get_url(environment: Documents, request_options: request_options)}/v1/upload-document"
 end
       Vellum::UploadDocumentResponse.from_json(json_object: response.body)
@@ -402,13 +406,15 @@ end
 #  to be re-indexed.
     # @param label [String] A human-friendly name for this document. Typically the filename.
     # @param contents [String, IO] 
+    # @param url [String] A URL from which the document can be downloaded. Either contents or url must be
+#  provided.
     # @param keywords [Array<String>] Optionally include a list of keywords that'll be associated with this document.
 #  Used when performing keyword searches.
     # @param metadata [String] A stringified JSON object containing any metadata associated with the document
 #  that you'd like to filter upon later.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadDocumentResponse]
-    def upload(add_to_index_names: nil, external_id: nil, label:, contents:, keywords: nil, metadata: nil, request_options: nil)
+    def upload(add_to_index_names: nil, external_id: nil, label:, contents: nil, url: nil, keywords: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -426,7 +432,9 @@ end
   unless request_options.nil? || request_options&.additional_query_parameters.nil?
     req.params = { **(request_options&.additional_query_parameters || {}) }.compact
   end
-  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: Vellum::FileUtilities.as_faraday_multipart(file_like: contents), keywords: keywords, metadata: metadata }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: unless contents.nil?
+  Vellum::FileUtilities.as_faraday_multipart(file_like: contents)
+end, url: url, keywords: keywords, metadata: metadata }.compact
   req.url "#{@request_client.get_url(environment: Documents, request_options: request_options)}/v1/upload-document"
 end
         Vellum::UploadDocumentResponse.from_json(json_object: response.body)

data/lib/vellum_ai/types/execute_workflow_async_response.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+# The response from an async Workflow Deployment execution.
+  class ExecuteWorkflowAsyncResponse
+  # @return [String] The ID of the workflow execution.
+    attr_reader :execution_id
+  # @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 execution_id [String] The ID of the workflow execution.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    def initialize(execution_id:, additional_properties: nil)
+      @execution_id = execution_id
+      @additional_properties = additional_properties
+      @_field_set = { "execution_id": execution_id }
+    end
+# Deserialize a JSON object to an instance of ExecuteWorkflowAsyncResponse
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      execution_id = parsed_json["execution_id"]
+      new(execution_id: execution_id, additional_properties: struct)
+    end
+# Serialize an instance of ExecuteWorkflowAsyncResponse 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.execution_id.is_a?(String) != false || raise("Passed value for field obj.execution_id is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/integration_name.rb

@@ -10,6 +10,7 @@ module Vellum
 #  * `CODA` - Coda
 #  * `HUBSPOT` - Hubspot
 #  * `INTERCOM` - Intercom
+#  * `INSTAGRAM` - Instagram
 #  * `LINEAR` - Linear
 #  * `LINKUP` - Linkup
 #  * `LISTENNOTES` - Listen Notes
@@ -23,6 +24,13 @@ module Vellum
 #  * `GOOGLE_CALENDAR` - Google Calendar
 #  * `GOOGLE_DRIVE` - Google Drive
 #  * `GMAIL` - Gmail
+#  * `GOOGLE_ADS` - Google Ads
+#  * `GOOGLE_ANALYTICS` - Google Analytics
+#  * `GOOGLE_DOCS` - Google Docs
+#  * `GOOGLE_PHOTOS` - Google Photos
+#  * `GOOGLE_SEARCH_CONSOLE` - Google Search Console
+#  * `GOOGLE_SLIDES` - Google Slides
+#  * `GOOGLE_TASKS` - Google Tasks
 #  * `ACCULYNX` - AccuLynx
 #  * `AFFINITY` - Affinity
 #  * `AGENCYZOOM` - AgencyZoom
@@ -72,6 +80,7 @@ module Vellum
 #  * `ZENROWS` - ZenRows
 #  * `DROPBOX` - Dropbox
 #  * `EVENTBRITE` - Eventbrite
+#  * `FACEBOOK` - Facebook
 #  * `CONFLUENCE` - Confluence
 #  * `COINBASE` - Coinbase
 #  * `DISCORD` - Discord
@@ -88,6 +97,7 @@ module Vellum
     CODA = "CODA"
     HUBSPOT = "HUBSPOT"
     INTERCOM = "INTERCOM"
+    INSTAGRAM = "INSTAGRAM"
     LINEAR = "LINEAR"
     LINKUP = "LINKUP"
     LISTENNOTES = "LISTENNOTES"
@@ -101,6 +111,13 @@ module Vellum
     GOOGLE_CALENDAR = "GOOGLE_CALENDAR"
     GOOGLE_DRIVE = "GOOGLE_DRIVE"
     GMAIL = "GMAIL"
+    GOOGLE_ADS = "GOOGLE_ADS"
+    GOOGLE_ANALYTICS = "GOOGLE_ANALYTICS"
+    GOOGLE_DOCS = "GOOGLE_DOCS"
+    GOOGLE_PHOTOS = "GOOGLE_PHOTOS"
+    GOOGLE_SEARCH_CONSOLE = "GOOGLE_SEARCH_CONSOLE"
+    GOOGLE_SLIDES = "GOOGLE_SLIDES"
+    GOOGLE_TASKS = "GOOGLE_TASKS"
     ACCULYNX = "ACCULYNX"
     AFFINITY = "AFFINITY"
     AGENCYZOOM = "AGENCYZOOM"
@@ -150,6 +167,7 @@ module Vellum
     ZENROWS = "ZENROWS"
     DROPBOX = "DROPBOX"
     EVENTBRITE = "EVENTBRITE"
+    FACEBOOK = "FACEBOOK"
     CONFLUENCE = "CONFLUENCE"
     COINBASE = "COINBASE"
     DISCORD = "DISCORD"

data/lib/vellum_ai/types/vellum_code_resource_definition.rb

@@ -8,6 +8,8 @@ module Vellum
     attr_reader :name
   # @return [Array<String>] The module that this resource is defined in.
     attr_reader :module_
+  # @return [Boolean] Whether this node should be excluded from monitoring views.
+    attr_reader :exclude_from_monitoring
   # @return [String] 
     attr_reader :id
   # @return [OpenStruct] Additional properties unmapped to the current class definition
@@ -20,15 +22,19 @@ module Vellum
 
     # @param name [String] 
     # @param module_ [Array<String>] The module that this resource is defined in.
+    # @param exclude_from_monitoring [Boolean] Whether this node should be excluded from monitoring views.
     # @param id [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumCodeResourceDefinition]
-    def initialize(name:, module_:, id:, additional_properties: nil)
+    def initialize(name:, module_:, exclude_from_monitoring: OMIT, id:, additional_properties: nil)
       @name = name
       @module_ = module_
+      @exclude_from_monitoring = exclude_from_monitoring if exclude_from_monitoring != OMIT
       @id = id
       @additional_properties = additional_properties
-      @_field_set = { "name": name, "module": module_, "id": id }
+      @_field_set = { "name": name, "module": module_, "exclude_from_monitoring": exclude_from_monitoring, "id": id }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of VellumCodeResourceDefinition
     #
@@ -39,10 +45,12 @@ module Vellum
       parsed_json = JSON.parse(json_object)
       name = parsed_json["name"]
       module_ = parsed_json["module"]
+      exclude_from_monitoring = parsed_json["exclude_from_monitoring"]
       id = parsed_json["id"]
       new(
         name: name,
         module_: module_,
+        exclude_from_monitoring: exclude_from_monitoring,
         id: id,
         additional_properties: struct
       )
@@ -62,6 +70,7 @@ module Vellum
     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.module_.is_a?(Array) != false || raise("Passed value for field obj.module_ is not the expected type, validation failed.")
+      obj.exclude_from_monitoring&.is_a?(Boolean) != false || raise("Passed value for field obj.exclude_from_monitoring is not the expected type, validation failed.")
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
     end
   end

data/lib/vellum_ai/types/vellum_variable.rb

@@ -19,6 +19,8 @@ module Vellum
     attr_reader :default
   # @return [Vellum::VellumVariableExtensions] 
     attr_reader :extensions
+  # @return [Hash{String => Object}] 
+    attr_reader :schema
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -33,17 +35,19 @@ module Vellum
     # @param required [Boolean] 
     # @param default [Vellum::VellumValue] 
     # @param extensions [Vellum::VellumVariableExtensions] 
+    # @param schema [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumVariable]
-    def initialize(id:, key:, type:, required: OMIT, default: OMIT, extensions: OMIT, additional_properties: nil)
+    def initialize(id:, key:, type:, required: OMIT, default: OMIT, extensions: OMIT, schema: OMIT, additional_properties: nil)
       @id = id
       @key = key
       @type = type
       @required = required if required != OMIT
       @default = default if default != OMIT
       @extensions = extensions if extensions != OMIT
+      @schema = schema if schema != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "id": id, "key": key, "type": type, "required": required, "default": default, "extensions": extensions }.reject do | _k, v |
+      @_field_set = { "id": id, "key": key, "type": type, "required": required, "default": default, "extensions": extensions, "schema": schema }.reject do | _k, v |
   v == OMIT
 end
     end
@@ -70,6 +74,7 @@ end
       else
         extensions = nil
       end
+      schema = parsed_json["schema"]
       new(
         id: id,
         key: key,
@@ -77,6 +82,7 @@ end
         required: required,
         default: default,
         extensions: extensions,
+        schema: schema,
         additional_properties: struct
       )
     end
@@ -99,6 +105,7 @@ end
       obj.required&.is_a?(Boolean) != false || raise("Passed value for field obj.required is not the expected type, validation failed.")
       obj.default.nil? || Vellum::VellumValue.validate_raw(obj: obj.default)
       obj.extensions.nil? || Vellum::VellumVariableExtensions.validate_raw(obj: obj.extensions)
+      obj.schema&.is_a?(Hash) != false || raise("Passed value for field obj.schema is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/types/vellum_variable_type.rb

@@ -15,6 +15,7 @@ module Vellum
 #  * `DOCUMENT` - DOCUMENT
 #  * `NULL` - NULL
 #  * `THINKING` - THINKING
+#  * `REFERENCE` - REFERENCE
   class VellumVariableType
 
     STRING = "STRING"
@@ -31,6 +32,7 @@ module Vellum
     DOCUMENT = "DOCUMENT"
     NULL = "NULL"
     THINKING = "THINKING"
+    REFERENCE = "REFERENCE"
 
   end
 end

data/lib/vellum_ai/uploaded_files/client.rb

@@ -48,6 +48,9 @@ end
 # Retrieve a previously uploaded file by its ID
     #
     # @param id [String] A UUID string identifying this uploaded file.
+    # @param expiry_seconds [Integer] The number of seconds until the signed URL expires. Must be > 0 and <= 2592000
+#  (30 days). Non-numeric or out-of-range values fall back to the default (604800
+#  seconds or 7 days).
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadedFileRead]
     # @example
@@ -57,7 +60,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.uploaded_files.retrieve(id: "id")
-    def retrieve(id:, request_options: nil)
+    def retrieve(id:, expiry_seconds: nil, request_options: nil)
       response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
     req.options.timeout = request_options.timeout_in_seconds
@@ -71,9 +74,7 @@ end
     req.headers["X-API-Version"] = "2025-07-30"
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
-  unless request_options.nil? || request_options&.additional_query_parameters.nil?
-    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-  end
+  req.params = { **(request_options&.additional_query_parameters || {}), "expiry_seconds": expiry_seconds }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -152,6 +153,9 @@ end
 # Retrieve a previously uploaded file by its ID
     #
     # @param id [String] A UUID string identifying this uploaded file.
+    # @param expiry_seconds [Integer] The number of seconds until the signed URL expires. Must be > 0 and <= 2592000
+#  (30 days). Non-numeric or out-of-range values fall back to the default (604800
+#  seconds or 7 days).
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadedFileRead]
     # @example
@@ -161,7 +165,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.uploaded_files.retrieve(id: "id")
-    def retrieve(id:, request_options: nil)
+    def retrieve(id:, expiry_seconds: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -176,9 +180,7 @@ end
     req.headers["X-API-Version"] = "2025-07-30"
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
-  unless request_options.nil? || request_options&.additional_query_parameters.nil?
-    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-  end
+  req.params = { **(request_options&.additional_query_parameters || {}), "expiry_seconds": expiry_seconds }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end

data/lib/vellum_ai.rb

@@ -44,6 +44,7 @@ require_relative "vellum_ai/types/execute_prompt_response"
 require_relative "vellum_ai/types/workflow_request_input_request"
 require_relative "vellum_ai/types/workflow_expand_meta_request"
 require_relative "vellum_ai/types/execute_workflow_response"
+require_relative "vellum_ai/types/execute_workflow_async_response"
 require_relative "vellum_ai/types/generate_request"
 require_relative "vellum_ai/types/generate_options_request"
 require_relative "vellum_ai/types/generate_response"
@@ -348,6 +349,53 @@ end
 end
       Vellum::ExecuteWorkflowResponse.from_json(json_object: response.body)
     end
+# Executes a deployed Workflow asynchronously and returns the execution ID.
+    #
+    # @param inputs [Array<Hash>] The list of inputs defined in the Workflow's Deployment with their corresponding
+#  values.Request of type Array<Vellum::WorkflowRequestInputRequest>, as a Hash
+    # @param workflow_deployment_id [String] The ID of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_name.
+    # @param workflow_deployment_name [String] The name of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_id.
+    # @param release_tag [String] Optionally specify a release tag if you want to pin to a specific release of the
+#  Workflow Deployment
+    # @param external_id [String] Optionally include a unique identifier for tracking purposes. Must be unique
+#  within a given Workspace.
+    # @param previous_execution_id [String] The ID of a previous Workflow Execution to reference for initial State loading.
+    # @param metadata [Hash{String => Object}] Arbitrary JSON metadata associated with this request. Can be used to capture
+#  additional monitoring data such as user id, session id, etc. for future
+#  analysis.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.execute_workflow_async(inputs: [{ name: "x", type: "STRING", value: "value" }, { name: "x", type: "STRING", value: "value" }])
+    def execute_workflow_async(inputs:, workflow_deployment_id: nil, workflow_deployment_name: nil, release_tag: nil, external_id: nil, previous_execution_id: nil, metadata: 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
+  end
+  unless request_options&.api_key.nil?
+    req.headers["X-API-KEY"] = request_options.api_key
+  end
+  unless request_options&.api_version.nil?
+    req.headers["X-API-Version"] = request_options.api_version
+  else
+    req.headers["X-API-Version"] = "2025-07-30"
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), inputs: inputs, workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, release_tag: release_tag, external_id: external_id, previous_execution_id: previous_execution_id, metadata: metadata }.compact
+  req.url "#{@request_client.get_url(environment: Predict, request_options: request_options)}/v1/execute-workflow-async"
+end
+      Vellum::ExecuteWorkflowAsyncResponse.from_json(json_object: response.body)
+    end
 # Generate a completion using a previously defined deployment.
 #  Important: This endpoint is DEPRECATED and has been superseded by
 #  [execute-prompt](/api-reference/api-reference/execute-prompt).
@@ -820,6 +868,53 @@ end
 end
       Vellum::ExecuteWorkflowResponse.from_json(json_object: response.body)
     end
+# Executes a deployed Workflow asynchronously and returns the execution ID.
+    #
+    # @param inputs [Array<Hash>] The list of inputs defined in the Workflow's Deployment with their corresponding
+#  values.Request of type Array<Vellum::WorkflowRequestInputRequest>, as a Hash
+    # @param workflow_deployment_id [String] The ID of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_name.
+    # @param workflow_deployment_name [String] The name of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_id.
+    # @param release_tag [String] Optionally specify a release tag if you want to pin to a specific release of the
+#  Workflow Deployment
+    # @param external_id [String] Optionally include a unique identifier for tracking purposes. Must be unique
+#  within a given Workspace.
+    # @param previous_execution_id [String] The ID of a previous Workflow Execution to reference for initial State loading.
+    # @param metadata [Hash{String => Object}] Arbitrary JSON metadata associated with this request. Can be used to capture
+#  additional monitoring data such as user id, session id, etc. for future
+#  analysis.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.execute_workflow_async(inputs: [{ name: "x", type: "STRING", value: "value" }, { name: "x", type: "STRING", value: "value" }])
+    def execute_workflow_async(inputs:, workflow_deployment_id: nil, workflow_deployment_name: nil, release_tag: nil, external_id: nil, previous_execution_id: nil, metadata: nil, request_options: nil)
+      response = @async_request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.api_key.nil?
+    req.headers["X-API-KEY"] = request_options.api_key
+  end
+  unless request_options&.api_version.nil?
+    req.headers["X-API-Version"] = request_options.api_version
+  else
+    req.headers["X-API-Version"] = "2025-07-30"
+  end
+  req.headers = { **(req.headers || {}), **@async_request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), inputs: inputs, workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, release_tag: release_tag, external_id: external_id, previous_execution_id: previous_execution_id, metadata: metadata }.compact
+  req.url "#{@async_request_client.get_url(environment: Predict, request_options: request_options)}/v1/execute-workflow-async"
+end
+      Vellum::ExecuteWorkflowAsyncResponse.from_json(json_object: response.body)
+    end
 # Generate a completion using a previously defined deployment.
 #  Important: This endpoint is DEPRECATED and has been superseded by
 #  [execute-prompt](/api-reference/api-reference/execute-prompt).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vellum_ai
 version: !ruby/object:Gem::Version
-  version: 1.10.9
+  version: 1.11.3
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -291,6 +291,7 @@ files:
 - lib/vellum_ai/types/execute_api_response_json.rb
 - lib/vellum_ai/types/execute_prompt_event.rb
 - lib/vellum_ai/types/execute_prompt_response.rb
+- lib/vellum_ai/types/execute_workflow_async_response.rb
 - lib/vellum_ai/types/execute_workflow_response.rb
 - lib/vellum_ai/types/execute_workflow_workflow_result_event.rb
 - lib/vellum_ai/types/execution_array_vellum_value.rb