datadog_api_client 2.54.0 → 2.55.0

data/lib/datadog_api_client/v2/api/llm_observability_api.rb

@@ -23,6 +23,248 @@ module DatadogAPIClient::V2
       @api_client = api_client
     end
 
+    # Aggregate LLM Observability experimentation.
+    #
+    # @see #aggregate_llm_obs_experimentation_with_http_info
+    def aggregate_llm_obs_experimentation(body, opts = {})
+      data, _status_code, _headers = aggregate_llm_obs_experimentation_with_http_info(body, opts)
+      data
+    end
+
+    # Aggregate LLM Observability experimentation.
+    #
+    # Execute an analytics aggregation over LLM Observability experimentation data.
+    # Use this endpoint to compute metrics (for example average eval scores) grouped by fields such as `span_id` or `experiment_id`.
+    #
+    # At least one `compute` definition and one `index` must be provided.
+    #
+    # @param body [LLMObsExperimentationAnalyticsRequest] Analytics payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsExperimentationAnalyticsResponse, Integer, Hash)>] LLMObsExperimentationAnalyticsResponse data, response status code and response headers
+    def aggregate_llm_obs_experimentation_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.aggregate_llm_obs_experimentation".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.aggregate_llm_obs_experimentation")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.aggregate_llm_obs_experimentation"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.aggregate_llm_obs_experimentation ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.aggregate_llm_obs_experimentation"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/experimentation/analytics'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentationAnalyticsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :aggregate_llm_obs_experimentation,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#aggregate_llm_obs_experimentation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Batch update LLM Observability dataset records.
+    #
+    # @see #batch_update_llm_obs_dataset_with_http_info
+    def batch_update_llm_obs_dataset(project_id, dataset_id, body, opts = {})
+      data, _status_code, _headers = batch_update_llm_obs_dataset_with_http_info(project_id, dataset_id, body, opts)
+      data
+    end
+
+    # Batch update LLM Observability dataset records.
+    #
+    # Insert, update, and delete records in a single dataset operation. By default, a new dataset version is created when the batch is applied.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param body [LLMObsDatasetBatchUpdateRequest] Batch update payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsDatasetRecordsMutationResponse, Integer, Hash)>] LLMObsDatasetRecordsMutationResponse data, response status code and response headers
+    def batch_update_llm_obs_dataset_with_http_info(project_id, dataset_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.batch_update_llm_obs_dataset".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.batch_update_llm_obs_dataset")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.batch_update_llm_obs_dataset"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.batch_update_llm_obs_dataset ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.batch_update_llm_obs_dataset"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.batch_update_llm_obs_dataset"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.batch_update_llm_obs_dataset"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/batch_update'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetRecordsMutationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :batch_update_llm_obs_dataset,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#batch_update_llm_obs_dataset\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Clone an LLM Observability dataset.
+    #
+    # @see #clone_llm_obs_dataset_with_http_info
+    def clone_llm_obs_dataset(project_id, dataset_id, body, opts = {})
+      data, _status_code, _headers = clone_llm_obs_dataset_with_http_info(project_id, dataset_id, body, opts)
+      data
+    end
+
+    # Clone an LLM Observability dataset.
+    #
+    # Clone a dataset, copying its current records into a new dataset within the same project.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the source LLM Observability dataset to clone.
+    # @param body [LLMObsDatasetCloneRequest] Clone dataset payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsDatasetResponse, Integer, Hash)>] LLMObsDatasetResponse data, response status code and response headers
+    def clone_llm_obs_dataset_with_http_info(project_id, dataset_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.clone_llm_obs_dataset".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.clone_llm_obs_dataset")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.clone_llm_obs_dataset"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.clone_llm_obs_dataset ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.clone_llm_obs_dataset"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.clone_llm_obs_dataset"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.clone_llm_obs_dataset"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/clone'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :clone_llm_obs_dataset,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#clone_llm_obs_dataset\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create an LLM Observability annotation queue.
     #
     # @see #create_llm_obs_annotation_queue_with_http_info
@@ -109,8 +351,16 @@ module DatadogAPIClient::V2
 
     # Add annotation queue interactions.
     #
-    # Add one or more interactions (traces or sessions) to an annotation queue.
-    # At least one interaction must be provided.
+    # Add one or more interactions to an annotation queue. At least one
+    # interaction must be provided. Each interaction has a `type`:
+    #
+    # - `trace`, `experiment_trace`, `session`: `content_id` references the
+    #   upstream entity; the server fetches the actual content.
+    # - `display_block`: omit `content_id` and provide the rendered content
+    #   in `display_block`. The server generates `content_id` as a
+    #   deterministic hash of the block list.
+    #
+    # Items of different types can be mixed in a single request.
     #
     # @param queue_id [String] The ID of the LLM Observability annotation queue.
     # @param body [LLMObsAnnotationQueueInteractionsRequest] Add interactions payload.
@@ -490,6 +740,94 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Run an LLM inference.
+    #
+    # @see #create_llm_obs_integration_inference_with_http_info
+    def create_llm_obs_integration_inference(integration, account_id, body, opts = {})
+      data, _status_code, _headers = create_llm_obs_integration_inference_with_http_info(integration, account_id, body, opts)
+      data
+    end
+
+    # Run an LLM inference.
+    #
+    # Run an LLM inference request through the specified integration and account, returning the model response and token usage.
+    #
+    # @param integration [LLMObsIntegrationName] The name of the LLM integration.
+    # @param account_id [String] The ID of the integration account.
+    # @param body [LLMObsIntegrationInferenceRequest] Inference request parameters.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsIntegrationInferenceResponse, Integer, Hash)>] LLMObsIntegrationInferenceResponse data, response status code and response headers
+    def create_llm_obs_integration_inference_with_http_info(integration, account_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_llm_obs_integration_inference".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_llm_obs_integration_inference")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_llm_obs_integration_inference"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.create_llm_obs_integration_inference ...'
+      end
+      # verify the required parameter 'integration' is set
+      if @api_client.config.client_side_validation && integration.nil?
+        fail ArgumentError, "Missing the required parameter 'integration' when calling LLMObservabilityAPI.create_llm_obs_integration_inference"
+      end
+      # verify enum value
+      allowable_values = ['openai', 'amazon_bedrock', 'anthropic', 'azure_openai', 'vertex_ai', 'llmproxy']
+      if @api_client.config.client_side_validation && !allowable_values.include?(integration)
+        fail ArgumentError, "invalid value for \"integration\", must be one of #{allowable_values}"
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling LLMObservabilityAPI.create_llm_obs_integration_inference"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.create_llm_obs_integration_inference"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/integrations/{integration}/{account_id}/inference'.sub('{integration}', CGI.escape(integration.to_s).gsub('%2F', '/')).sub('{account_id}', CGI.escape(account_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsIntegrationInferenceResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :create_llm_obs_integration_inference,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#create_llm_obs_integration_inference\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create an LLM Observability project.
     #
     # @see #create_llm_obs_project_with_http_info
@@ -712,21 +1050,99 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
-    # Delete a custom evaluator configuration.
+    # Delete annotations.
     #
-    # @see #delete_llm_obs_custom_eval_config_with_http_info
-    def delete_llm_obs_custom_eval_config(eval_name, opts = {})
-      delete_llm_obs_custom_eval_config_with_http_info(eval_name, opts)
-      nil
+    # @see #delete_llm_obs_annotations_with_http_info
+    def delete_llm_obs_annotations(queue_id, body, opts = {})
+      data, _status_code, _headers = delete_llm_obs_annotations_with_http_info(queue_id, body, opts)
+      data
     end
 
-    # Delete a custom evaluator configuration.
+    # Delete annotations.
     #
-    # Delete a custom LLM Observability evaluator configuration by its name.
+    # Delete one or more annotations from an annotation queue.
     #
-    # @param eval_name [String] The name of the custom LLM Observability evaluator configuration.
+    # @param queue_id [String] The ID of the LLM Observability annotation queue.
+    # @param body [LLMObsDeleteAnnotationsRequest] Delete annotations payload.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    # @return [Array<(LLMObsDeleteAnnotationsResponse, Integer, Hash)>] LLMObsDeleteAnnotationsResponse data, response status code and response headers
+    def delete_llm_obs_annotations_with_http_info(queue_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_llm_obs_annotations".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_llm_obs_annotations")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_llm_obs_annotations"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.delete_llm_obs_annotations ...'
+      end
+      # verify the required parameter 'queue_id' is set
+      if @api_client.config.client_side_validation && queue_id.nil?
+        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.delete_llm_obs_annotations"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.delete_llm_obs_annotations"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotations/delete'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDeleteAnnotationsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_llm_obs_annotations,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#delete_llm_obs_annotations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a custom evaluator configuration.
+    #
+    # @see #delete_llm_obs_custom_eval_config_with_http_info
+    def delete_llm_obs_custom_eval_config(eval_name, opts = {})
+      delete_llm_obs_custom_eval_config_with_http_info(eval_name, opts)
+      nil
+    end
+
+    # Delete a custom evaluator configuration.
+    #
+    # Delete a custom LLM Observability evaluator configuration by its name.
+    #
+    # @param eval_name [String] The name of the custom LLM Observability evaluator configuration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_llm_obs_custom_eval_config_with_http_info(eval_name, opts = {})
       unstable_enabled = @api_client.config.unstable_operations["v2.delete_llm_obs_custom_eval_config".to_sym]
       if unstable_enabled
@@ -783,6 +1199,79 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete LLM Observability data.
+    #
+    # @see #delete_llm_obs_data_with_http_info
+    def delete_llm_obs_data(body, opts = {})
+      data, _status_code, _headers = delete_llm_obs_data_with_http_info(body, opts)
+      data
+    end
+
+    # Delete LLM Observability data.
+    #
+    # Submit a request to delete LLM Observability span data matching a trace ID filter within a specified time range.
+    #
+    # @param body [LLMObsDataDeletionRequest] Data deletion request payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsDataDeletionResponse, Integer, Hash)>] LLMObsDataDeletionResponse data, response status code and response headers
+    def delete_llm_obs_data_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_llm_obs_data".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_llm_obs_data")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_llm_obs_data"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.delete_llm_obs_data ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.delete_llm_obs_data"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/deletion/data/llmobs'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDataDeletionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_llm_obs_data,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#delete_llm_obs_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete LLM Observability dataset records.
     #
     # @see #delete_llm_obs_dataset_records_with_http_info
@@ -1017,6 +1506,77 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete a patterns configuration.
+    #
+    # @see #delete_llm_obs_patterns_config_with_http_info
+    def delete_llm_obs_patterns_config(config_id, opts = {})
+      delete_llm_obs_patterns_config_with_http_info(config_id, opts)
+      nil
+    end
+
+    # Delete a patterns configuration.
+    #
+    # Delete a patterns configuration by its ID.
+    #
+    # @param config_id [String] The ID of the patterns configuration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_llm_obs_patterns_config_with_http_info(config_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_llm_obs_patterns_config".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_llm_obs_patterns_config")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_llm_obs_patterns_config"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.delete_llm_obs_patterns_config ...'
+      end
+      # verify the required parameter 'config_id' is set
+      if @api_client.config.client_side_validation && config_id.nil?
+        fail ArgumentError, "Missing the required parameter 'config_id' when calling LLMObservabilityAPI.delete_llm_obs_patterns_config"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-configs/{config_id}'.sub('{config_id}', CGI.escape(config_id.to_s).gsub('%2F', '/'))
+
+      # 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(['*/*'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_llm_obs_patterns_config,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#delete_llm_obs_patterns_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete LLM Observability projects.
     #
     # @see #delete_llm_obs_projects_with_http_info
@@ -1090,46 +1650,62 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
-    # Get annotated queue interactions.
+    # Export an LLM Observability dataset.
     #
-    # @see #get_llm_obs_annotated_interactions_with_http_info
-    def get_llm_obs_annotated_interactions(queue_id, opts = {})
-      data, _status_code, _headers = get_llm_obs_annotated_interactions_with_http_info(queue_id, opts)
+    # @see #export_llm_obs_dataset_with_http_info
+    def export_llm_obs_dataset(project_id, dataset_id, opts = {})
+      data, _status_code, _headers = export_llm_obs_dataset_with_http_info(project_id, dataset_id, opts)
       data
     end
 
-    # Get annotated queue interactions.
+    # Export an LLM Observability dataset.
     #
-    # Retrieve all interactions (traces and sessions) and their annotations for a given annotation queue.
+    # Download the contents of a dataset as a CSV file. The download is streamed and includes one row per dataset record.
     #
-    # @param queue_id [String] The ID of the LLM Observability annotation queue.
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(LLMObsAnnotatedInteractionsResponse, Integer, Hash)>] LLMObsAnnotatedInteractionsResponse data, response status code and response headers
-    def get_llm_obs_annotated_interactions_with_http_info(queue_id, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_annotated_interactions".to_sym]
+    # @option opts [LLMObsDatasetExportFormat] :format Export format for the dataset contents. Only `csv` is currently supported.
+    # @option opts [Integer] :version Version of the dataset to export. If omitted, the current version is used. Must be between 0 and the current version of the dataset, inclusive.
+    # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
+    def export_llm_obs_dataset_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.export_llm_obs_dataset".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_annotated_interactions")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.export_llm_obs_dataset")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_annotated_interactions"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.export_llm_obs_dataset"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_annotated_interactions ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.export_llm_obs_dataset ...'
       end
-      # verify the required parameter 'queue_id' is set
-      if @api_client.config.client_side_validation && queue_id.nil?
-        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions"
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.export_llm_obs_dataset"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.export_llm_obs_dataset"
+      end
+      allowable_values = ['csv']
+      if @api_client.config.client_side_validation && opts[:'format'] && !allowable_values.include?(opts[:'format'])
+        fail ArgumentError, "invalid value for \"format\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'version'].nil? && opts[:'version'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"version"]" when calling LLMObservabilityAPI.export_llm_obs_dataset, must be smaller than or equal to 2147483647.'
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/export'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'format'] = opts[:'format'] if !opts[:'format'].nil?
+      query_params[:'version'] = opts[:'version'] if !opts[:'version'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/csv', 'application/json'])
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1138,13 +1714,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsAnnotatedInteractionsResponse'
+      return_type = opts[:debug_return_type] || 'String'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :get_llm_obs_annotated_interactions,
+        :operation => :export_llm_obs_dataset,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1156,43 +1732,43 @@ module DatadogAPIClient::V2
 
       data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_annotated_interactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#export_llm_obs_dataset\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get annotation queue label schema.
+    # Get annotated queue interactions.
     #
-    # @see #get_llm_obs_annotation_queue_label_schema_with_http_info
-    def get_llm_obs_annotation_queue_label_schema(queue_id, opts = {})
-      data, _status_code, _headers = get_llm_obs_annotation_queue_label_schema_with_http_info(queue_id, opts)
+    # @see #get_llm_obs_annotated_interactions_with_http_info
+    def get_llm_obs_annotated_interactions(queue_id, opts = {})
+      data, _status_code, _headers = get_llm_obs_annotated_interactions_with_http_info(queue_id, opts)
       data
     end
 
-    # Get annotation queue label schema.
+    # Get annotated queue interactions.
     #
-    # Retrieve the label schema for a given annotation queue.
+    # Retrieve all interactions (traces and sessions) and their annotations for a given annotation queue.
     #
     # @param queue_id [String] The ID of the LLM Observability annotation queue.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(LLMObsAnnotationQueueLabelSchemaResponse, Integer, Hash)>] LLMObsAnnotationQueueLabelSchemaResponse data, response status code and response headers
-    def get_llm_obs_annotation_queue_label_schema_with_http_info(queue_id, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_annotation_queue_label_schema".to_sym]
+    # @return [Array<(LLMObsAnnotatedInteractionsResponse, Integer, Hash)>] LLMObsAnnotatedInteractionsResponse data, response status code and response headers
+    def get_llm_obs_annotated_interactions_with_http_info(queue_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_annotated_interactions".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_annotation_queue_label_schema")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_annotated_interactions")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_annotation_queue_label_schema"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_annotated_interactions"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_annotation_queue_label_schema ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_annotated_interactions ...'
       end
       # verify the required parameter 'queue_id' is set
       if @api_client.config.client_side_validation && queue_id.nil?
-        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.get_llm_obs_annotation_queue_label_schema"
+        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/label-schema'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1209,13 +1785,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsAnnotationQueueLabelSchemaResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsAnnotatedInteractionsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :get_llm_obs_annotation_queue_label_schema,
+        :operation => :get_llm_obs_annotated_interactions,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1227,46 +1803,64 @@ module DatadogAPIClient::V2
 
       data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_annotation_queue_label_schema\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_annotated_interactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get a custom evaluator configuration.
+    # Get annotated interactions by content IDs.
     #
-    # @see #get_llm_obs_custom_eval_config_with_http_info
-    def get_llm_obs_custom_eval_config(eval_name, opts = {})
-      data, _status_code, _headers = get_llm_obs_custom_eval_config_with_http_info(eval_name, opts)
+    # @see #get_llm_obs_annotated_interactions_by_trace_i_ds_with_http_info
+    def get_llm_obs_annotated_interactions_by_trace_i_ds(content_ids, opts = {})
+      data, _status_code, _headers = get_llm_obs_annotated_interactions_by_trace_i_ds_with_http_info(content_ids, opts)
       data
     end
 
-    # Get a custom evaluator configuration.
+    # Get annotated interactions by content IDs.
     #
-    # Retrieve a custom LLM Observability evaluator configuration by its name.
+    # Returns annotated interactions across all annotation queues for the given content IDs.
+    # Results include queue metadata (ID and name) for each interaction.
     #
-    # @param eval_name [String] The name of the custom LLM Observability evaluator configuration.
+    # @param content_ids [Array<String>] One or more content IDs to retrieve annotated interactions for. At least one is required.
     # @param opts [Hash] the optional parameters
-    # @return [Array<(LLMObsCustomEvalConfigResponse, Integer, Hash)>] LLMObsCustomEvalConfigResponse data, response status code and response headers
-    def get_llm_obs_custom_eval_config_with_http_info(eval_name, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_custom_eval_config".to_sym]
+    # @option opts [Integer] :offset Pagination offset. Must be >= 0. Defaults to 0.
+    # @option opts [Integer] :limit Maximum number of results to return. Must be > 0. Defaults to 100.
+    # @return [Array<(LLMObsAnnotatedInteractionsByTraceResponse, Integer, Hash)>] LLMObsAnnotatedInteractionsByTraceResponse data, response status code and response headers
+    def get_llm_obs_annotated_interactions_by_trace_i_ds_with_http_info(content_ids, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_annotated_interactions_by_trace_i_ds".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_custom_eval_config")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_annotated_interactions_by_trace_i_ds")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_custom_eval_config"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_annotated_interactions_by_trace_i_ds"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_custom_eval_config ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds ...'
       end
-      # verify the required parameter 'eval_name' is set
-      if @api_client.config.client_side_validation && eval_name.nil?
-        fail ArgumentError, "Missing the required parameter 'eval_name' when calling LLMObservabilityAPI.get_llm_obs_custom_eval_config"
+      # verify the required parameter 'content_ids' is set
+      if @api_client.config.client_side_validation && content_ids.nil?
+        fail ArgumentError, "Missing the required parameter 'content_ids' when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds"
       end
-      # resource path
-      local_var_path = '/api/unstable/llm-obs/config/evaluators/custom/{eval_name}'.sub('{eval_name}', CGI.escape(eval_name.to_s).gsub('%2F', '/'))
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds, must be smaller than or equal to 2147483647.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds, must be greater than or equal to 0.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds, must be smaller than or equal to 2147483647.'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling LLMObservabilityAPI.get_llm_obs_annotated_interactions_by_trace_i_ds, must be greater than or equal to 1.'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/annotated-interactions'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'contentIds'] = @api_client.build_collection_param(content_ids, :multi)
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1280,13 +1874,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsCustomEvalConfigResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsAnnotatedInteractionsByTraceResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :get_llm_obs_custom_eval_config,
+        :operation => :get_llm_obs_annotated_interactions_by_trace_i_ds,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1295,49 +1889,50 @@ module DatadogAPIClient::V2
         :return_type => return_type,
         :api_version => "V2"
       )
+      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
 
       data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_custom_eval_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_annotated_interactions_by_trace_i_ds\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List LLM Observability annotation queues.
+    # Get annotation queue label schema.
     #
-    # @see #list_llm_obs_annotation_queues_with_http_info
-    def list_llm_obs_annotation_queues(opts = {})
-      data, _status_code, _headers = list_llm_obs_annotation_queues_with_http_info(opts)
+    # @see #get_llm_obs_annotation_queue_label_schema_with_http_info
+    def get_llm_obs_annotation_queue_label_schema(queue_id, opts = {})
+      data, _status_code, _headers = get_llm_obs_annotation_queue_label_schema_with_http_info(queue_id, opts)
       data
     end
 
-    # List LLM Observability annotation queues.
+    # Get annotation queue label schema.
     #
-    # List annotation queues. Optionally filter by project ID or queue IDs. These parameters are mutually exclusive.
-    # If neither is provided, all queues in the organization are returned.
+    # Retrieve the label schema for a given annotation queue.
     #
+    # @param queue_id [String] The ID of the LLM Observability annotation queue.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :project_id Filter annotation queues by project ID. Cannot be used together with `queueIds`.
-    # @option opts [Array<String>] :queue_ids Filter annotation queues by queue IDs (comma-separated). Cannot be used together with `projectId`.
-    # @return [Array<(LLMObsAnnotationQueuesResponse, Integer, Hash)>] LLMObsAnnotationQueuesResponse data, response status code and response headers
-    def list_llm_obs_annotation_queues_with_http_info(opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_annotation_queues".to_sym]
+    # @return [Array<(LLMObsAnnotationQueueLabelSchemaResponse, Integer, Hash)>] LLMObsAnnotationQueueLabelSchemaResponse data, response status code and response headers
+    def get_llm_obs_annotation_queue_label_schema_with_http_info(queue_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_annotation_queue_label_schema".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_annotation_queues")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_annotation_queue_label_schema")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_annotation_queues"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_annotation_queue_label_schema"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_annotation_queues ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_annotation_queue_label_schema ...'
+      end
+      # verify the required parameter 'queue_id' is set
+      if @api_client.config.client_side_validation && queue_id.nil?
+        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.get_llm_obs_annotation_queue_label_schema"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/annotation-queues'
+      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/label-schema'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'projectId'] = opts[:'project_id'] if !opts[:'project_id'].nil?
-      query_params[:'queueIds'] = @api_client.build_collection_param(opts[:'queue_ids'], :multi) if !opts[:'queue_ids'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1351,13 +1946,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsAnnotationQueuesResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsAnnotationQueueLabelSchemaResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :list_llm_obs_annotation_queues,
+        :operation => :get_llm_obs_annotation_queue_label_schema,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1366,61 +1961,125 @@ module DatadogAPIClient::V2
         :return_type => return_type,
         :api_version => "V2"
       )
-      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
 
       data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_annotation_queues\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_annotation_queue_label_schema\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List LLM Observability dataset records.
+    # Get a custom evaluator configuration.
     #
-    # @see #list_llm_obs_dataset_records_with_http_info
-    def list_llm_obs_dataset_records(project_id, dataset_id, opts = {})
-      data, _status_code, _headers = list_llm_obs_dataset_records_with_http_info(project_id, dataset_id, opts)
+    # @see #get_llm_obs_custom_eval_config_with_http_info
+    def get_llm_obs_custom_eval_config(eval_name, opts = {})
+      data, _status_code, _headers = get_llm_obs_custom_eval_config_with_http_info(eval_name, opts)
       data
     end
 
-    # List LLM Observability dataset records.
+    # Get a custom evaluator configuration.
     #
-    # List all records in an LLM Observability dataset, sorted by creation date, newest first.
+    # Retrieve a custom LLM Observability evaluator configuration by its name.
+    #
+    # @param eval_name [String] The name of the custom LLM Observability evaluator configuration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsCustomEvalConfigResponse, Integer, Hash)>] LLMObsCustomEvalConfigResponse data, response status code and response headers
+    def get_llm_obs_custom_eval_config_with_http_info(eval_name, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_custom_eval_config".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_custom_eval_config")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_custom_eval_config"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_custom_eval_config ...'
+      end
+      # verify the required parameter 'eval_name' is set
+      if @api_client.config.client_side_validation && eval_name.nil?
+        fail ArgumentError, "Missing the required parameter 'eval_name' when calling LLMObservabilityAPI.get_llm_obs_custom_eval_config"
+      end
+      # resource path
+      local_var_path = '/api/unstable/llm-obs/config/evaluators/custom/{eval_name}'.sub('{eval_name}', CGI.escape(eval_name.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsCustomEvalConfigResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_llm_obs_custom_eval_config,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_custom_eval_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get LLM Observability dataset draft state.
+    #
+    # @see #get_llm_obs_dataset_draft_state_with_http_info
+    def get_llm_obs_dataset_draft_state(project_id, dataset_id, opts = {})
+      data, _status_code, _headers = get_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts)
+      data
+    end
+
+    # Get LLM Observability dataset draft state.
+    #
+    # Retrieve the draft state of a dataset, including whether it is currently locked for editing and which user holds the lock.
     #
     # @param project_id [String] The ID of the LLM Observability project.
     # @param dataset_id [String] The ID of the LLM Observability dataset.
     # @param opts [Hash] the optional parameters
-    # @option opts [Integer] :filter_version Retrieve records from a specific dataset version. Defaults to the current version.
-    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
-    # @option opts [Integer] :page_limit Maximum number of results to return per page.
-    # @return [Array<(LLMObsDatasetRecordsListResponse, Integer, Hash)>] LLMObsDatasetRecordsListResponse data, response status code and response headers
-    def list_llm_obs_dataset_records_with_http_info(project_id, dataset_id, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_dataset_records".to_sym]
+    # @return [Array<(LLMObsDatasetDraftStateResponse, Integer, Hash)>] LLMObsDatasetDraftStateResponse data, response status code and response headers
+    def get_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_dataset_draft_state".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_dataset_records")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_dataset_draft_state")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_dataset_records"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_dataset_draft_state"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_dataset_records ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_dataset_draft_state ...'
       end
       # verify the required parameter 'project_id' is set
       if @api_client.config.client_side_validation && project_id.nil?
-        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_records"
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.get_llm_obs_dataset_draft_state"
       end
       # verify the required parameter 'dataset_id' is set
       if @api_client.config.client_side_validation && dataset_id.nil?
-        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_records"
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.get_llm_obs_dataset_draft_state"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/records'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/draft_state'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[version]'] = opts[:'filter_version'] if !opts[:'filter_version'].nil?
-      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
-      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1434,13 +2093,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsDatasetRecordsListResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetDraftStateResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :list_llm_obs_dataset_records,
+        :operation => :get_llm_obs_dataset_draft_state,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1452,54 +2111,114 @@ module DatadogAPIClient::V2
 
       data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_dataset_records\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_dataset_draft_state\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List LLM Observability datasets.
+    # Get a patterns configuration.
     #
-    # @see #list_llm_obs_datasets_with_http_info
-    def list_llm_obs_datasets(project_id, opts = {})
-      data, _status_code, _headers = list_llm_obs_datasets_with_http_info(project_id, opts)
+    # @see #get_llm_obs_patterns_config_with_http_info
+    def get_llm_obs_patterns_config(opts = {})
+      data, _status_code, _headers = get_llm_obs_patterns_config_with_http_info(opts)
       data
     end
 
-    # List LLM Observability datasets.
+    # Get a patterns configuration.
     #
-    # List all LLM Observability datasets for a project, sorted by creation date, newest first.
+    # Retrieve the patterns configuration for the organization.
     #
-    # @param project_id [String] The ID of the LLM Observability project.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_name Filter datasets by name.
-    # @option opts [String] :filter_id Filter datasets by dataset ID.
-    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
-    # @option opts [Integer] :page_limit Maximum number of results to return per page.
-    # @return [Array<(LLMObsDatasetsResponse, Integer, Hash)>] LLMObsDatasetsResponse data, response status code and response headers
-    def list_llm_obs_datasets_with_http_info(project_id, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_datasets".to_sym]
+    # @return [Array<(LLMObsPatternsConfigResponse, Integer, Hash)>] LLMObsPatternsConfigResponse data, response status code and response headers
+    def get_llm_obs_patterns_config_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_patterns_config".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_datasets")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_patterns_config")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_datasets"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_patterns_config"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_datasets ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_patterns_config ...'
       end
-      # verify the required parameter 'project_id' is set
-      if @api_client.config.client_side_validation && project_id.nil?
-        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.list_llm_obs_datasets"
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-configs/latest'
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsConfigResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_llm_obs_patterns_config,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_patterns_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get patterns run status.
+    #
+    # @see #get_llm_obs_patterns_run_status_with_http_info
+    def get_llm_obs_patterns_run_status(config_id, opts = {})
+      data, _status_code, _headers = get_llm_obs_patterns_run_status_with_http_info(config_id, opts)
+      data
+    end
+
+    # Get patterns run status.
+    #
+    # Retrieve the status and step-by-step progress of the current or most recent
+    # patterns run for a configuration.
+    #
+    # @param config_id [String] The ID of the patterns configuration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsPatternsRunStatusResponse, Integer, Hash)>] LLMObsPatternsRunStatusResponse data, response status code and response headers
+    def get_llm_obs_patterns_run_status_with_http_info(config_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_llm_obs_patterns_run_status".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_llm_obs_patterns_run_status")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_llm_obs_patterns_run_status"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.get_llm_obs_patterns_run_status ...'
+      end
+      # verify the required parameter 'config_id' is set
+      if @api_client.config.client_side_validation && config_id.nil?
+        fail ArgumentError, "Missing the required parameter 'config_id' when calling LLMObservabilityAPI.get_llm_obs_patterns_run_status"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/'))
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-runs/status'
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
-      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
-      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
-      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+      query_params[:'config_id'] = config_id
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1513,13 +2232,1712 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsDatasetsResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsRunStatusResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_llm_obs_patterns_run_status,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#get_llm_obs_patterns_run_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability annotation queues.
+    #
+    # @see #list_llm_obs_annotation_queues_with_http_info
+    def list_llm_obs_annotation_queues(opts = {})
+      data, _status_code, _headers = list_llm_obs_annotation_queues_with_http_info(opts)
+      data
+    end
+
+    # List LLM Observability annotation queues.
+    #
+    # List annotation queues. Optionally filter by project ID or queue IDs. These parameters are mutually exclusive.
+    # If neither is provided, all queues in the organization are returned.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :project_id Filter annotation queues by project ID. Cannot be used together with `queueIds`.
+    # @option opts [Array<String>] :queue_ids Filter annotation queues by queue IDs (comma-separated). Cannot be used together with `projectId`.
+    # @return [Array<(LLMObsAnnotationQueuesResponse, Integer, Hash)>] LLMObsAnnotationQueuesResponse data, response status code and response headers
+    def list_llm_obs_annotation_queues_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_annotation_queues".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_annotation_queues")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_annotation_queues"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_annotation_queues ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/annotation-queues'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'projectId'] = opts[:'project_id'] if !opts[:'project_id'].nil?
+      query_params[:'queueIds'] = @api_client.build_collection_param(opts[:'queue_ids'], :multi) if !opts[:'queue_ids'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsAnnotationQueuesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_annotation_queues,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_annotation_queues\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability dataset records.
+    #
+    # @see #list_llm_obs_dataset_records_with_http_info
+    def list_llm_obs_dataset_records(project_id, dataset_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_dataset_records_with_http_info(project_id, dataset_id, opts)
+      data
+    end
+
+    # List LLM Observability dataset records.
+    #
+    # List all records in an LLM Observability dataset, sorted by creation date, newest first.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :filter_version Retrieve records from a specific dataset version. Defaults to the current version.
+    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
+    # @option opts [Integer] :page_limit Maximum number of results to return per page.
+    # @return [Array<(LLMObsDatasetRecordsListResponse, Integer, Hash)>] LLMObsDatasetRecordsListResponse data, response status code and response headers
+    def list_llm_obs_dataset_records_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_dataset_records".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_dataset_records")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_dataset_records"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_dataset_records ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_records"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_records"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/records'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[version]'] = opts[:'filter_version'] if !opts[:'filter_version'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetRecordsListResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_dataset_records,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_dataset_records\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability datasets.
+    #
+    # @see #list_llm_obs_datasets_with_http_info
+    def list_llm_obs_datasets(project_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_datasets_with_http_info(project_id, opts)
+      data
+    end
+
+    # List LLM Observability datasets.
+    #
+    # List all LLM Observability datasets for a project, sorted by creation date, newest first.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_name Filter datasets by name.
+    # @option opts [String] :filter_id Filter datasets by dataset ID.
+    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
+    # @option opts [Integer] :page_limit Maximum number of results to return per page.
+    # @return [Array<(LLMObsDatasetsResponse, Integer, Hash)>] LLMObsDatasetsResponse data, response status code and response headers
+    def list_llm_obs_datasets_with_http_info(project_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_datasets".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_datasets")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_datasets"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_datasets ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.list_llm_obs_datasets"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
+      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_datasets,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_datasets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability dataset versions.
+    #
+    # @see #list_llm_obs_dataset_versions_with_http_info
+    def list_llm_obs_dataset_versions(project_id, dataset_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_dataset_versions_with_http_info(project_id, dataset_id, opts)
+      data
+    end
+
+    # List LLM Observability dataset versions.
+    #
+    # List the active versions of a dataset. A version is created each time a dataset is referenced by an experiment run.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsDatasetVersionsResponse, Integer, Hash)>] LLMObsDatasetVersionsResponse data, response status code and response headers
+    def list_llm_obs_dataset_versions_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_dataset_versions".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_dataset_versions")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_dataset_versions"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_dataset_versions ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_versions"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.list_llm_obs_dataset_versions"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/versions'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetVersionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_dataset_versions,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_dataset_versions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List events for an LLM Observability experiment.
+    #
+    # @see #list_llm_obs_experiment_events_with_http_info
+    def list_llm_obs_experiment_events(experiment_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_experiment_events_with_http_info(experiment_id, opts)
+      data
+    end
+
+    # List events for an LLM Observability experiment.
+    #
+    # Retrieve spans and experiment-level summary metrics for a given experiment with cursor-based pagination.
+    #
+    # @param experiment_id [String] The ID of the LLM Observability experiment.
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :page_limit Maximum number of spans to return per page. Defaults to 5000.
+    # @option opts [String] :page_cursor Opaque cursor from a previous response to fetch the next page of results.
+    # @return [Array<(LLMObsExperimentEventsV2Response, Integer, Hash)>] LLMObsExperimentEventsV2Response data, response status code and response headers
+    def list_llm_obs_experiment_events_with_http_info(experiment_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_experiment_events".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_experiment_events")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_experiment_events"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_experiment_events ...'
+      end
+      # verify the required parameter 'experiment_id' is set
+      if @api_client.config.client_side_validation && experiment_id.nil?
+        fail ArgumentError, "Missing the required parameter 'experiment_id' when calling LLMObservabilityAPI.list_llm_obs_experiment_events"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v3/experiments/{experiment_id}/events'.sub('{experiment_id}', CGI.escape(experiment_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentEventsV2Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_experiment_events,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_experiment_events\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability experiment spans (v1).
+    #
+    # @see #list_llm_obs_experiment_events_v1_with_http_info
+    def list_llm_obs_experiment_events_v1(experiment_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_experiment_events_v1_with_http_info(experiment_id, opts)
+      data
+    end
+
+    # List LLM Observability experiment spans (v1).
+    #
+    # Retrieve spans with their evaluation metrics for a given experiment. Returns spans only, with no summary metrics and no pagination. Deprecated in favor of `ListLLMObsExperimentEventsV3`.
+    #
+    # @deprecated This API is deprecated.
+    #
+    # @param experiment_id [String] The ID of the LLM Observability experiment.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsExperimentSpansResponse, Integer, Hash)>] LLMObsExperimentSpansResponse data, response status code and response headers
+    def list_llm_obs_experiment_events_v1_with_http_info(experiment_id, opts = {})
+      warn "[DEPRECATION] `ListLLMObsExperimentEventsV1` is deprecated."
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_experiment_events_v1".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_experiment_events_v1")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_experiment_events_v1"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_experiment_events_v1 ...'
+      end
+      # verify the required parameter 'experiment_id' is set
+      if @api_client.config.client_side_validation && experiment_id.nil?
+        fail ArgumentError, "Missing the required parameter 'experiment_id' when calling LLMObservabilityAPI.list_llm_obs_experiment_events_v1"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/experiments/{experiment_id}/events'.sub('{experiment_id}', CGI.escape(experiment_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentSpansResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_experiment_events_v1,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_experiment_events_v1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability experiment events (v2).
+    #
+    # @see #list_llm_obs_experiment_events_v2_with_http_info
+    def list_llm_obs_experiment_events_v2(experiment_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_experiment_events_v2_with_http_info(experiment_id, opts)
+      data
+    end
+
+    # List LLM Observability experiment events (v2).
+    #
+    # Retrieve spans and experiment-level summary metrics for a given experiment. Returns the full events payload without pagination. Deprecated: use `ListLLMObsExperimentEventsV3` instead.
+    #
+    # @deprecated This API is deprecated.
+    #
+    # @param experiment_id [String] The ID of the LLM Observability experiment.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsExperimentEventsV2Response, Integer, Hash)>] LLMObsExperimentEventsV2Response data, response status code and response headers
+    def list_llm_obs_experiment_events_v2_with_http_info(experiment_id, opts = {})
+      warn "[DEPRECATION] `ListLLMObsExperimentEventsV2` is deprecated."
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_experiment_events_v2".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_experiment_events_v2")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_experiment_events_v2"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_experiment_events_v2 ...'
+      end
+      # verify the required parameter 'experiment_id' is set
+      if @api_client.config.client_side_validation && experiment_id.nil?
+        fail ArgumentError, "Missing the required parameter 'experiment_id' when calling LLMObservabilityAPI.list_llm_obs_experiment_events_v2"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v2/experiments/{experiment_id}/events'.sub('{experiment_id}', CGI.escape(experiment_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentEventsV2Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_experiment_events_v2,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_experiment_events_v2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability experiments.
+    #
+    # @see #list_llm_obs_experiments_with_http_info
+    def list_llm_obs_experiments(opts = {})
+      data, _status_code, _headers = list_llm_obs_experiments_with_http_info(opts)
+      data
+    end
+
+    # List LLM Observability experiments.
+    #
+    # List all LLM Observability experiments sorted by creation date, newest first.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_project_id Filter experiments by project ID. Required if `filter[dataset_id]` is not provided.
+    # @option opts [String] :filter_dataset_id Filter experiments by dataset ID.
+    # @option opts [String] :filter_id Filter experiments by experiment ID. Can be specified multiple times.
+    # @option opts [String] :filter_name Filter experiments by their exact run name.
+    # @option opts [String] :filter_experiment Filter by logical experiment name. This is the `name` field set when creating an experiment through `POST /experiments`. Returns all experiment runs that share the same name, enabling cross-commit and cross-branch comparisons.
+    # @option opts [String] :filter_metadata Filter by JSONB metadata containment. Provide a JSON object string where experiments whose metadata contains all specified key-value pairs are returned. For example: `{"commit":"abc123","branch":"main"}`.
+    # @option opts [String] :filter_parent_experiment_id Filter experiments by the ID of their parent (baseline) experiment. Returns all experiments that were run against the given baseline. Can be specified multiple times.
+    # @option opts [Boolean] :filter_is_deleted When `true`, return only soft-deleted experiments. Defaults to `false`.
+    # @option opts [Boolean] :include_user_data When `true`, enrich each experiment with its author's user data in the `author` field.
+    # @option opts [Boolean] :include_dataset_names When `true`, enrich each experiment with its dataset name in the `dataset_name` field.
+    # @option opts [String] :page_cursor Use the pagination cursor returned in `meta.after` to retrieve the next page of results.
+    # @option opts [Integer] :page_limit Maximum number of results to return per page. Values above 5000 are clamped to 5000. Defaults to 5000.
+    # @return [Array<(LLMObsExperimentsResponse, Integer, Hash)>] LLMObsExperimentsResponse data, response status code and response headers
+    def list_llm_obs_experiments_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_experiments".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_experiments")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_experiments"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_experiments ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'page_limit'].nil? && opts[:'page_limit'] > 5000
+        fail ArgumentError, 'invalid value for "opts[:"page_limit"]" when calling LLMObservabilityAPI.list_llm_obs_experiments, must be smaller than or equal to 5000.'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/experiments'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[project_id]'] = opts[:'filter_project_id'] if !opts[:'filter_project_id'].nil?
+      query_params[:'filter[dataset_id]'] = opts[:'filter_dataset_id'] if !opts[:'filter_dataset_id'].nil?
+      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
+      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
+      query_params[:'filter[experiment]'] = opts[:'filter_experiment'] if !opts[:'filter_experiment'].nil?
+      query_params[:'filter[metadata]'] = opts[:'filter_metadata'] if !opts[:'filter_metadata'].nil?
+      query_params[:'filter[parent_experiment_id]'] = opts[:'filter_parent_experiment_id'] if !opts[:'filter_parent_experiment_id'].nil?
+      query_params[:'filter[is_deleted]'] = opts[:'filter_is_deleted'] if !opts[:'filter_is_deleted'].nil?
+      query_params[:'include[user_data]'] = opts[:'include_user_data'] if !opts[:'include_user_data'].nil?
+      query_params[:'include[dataset_names]'] = opts[:'include_dataset_names'] if !opts[:'include_dataset_names'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_experiments,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_experiments\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM integration accounts.
+    #
+    # @see #list_llm_obs_integration_accounts_with_http_info
+    def list_llm_obs_integration_accounts(integration, opts = {})
+      data, _status_code, _headers = list_llm_obs_integration_accounts_with_http_info(integration, opts)
+      data
+    end
+
+    # List LLM integration accounts.
+    #
+    # Retrieve the list of configured accounts for the specified LLM provider integration.
+    #
+    # @param integration [LLMObsIntegrationName] The name of the LLM integration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(Array<LLMObsIntegrationAccount>, Integer, Hash)>] Array<LLMObsIntegrationAccount> data, response status code and response headers
+    def list_llm_obs_integration_accounts_with_http_info(integration, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_integration_accounts".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_integration_accounts")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_integration_accounts"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_integration_accounts ...'
+      end
+      # verify the required parameter 'integration' is set
+      if @api_client.config.client_side_validation && integration.nil?
+        fail ArgumentError, "Missing the required parameter 'integration' when calling LLMObservabilityAPI.list_llm_obs_integration_accounts"
+      end
+      # verify enum value
+      allowable_values = ['openai', 'amazon_bedrock', 'anthropic', 'azure_openai', 'vertex_ai', 'llmproxy']
+      if @api_client.config.client_side_validation && !allowable_values.include?(integration)
+        fail ArgumentError, "invalid value for \"integration\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/integrations/{integration}/accounts'.sub('{integration}', CGI.escape(integration.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<LLMObsIntegrationAccount>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_integration_accounts,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_integration_accounts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM integration models.
+    #
+    # @see #list_llm_obs_integration_models_with_http_info
+    def list_llm_obs_integration_models(integration, account_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_integration_models_with_http_info(integration, account_id, opts)
+      data
+    end
+
+    # List LLM integration models.
+    #
+    # Retrieve the list of models available for the specified LLM provider integration and account.
+    #
+    # @param integration [LLMObsIntegrationName] The name of the LLM integration.
+    # @param account_id [String] The ID of the integration account.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(Array<LLMObsIntegrationModel>, Integer, Hash)>] Array<LLMObsIntegrationModel> data, response status code and response headers
+    def list_llm_obs_integration_models_with_http_info(integration, account_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_integration_models".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_integration_models")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_integration_models"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_integration_models ...'
+      end
+      # verify the required parameter 'integration' is set
+      if @api_client.config.client_side_validation && integration.nil?
+        fail ArgumentError, "Missing the required parameter 'integration' when calling LLMObservabilityAPI.list_llm_obs_integration_models"
+      end
+      # verify enum value
+      allowable_values = ['openai', 'amazon_bedrock', 'anthropic', 'azure_openai', 'vertex_ai', 'llmproxy']
+      if @api_client.config.client_side_validation && !allowable_values.include?(integration)
+        fail ArgumentError, "invalid value for \"integration\", must be one of #{allowable_values}"
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling LLMObservabilityAPI.list_llm_obs_integration_models"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/integrations/{integration}/{account_id}/models'.sub('{integration}', CGI.escape(integration.to_s).gsub('%2F', '/')).sub('{account_id}', CGI.escape(account_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<LLMObsIntegrationModel>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_integration_models,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_integration_models\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List patterns clustered points.
+    #
+    # @see #list_llm_obs_patterns_clustered_points_with_http_info
+    def list_llm_obs_patterns_clustered_points(topic_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_patterns_clustered_points_with_http_info(topic_id, opts)
+      data
+    end
+
+    # List patterns clustered points.
+    #
+    # List the data points grouped into a topic. For a parent topic, points from all
+    # of its leaf topics are returned.
+    #
+    # @param topic_id [String] The ID of the topic to retrieve clustered points for.
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :page_size Maximum number of clustered points to return per page.
+    # @option opts [String] :page_token Pagination token to retrieve the next page of clustered points.
+    # @return [Array<(LLMObsPatternsClusteredPointsResponse, Integer, Hash)>] LLMObsPatternsClusteredPointsResponse data, response status code and response headers
+    def list_llm_obs_patterns_clustered_points_with_http_info(topic_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_patterns_clustered_points".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_patterns_clustered_points")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_patterns_clustered_points"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_patterns_clustered_points ...'
+      end
+      # verify the required parameter 'topic_id' is set
+      if @api_client.config.client_side_validation && topic_id.nil?
+        fail ArgumentError, "Missing the required parameter 'topic_id' when calling LLMObservabilityAPI.list_llm_obs_patterns_clustered_points"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-clustered-points'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'topic_id'] = topic_id
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'page_token'] = opts[:'page_token'] if !opts[:'page_token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsClusteredPointsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_patterns_clustered_points,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_patterns_clustered_points\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List patterns configurations.
+    #
+    # @see #list_llm_obs_patterns_configs_with_http_info
+    def list_llm_obs_patterns_configs(opts = {})
+      data, _status_code, _headers = list_llm_obs_patterns_configs_with_http_info(opts)
+      data
+    end
+
+    # List patterns configurations.
+    #
+    # List all patterns configurations for the organization.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsPatternsConfigsResponse, Integer, Hash)>] LLMObsPatternsConfigsResponse data, response status code and response headers
+    def list_llm_obs_patterns_configs_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_patterns_configs".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_patterns_configs")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_patterns_configs"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_patterns_configs ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-configs'
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsConfigsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_patterns_configs,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_patterns_configs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List patterns runs.
+    #
+    # @see #list_llm_obs_patterns_runs_with_http_info
+    def list_llm_obs_patterns_runs(config_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_patterns_runs_with_http_info(config_id, opts)
+      data
+    end
+
+    # List patterns runs.
+    #
+    # List the completed patterns runs for a configuration.
+    #
+    # @param config_id [String] The ID of the patterns configuration.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsPatternsRunsResponse, Integer, Hash)>] LLMObsPatternsRunsResponse data, response status code and response headers
+    def list_llm_obs_patterns_runs_with_http_info(config_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_patterns_runs".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_patterns_runs")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_patterns_runs"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_patterns_runs ...'
+      end
+      # verify the required parameter 'config_id' is set
+      if @api_client.config.client_side_validation && config_id.nil?
+        fail ArgumentError, "Missing the required parameter 'config_id' when calling LLMObservabilityAPI.list_llm_obs_patterns_runs"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-runs'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'config_id'] = config_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsRunsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_patterns_runs,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_patterns_runs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List patterns topics.
+    #
+    # @see #list_llm_obs_patterns_topics_with_http_info
+    def list_llm_obs_patterns_topics(config_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_patterns_topics_with_http_info(config_id, opts)
+      data
+    end
+
+    # List patterns topics.
+    #
+    # List the topics discovered by a patterns run. When no run is specified,
+    # the most recent completed run is used.
+    #
+    # @param config_id [String] The ID of the patterns configuration.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :run_id The ID of a specific patterns run. Defaults to the most recent completed run.
+    # @return [Array<(LLMObsPatternsTopicsResponse, Integer, Hash)>] LLMObsPatternsTopicsResponse data, response status code and response headers
+    def list_llm_obs_patterns_topics_with_http_info(config_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_patterns_topics".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_patterns_topics")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_patterns_topics"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_patterns_topics ...'
+      end
+      # verify the required parameter 'config_id' is set
+      if @api_client.config.client_side_validation && config_id.nil?
+        fail ArgumentError, "Missing the required parameter 'config_id' when calling LLMObservabilityAPI.list_llm_obs_patterns_topics"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-topics'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'config_id'] = config_id
+      query_params[:'run_id'] = opts[:'run_id'] if !opts[:'run_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsTopicsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_patterns_topics,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_patterns_topics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List patterns topics with clustered points.
+    #
+    # @see #list_llm_obs_patterns_topics_with_clustered_points_with_http_info
+    def list_llm_obs_patterns_topics_with_clustered_points(config_id, opts = {})
+      data, _status_code, _headers = list_llm_obs_patterns_topics_with_clustered_points_with_http_info(config_id, opts)
+      data
+    end
+
+    # List patterns topics with clustered points.
+    #
+    # List the topics discovered by a patterns run, with the clustered points attached
+    # inline to each leaf topic. When no run is specified, the most recent completed
+    # run is used.
+    #
+    # @param config_id [String] The ID of the patterns configuration.
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :run_id The ID of a specific patterns run. Defaults to the most recent completed run.
+    # @option opts [Boolean] :include_metrics When true, enrich each clustered point with span metrics such as status, duration, token counts, estimated cost, and evaluations.
+    # @return [Array<(LLMObsPatternsTopicsWithClusteredPointsResponse, Integer, Hash)>] LLMObsPatternsTopicsWithClusteredPointsResponse data, response status code and response headers
+    def list_llm_obs_patterns_topics_with_clustered_points_with_http_info(config_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_patterns_topics_with_clustered_points".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_patterns_topics_with_clustered_points")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_patterns_topics_with_clustered_points"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_patterns_topics_with_clustered_points ...'
+      end
+      # verify the required parameter 'config_id' is set
+      if @api_client.config.client_side_validation && config_id.nil?
+        fail ArgumentError, "Missing the required parameter 'config_id' when calling LLMObservabilityAPI.list_llm_obs_patterns_topics_with_clustered_points"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-topics/with-cluster-points'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'config_id'] = config_id
+      query_params[:'run_id'] = opts[:'run_id'] if !opts[:'run_id'].nil?
+      query_params[:'include_metrics'] = opts[:'include_metrics'] if !opts[:'include_metrics'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsTopicsWithClusteredPointsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_patterns_topics_with_clustered_points,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_patterns_topics_with_clustered_points\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability projects.
+    #
+    # @see #list_llm_obs_projects_with_http_info
+    def list_llm_obs_projects(opts = {})
+      data, _status_code, _headers = list_llm_obs_projects_with_http_info(opts)
+      data
+    end
+
+    # List LLM Observability projects.
+    #
+    # List all LLM Observability projects sorted by creation date, newest first.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_id Filter projects by project ID.
+    # @option opts [String] :filter_name Filter projects by name.
+    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
+    # @option opts [Integer] :page_limit Maximum number of results to return per page.
+    # @return [Array<(LLMObsProjectsResponse, Integer, Hash)>] LLMObsProjectsResponse data, response status code and response headers
+    def list_llm_obs_projects_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_projects".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_projects")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_projects"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_projects ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/projects'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
+      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsProjectsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_projects,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_projects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List LLM Observability spans.
+    #
+    # @see #list_llm_obs_spans_with_http_info
+    def list_llm_obs_spans(opts = {})
+      data, _status_code, _headers = list_llm_obs_spans_with_http_info(opts)
+      data
+    end
+
+    # List LLM Observability spans.
+    #
+    # List LLM Observability spans matching the specified filters.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :filter_from Start of the time range. Accepts ISO 8601 or relative format (e.g., `now-15m`). Defaults to `now-15m`.
+    # @option opts [String] :filter_to End of the time range. Accepts ISO 8601 or relative format. Defaults to `now`.
+    # @option opts [String] :filter_query Search query using LLM Observability query syntax. Supports attribute filters using the field:value syntax (e.g. session_id, trace_id, ml_app, meta.span.kind). When provided, structured field filters (`filter[span_id]`, `filter[trace_id]`, etc.) are ignored.
+    # @option opts [String] :filter_span_id Filter by exact span ID.
+    # @option opts [String] :filter_trace_id Filter by exact trace ID.
+    # @option opts [String] :filter_span_kind Filter by span kind (e.g., llm, agent, tool, task, workflow).
+    # @option opts [String] :filter_span_name Filter by span name.
+    # @option opts [String] :filter_ml_app Filter by ML application name.
+    # @option opts [Integer] :page_limit Maximum number of spans to return. Defaults to `10`.
+    # @option opts [String] :page_cursor Cursor from the previous response to retrieve the next page.
+    # @option opts [String] :sort Sort order for the results.
+    # @option opts [Boolean] :include_attachments Whether to include attachment data in the response. Defaults to `true`.
+    # @return [Array<(LLMObsSpansResponse, Integer, Hash)>] LLMObsSpansResponse data, response status code and response headers
+    def list_llm_obs_spans_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_spans".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_spans")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_spans"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_spans ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/spans/events'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[from]'] = opts[:'filter_from'] if !opts[:'filter_from'].nil?
+      query_params[:'filter[to]'] = opts[:'filter_to'] if !opts[:'filter_to'].nil?
+      query_params[:'filter[query]'] = opts[:'filter_query'] if !opts[:'filter_query'].nil?
+      query_params[:'filter[span_id]'] = opts[:'filter_span_id'] if !opts[:'filter_span_id'].nil?
+      query_params[:'filter[trace_id]'] = opts[:'filter_trace_id'] if !opts[:'filter_trace_id'].nil?
+      query_params[:'filter[span_kind]'] = opts[:'filter_span_kind'] if !opts[:'filter_span_kind'].nil?
+      query_params[:'filter[span_name]'] = opts[:'filter_span_name'] if !opts[:'filter_span_name'].nil?
+      query_params[:'filter[ml_app]'] = opts[:'filter_ml_app'] if !opts[:'filter_ml_app'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'include_attachments'] = opts[:'include_attachments'] if !opts[:'include_attachments'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsSpansResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_llm_obs_spans,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_spans\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Lock LLM Observability dataset draft state.
+    #
+    # @see #lock_llm_obs_dataset_draft_state_with_http_info
+    def lock_llm_obs_dataset_draft_state(project_id, dataset_id, opts = {})
+      data, _status_code, _headers = lock_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts)
+      data
+    end
+
+    # Lock LLM Observability dataset draft state.
+    #
+    # Acquire the draft lock on a dataset for the calling user. The lock prevents other users from concurrently editing the dataset draft.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsDatasetDraftStateResponse, Integer, Hash)>] LLMObsDatasetDraftStateResponse data, response status code and response headers
+    def lock_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.lock_llm_obs_dataset_draft_state".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.lock_llm_obs_dataset_draft_state")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.lock_llm_obs_dataset_draft_state"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.lock_llm_obs_dataset_draft_state ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.lock_llm_obs_dataset_draft_state"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.lock_llm_obs_dataset_draft_state"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/draft_state/lock'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsDatasetDraftStateResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :lock_llm_obs_dataset_draft_state,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Patch, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#lock_llm_obs_dataset_draft_state\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Restore an LLM Observability dataset version.
+    #
+    # @see #restore_llm_obs_dataset_version_with_http_info
+    def restore_llm_obs_dataset_version(project_id, dataset_id, body, opts = {})
+      restore_llm_obs_dataset_version_with_http_info(project_id, dataset_id, body, opts)
+      nil
+    end
+
+    # Restore an LLM Observability dataset version.
+    #
+    # Restore a dataset to a previous version. The dataset's current version is bumped, and its records are replaced with the records from the specified prior version.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param body [LLMObsDatasetRestoreVersionRequest] Restore dataset version payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def restore_llm_obs_dataset_version_with_http_info(project_id, dataset_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.restore_llm_obs_dataset_version".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.restore_llm_obs_dataset_version")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.restore_llm_obs_dataset_version"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.restore_llm_obs_dataset_version ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.restore_llm_obs_dataset_version"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.restore_llm_obs_dataset_version"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.restore_llm_obs_dataset_version"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/restore'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # 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(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :restore_llm_obs_dataset_version,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#restore_llm_obs_dataset_version\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search LLM Observability experimentation entities.
+    #
+    # @see #search_llm_obs_experimentation_with_http_info
+    def search_llm_obs_experimentation(body, opts = {})
+      data, _status_code, _headers = search_llm_obs_experimentation_with_http_info(body, opts)
+      data
+    end
+
+    # Search LLM Observability experimentation entities.
+    #
+    # Search across LLM Observability experimentation entities — projects, datasets, dataset records, experiments, and experiment runs — using cursor-based pagination.
+    #
+    # The `filter.scope` field controls which entity types are returned. At least one valid scope must be provided.
+    #
+    # Returns `200 OK` when all results fit in a single page. Returns `206 Partial Content` with a cursor in `meta.after` when additional pages are available.
+    #
+    # @param body [LLMObsExperimentationSearchRequest] Experimentation search payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsExperimentationSearchResponse, Integer, Hash)>] LLMObsExperimentationSearchResponse data, response status code and response headers
+    def search_llm_obs_experimentation_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.search_llm_obs_experimentation".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.search_llm_obs_experimentation")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.search_llm_obs_experimentation"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.search_llm_obs_experimentation ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.search_llm_obs_experimentation"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/experimentation/search'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentationSearchResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :search_llm_obs_experimentation,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#search_llm_obs_experimentation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search LLM Observability spans.
+    #
+    # @see #search_llm_obs_spans_with_http_info
+    def search_llm_obs_spans(body, opts = {})
+      data, _status_code, _headers = search_llm_obs_spans_with_http_info(body, opts)
+      data
+    end
+
+    # Search LLM Observability spans.
+    #
+    # Search LLM Observability spans using structured filters in the request body.
+    #
+    # @param body [LLMObsSearchSpansRequest] Search spans payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsSpansResponse, Integer, Hash)>] LLMObsSpansResponse data, response status code and response headers
+    def search_llm_obs_spans_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.search_llm_obs_spans".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.search_llm_obs_spans")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.search_llm_obs_spans"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.search_llm_obs_spans ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.search_llm_obs_spans"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/spans/events/search'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsSpansResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :search_llm_obs_spans,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#search_llm_obs_spans\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Simple search experimentation entities.
+    #
+    # @see #simple_search_llm_obs_experimentation_with_http_info
+    def simple_search_llm_obs_experimentation(body, opts = {})
+      data, _status_code, _headers = simple_search_llm_obs_experimentation_with_http_info(body, opts)
+      data
+    end
+
+    # Simple search experimentation entities.
+    #
+    # Search across LLM Observability experimentation entities using offset-based (page-number) pagination.
+    # Use this endpoint when you need total page count or want to navigate to a specific page number.
+    #
+    # The `filter.scope` field controls which entity types are returned. At least one valid scope must be provided.
+    #
+    # @param body [LLMObsExperimentationSimpleSearchRequest] Simple search payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsExperimentationSimpleSearchResponse, Integer, Hash)>] LLMObsExperimentationSimpleSearchResponse data, response status code and response headers
+    def simple_search_llm_obs_experimentation_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.simple_search_llm_obs_experimentation".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.simple_search_llm_obs_experimentation")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.simple_search_llm_obs_experimentation"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.simple_search_llm_obs_experimentation ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.simple_search_llm_obs_experimentation"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/experimentation/simple-search'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsExperimentationSimpleSearchResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :list_llm_obs_datasets,
+        :operation => :simple_search_llm_obs_experimentation,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1529,73 +3947,70 @@ module DatadogAPIClient::V2
         :api_version => "V2"
       )
 
-      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_datasets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#simple_search_llm_obs_experimentation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List LLM Observability experiments.
+    # Trigger a patterns run.
     #
-    # @see #list_llm_obs_experiments_with_http_info
-    def list_llm_obs_experiments(opts = {})
-      data, _status_code, _headers = list_llm_obs_experiments_with_http_info(opts)
+    # @see #trigger_llm_obs_patterns_with_http_info
+    def trigger_llm_obs_patterns(body, opts = {})
+      data, _status_code, _headers = trigger_llm_obs_patterns_with_http_info(body, opts)
       data
     end
 
-    # List LLM Observability experiments.
+    # Trigger a patterns run.
     #
-    # List all LLM Observability experiments sorted by creation date, newest first.
+    # Start a patterns run for a given configuration. The run executes asynchronously.
     #
+    # @param body [LLMObsPatternsTriggerRequest] Trigger patterns payload.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_project_id Filter experiments by project ID. Required if `filter[dataset_id]` is not provided.
-    # @option opts [String] :filter_dataset_id Filter experiments by dataset ID.
-    # @option opts [String] :filter_id Filter experiments by experiment ID. Can be specified multiple times.
-    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
-    # @option opts [Integer] :page_limit Maximum number of results to return per page.
-    # @return [Array<(LLMObsExperimentsResponse, Integer, Hash)>] LLMObsExperimentsResponse data, response status code and response headers
-    def list_llm_obs_experiments_with_http_info(opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_experiments".to_sym]
+    # @return [Array<(LLMObsPatternsTriggerResponse, Integer, Hash)>] LLMObsPatternsTriggerResponse data, response status code and response headers
+    def trigger_llm_obs_patterns_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.trigger_llm_obs_patterns".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_experiments")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.trigger_llm_obs_patterns")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_experiments"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.trigger_llm_obs_patterns"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_experiments ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.trigger_llm_obs_patterns ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.trigger_llm_obs_patterns"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/experiments'
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-runs'
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[project_id]'] = opts[:'filter_project_id'] if !opts[:'filter_project_id'].nil?
-      query_params[:'filter[dataset_id]'] = opts[:'filter_dataset_id'] if !opts[:'filter_dataset_id'].nil?
-      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
-      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
-      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsExperimentsResponse'
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsTriggerResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :list_llm_obs_experiments,
+        :operation => :trigger_llm_obs_patterns,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1605,56 +4020,58 @@ module DatadogAPIClient::V2
         :api_version => "V2"
       )
 
-      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_experiments\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#trigger_llm_obs_patterns\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List LLM Observability projects.
+    # Unlock LLM Observability dataset draft state.
     #
-    # @see #list_llm_obs_projects_with_http_info
-    def list_llm_obs_projects(opts = {})
-      data, _status_code, _headers = list_llm_obs_projects_with_http_info(opts)
-      data
+    # @see #unlock_llm_obs_dataset_draft_state_with_http_info
+    def unlock_llm_obs_dataset_draft_state(project_id, dataset_id, opts = {})
+      unlock_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts)
+      nil
     end
 
-    # List LLM Observability projects.
+    # Unlock LLM Observability dataset draft state.
     #
-    # List all LLM Observability projects sorted by creation date, newest first.
+    # Release the draft lock on a dataset held by the calling user, allowing other users to edit the dataset draft.
     #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :filter_id Filter projects by project ID.
-    # @option opts [String] :filter_name Filter projects by name.
-    # @option opts [String] :page_cursor Use the Pagination cursor to retrieve the next page of results.
-    # @option opts [Integer] :page_limit Maximum number of results to return per page.
-    # @return [Array<(LLMObsProjectsResponse, Integer, Hash)>] LLMObsProjectsResponse data, response status code and response headers
-    def list_llm_obs_projects_with_http_info(opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.list_llm_obs_projects".to_sym]
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def unlock_llm_obs_dataset_draft_state_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.unlock_llm_obs_dataset_draft_state".to_sym]
       if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_llm_obs_projects")
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.unlock_llm_obs_dataset_draft_state")
       else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_llm_obs_projects"))
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.unlock_llm_obs_dataset_draft_state"))
       end
 
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.list_llm_obs_projects ...'
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.unlock_llm_obs_dataset_draft_state ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.unlock_llm_obs_dataset_draft_state"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.unlock_llm_obs_dataset_draft_state"
       end
       # resource path
-      local_var_path = '/api/v2/llm-obs/v1/projects'
+      local_var_path = '/api/v2/llm-obs/v1/{project_id}/datasets/{dataset_id}/draft_state/unlock'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[id]'] = opts[:'filter_id'] if !opts[:'filter_id'].nil?
-      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
-      query_params[:'page[cursor]'] = opts[:'page_cursor'] if !opts[:'page_cursor'].nil?
-      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1663,13 +4080,13 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LLMObsProjectsResponse'
+      return_type = opts[:debug_return_type]
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
-        :operation => :list_llm_obs_projects,
+        :operation => :unlock_llm_obs_dataset_draft_state,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1679,9 +4096,9 @@ module DatadogAPIClient::V2
         :api_version => "V2"
       )
 
-      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Patch, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: LLMObservabilityAPI#list_llm_obs_projects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#unlock_llm_obs_dataset_draft_state\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
@@ -2244,5 +4661,254 @@ module DatadogAPIClient::V2
       end
       return data, status_code, headers
     end
+
+    # Upload records to an LLM Observability dataset.
+    #
+    # @see #upload_llm_obs_dataset_records_file_with_http_info
+    def upload_llm_obs_dataset_records_file(project_id, dataset_id, opts = {})
+      upload_llm_obs_dataset_records_file_with_http_info(project_id, dataset_id, opts)
+      nil
+    end
+
+    # Upload records to an LLM Observability dataset.
+    #
+    # Upload records to a dataset from a file. The request is a `multipart/form-data` upload containing a single `file` part.
+    # Currently only CSV is supported. The CSV must include an `input` column. Optional columns are `id`, `expected_output`, `metadata`, and `tags`.
+    #
+    # The response is a Server-Sent Events stream (`text/event-stream`) emitting progress updates while records are processed. The stream emits the following named events:
+    #   - `progress`: incremental record counts written so far.
+    #   - `completed`: terminal event with a JSON body containing `records_created`.
+    #   - `error`: terminal event with a JSON body containing an error `message`.
+    #
+    # @param project_id [String] The ID of the LLM Observability project.
+    # @param dataset_id [String] The ID of the LLM Observability dataset.
+    # @param opts [Hash] the optional parameters
+    # @option opts [Boolean] :deduplicate Whether to skip records whose `input` already exists in the dataset. Defaults to `false`.
+    # @option opts [Boolean] :overwrite Whether to overwrite existing records that share the same user-provided `id`. Defaults to `true`.
+    # @option opts [Array<String>] :tags Tags to apply to every uploaded record, in addition to any tags defined on individual rows. Can be repeated, e.g. `tags=env:prod&tags=team:ai`.
+    # @option opts [Boolean] :include_user_data Whether to enrich the response with user metadata.
+    # @option opts [File] :file The records file to upload. Currently only CSV is supported. The file must include an `input` column. Optional columns include `id`, `expected_output`, `metadata`, and `tags`.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def upload_llm_obs_dataset_records_file_with_http_info(project_id, dataset_id, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.upload_llm_obs_dataset_records_file".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.upload_llm_obs_dataset_records_file")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.upload_llm_obs_dataset_records_file"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.upload_llm_obs_dataset_records_file ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling LLMObservabilityAPI.upload_llm_obs_dataset_records_file"
+      end
+      # verify the required parameter 'dataset_id' is set
+      if @api_client.config.client_side_validation && dataset_id.nil?
+        fail ArgumentError, "Missing the required parameter 'dataset_id' when calling LLMObservabilityAPI.upload_llm_obs_dataset_records_file"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v2/{project_id}/datasets/{dataset_id}/records/upload'.sub('{project_id}', CGI.escape(project_id.to_s).gsub('%2F', '/')).sub('{dataset_id}', CGI.escape(dataset_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'deduplicate'] = opts[:'deduplicate'] if !opts[:'deduplicate'].nil?
+      query_params[:'overwrite'] = opts[:'overwrite'] if !opts[:'overwrite'].nil?
+      query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :multi) if !opts[:'tags'].nil?
+      query_params[:'include[user_data]'] = opts[:'include_user_data'] if !opts[:'include_user_data'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['multipart/form-data'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+      form_params['file'] = opts[:'file'] if !opts[:'file'].nil?
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :upload_llm_obs_dataset_records_file,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+      new_options[:query_string_normalizer] = HTTParty::Request::NON_RAILS_QUERY_STRING_NORMALIZER
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#upload_llm_obs_dataset_records_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create or update annotations.
+    #
+    # @see #upsert_llm_obs_annotations_with_http_info
+    def upsert_llm_obs_annotations(queue_id, body, opts = {})
+      data, _status_code, _headers = upsert_llm_obs_annotations_with_http_info(queue_id, body, opts)
+      data
+    end
+
+    # Create or update annotations.
+    #
+    # Create or update annotations on interactions in a queue. Each annotation is matched
+    # by `interaction_id` and the requesting user's identity.
+    # Results and errors in the response are linked to request items by `interaction_id`.
+    # Errors for individual items are returned in the `errors` field without blocking the rest of the batch.
+    #
+    # @param queue_id [String] The ID of the LLM Observability annotation queue.
+    # @param body [LLMObsAnnotationsRequest] Payload for creating or updating annotations.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsAnnotationsResponse, Integer, Hash)>] LLMObsAnnotationsResponse data, response status code and response headers
+    def upsert_llm_obs_annotations_with_http_info(queue_id, body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.upsert_llm_obs_annotations".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.upsert_llm_obs_annotations")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.upsert_llm_obs_annotations"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.upsert_llm_obs_annotations ...'
+      end
+      # verify the required parameter 'queue_id' is set
+      if @api_client.config.client_side_validation && queue_id.nil?
+        fail ArgumentError, "Missing the required parameter 'queue_id' when calling LLMObservabilityAPI.upsert_llm_obs_annotations"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.upsert_llm_obs_annotations"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotations'.sub('{queue_id}', CGI.escape(queue_id.to_s).gsub('%2F', '/'))
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsAnnotationsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :upsert_llm_obs_annotations,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#upsert_llm_obs_annotations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create or update a patterns configuration.
+    #
+    # @see #upsert_llm_obs_patterns_config_with_http_info
+    def upsert_llm_obs_patterns_config(body, opts = {})
+      data, _status_code, _headers = upsert_llm_obs_patterns_config_with_http_info(body, opts)
+      data
+    end
+
+    # Create or update a patterns configuration.
+    #
+    # Create a new patterns configuration, or update an existing one when a configuration ID is provided.
+    #
+    # @param body [LLMObsPatternsConfigUpsertRequest] Patterns configuration payload.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(LLMObsPatternsConfigResponse, Integer, Hash)>] LLMObsPatternsConfigResponse data, response status code and response headers
+    def upsert_llm_obs_patterns_config_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.upsert_llm_obs_patterns_config".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.upsert_llm_obs_patterns_config")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.upsert_llm_obs_patterns_config"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LLMObservabilityAPI.upsert_llm_obs_patterns_config ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling LLMObservabilityAPI.upsert_llm_obs_patterns_config"
+      end
+      # resource path
+      local_var_path = '/api/v2/llm-obs/v1/topic-discovery-configs'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LLMObsPatternsConfigResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :upsert_llm_obs_patterns_config,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Put, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LLMObservabilityAPI#upsert_llm_obs_patterns_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end