pinterest_sdk 1.0.0 → 2.0.0

data/lib/pinterest_sdk/api/pins_api.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.3.0
-Contact: pinterest-api@pinterest.com
+The version of the OpenAPI document: 5.23.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.18.0
 
 =end
 
@@ -19,33 +19,145 @@ module PinterestSdkClient
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Get multiple Pin analytics
+    # <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>  Get analytics for multiple pins owned by the \"operation user_account\" - or on a group board that has been shared with this account. - The maximum number of pins supported in a single request is 100. - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=\"/docs/api/v5/#operation/ad_accounts/list\">List ad accounts</a>) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before <code>2023-03-20</code> lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
+    # @param pin_ids [Array<String>] List of Pin IDs.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param metric_types [Array<String>] Pin metric types to get data for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :app_types Apps or devices to get data for, default is all. (default to 'ALL')
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Hash<String, Hash>]
+    def multi_pins_analytics(pin_ids, start_date, end_date, metric_types, opts = {})
+      data, _status_code, _headers = multi_pins_analytics_with_http_info(pin_ids, start_date, end_date, metric_types, opts)
+      data
+    end
+
+    # Get multiple Pin analytics
+    # &lt;strong&gt;This endpoint is currently in beta and not available to all apps. &lt;a href&#x3D;&#39;/docs/getting-started/using-beta-and-restricted-features/&#39;&gt;Learn more&lt;/a&gt;.&lt;/strong&gt;  Get analytics for multiple pins owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - The maximum number of pins supported in a single request is 100. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;\&quot;/docs/api/v5/#operation/ad_accounts/list\&quot;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt; roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before &lt;code&gt;2023-03-20&lt;/code&gt; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
+    # @param pin_ids [Array<String>] List of Pin IDs.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param metric_types [Array<String>] Pin metric types to get data for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :app_types Apps or devices to get data for, default is all. (default to 'ALL')
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Array<(Hash<String, Hash>, Integer, Hash)>] Hash<String, Hash> data, response status code and response headers
+    def multi_pins_analytics_with_http_info(pin_ids, start_date, end_date, metric_types, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PinsApi.multi_pins_analytics ...'
+      end
+      # verify the required parameter 'pin_ids' is set
+      if @api_client.config.client_side_validation && pin_ids.nil?
+        fail ArgumentError, "Missing the required parameter 'pin_ids' when calling PinsApi.multi_pins_analytics"
+      end
+      if @api_client.config.client_side_validation && pin_ids.length > 100
+        fail ArgumentError, 'invalid value for "pin_ids" when calling PinsApi.multi_pins_analytics, number of items must be less than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && pin_ids.length < 1
+        fail ArgumentError, 'invalid value for "pin_ids" when calling PinsApi.multi_pins_analytics, number of items must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'start_date' is set
+      if @api_client.config.client_side_validation && start_date.nil?
+        fail ArgumentError, "Missing the required parameter 'start_date' when calling PinsApi.multi_pins_analytics"
+      end
+      # verify the required parameter 'end_date' is set
+      if @api_client.config.client_side_validation && end_date.nil?
+        fail ArgumentError, "Missing the required parameter 'end_date' when calling PinsApi.multi_pins_analytics"
+      end
+      # verify the required parameter 'metric_types' is set
+      if @api_client.config.client_side_validation && metric_types.nil?
+        fail ArgumentError, "Missing the required parameter 'metric_types' when calling PinsApi.multi_pins_analytics"
+      end
+      allowable_values = ["ALL", "MOBILE", "TABLET", "WEB"]
+      if @api_client.config.client_side_validation && opts[:'app_types'] && !allowable_values.include?(opts[:'app_types'])
+        fail ArgumentError, "invalid value for \"app_types\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.multi_pins_analytics, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.multi_pins_analytics, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/pins/analytics'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'pin_ids'] = @api_client.build_collection_param(pin_ids, :multi)
+      query_params[:'start_date'] = start_date
+      query_params[:'end_date'] = end_date
+      query_params[:'metric_types'] = @api_client.build_collection_param(metric_types, :csv)
+      query_params[:'app_types'] = opts[:'app_types'] if !opts[:'app_types'].nil?
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Hash<String, Hash>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"PinsApi.multi_pins_analytics",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PinsApi#multi_pins_analytics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get Pin analytics
-    # Get analytics for a Pin owned by the \"operation user_account\" - or on a group board that has been shared with this account. - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=\"https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list\">List ad accounts</a>) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.
+    # Get analytics for a Pin owned by the \"operation user_account\" - or on a group board that has been shared with this account. - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=\"/docs/api/v5/#operation/ad_accounts/list\">List ad accounts</a>) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before <code>2023-03-20</code> lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
     # @param pin_id [String] Unique identifier of a Pin.
-    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD
-    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD
-    # @param metric_types [Array<String>] Pin metric types to get data for, default is all.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param metric_types [Array<String>] Pin metric types to get data for. VIDEO_MRC_VIEW are Video views, VIDEO_V50_WATCH_TIME is Total play time. If Pin was created before &lt;code&gt;2023-03-20&lt;/code&gt;, Profile visits and Follows will only be available for Idea Pins. These metrics are available for all Pin formats since then. Keep in mind this cannot have ALL if split_field is set to any value other than &lt;code&gt;NO_SPLIT&lt;/code&gt;.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :app_types Apps or devices to get data for, default is all. (default to 'ALL')
     # @option opts [String] :split_field How to split the data into groups. Not including this param means data won&#39;t be split. (default to 'NO_SPLIT')
     # @option opts [String] :ad_account_id Unique identifier of an ad account.
-    # @return [Hash<String, AnalyticsMetricsResponse>]
+    # @return [Hash<String, PinAnalyticsMetricsResponse>]
     def pins_analytics(pin_id, start_date, end_date, metric_types, opts = {})
       data, _status_code, _headers = pins_analytics_with_http_info(pin_id, start_date, end_date, metric_types, opts)
       data
     end
 
     # Get Pin analytics
-    # Get analytics for a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;\&quot;https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list\&quot;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt; roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.
+    # Get analytics for a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;\&quot;/docs/api/v5/#operation/ad_accounts/list\&quot;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt; roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before &lt;code&gt;2023-03-20&lt;/code&gt; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
     # @param pin_id [String] Unique identifier of a Pin.
-    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD
-    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD
-    # @param metric_types [Array<String>] Pin metric types to get data for, default is all.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param metric_types [Array<String>] Pin metric types to get data for. VIDEO_MRC_VIEW are Video views, VIDEO_V50_WATCH_TIME is Total play time. If Pin was created before &lt;code&gt;2023-03-20&lt;/code&gt;, Profile visits and Follows will only be available for Idea Pins. These metrics are available for all Pin formats since then. Keep in mind this cannot have ALL if split_field is set to any value other than &lt;code&gt;NO_SPLIT&lt;/code&gt;.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :app_types Apps or devices to get data for, default is all.
-    # @option opts [String] :split_field How to split the data into groups. Not including this param means data won&#39;t be split.
+    # @option opts [String] :app_types Apps or devices to get data for, default is all. (default to 'ALL')
+    # @option opts [String] :split_field How to split the data into groups. Not including this param means data won&#39;t be split. (default to 'NO_SPLIT')
     # @option opts [String] :ad_account_id Unique identifier of an ad account.
-    # @return [Array<(Hash<String, AnalyticsMetricsResponse>, Integer, Hash)>] Hash<String, AnalyticsMetricsResponse> data, response status code and response headers
+    # @return [Array<(Hash<String, PinAnalyticsMetricsResponse>, Integer, Hash)>] Hash<String, PinAnalyticsMetricsResponse> data, response status code and response headers
     def pins_analytics_with_http_info(pin_id, start_date, end_date, metric_types, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: PinsApi.pins_analytics ...'
@@ -74,6 +186,10 @@ module PinterestSdkClient
       if @api_client.config.client_side_validation && opts[:'split_field'] && !allowable_values.include?(opts[:'split_field'])
         fail ArgumentError, "invalid value for \"split_field\", must be one of #{allowable_values}"
       end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_analytics, the character length must be smaller than or equal to 18.'
+      end
+
       pattern = Regexp.new(/^\d+$/)
       if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
         fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_analytics, must conform to the pattern #{pattern}."
@@ -94,7 +210,7 @@ module PinterestSdkClient
       # 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(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -103,10 +219,10 @@ module PinterestSdkClient
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'Hash<String, AnalyticsMetricsResponse>'
+      return_type = opts[:debug_return_type] || 'Hash<String, PinAnalyticsMetricsResponse>'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
 
       new_options = opts.merge(
         :operation => :"PinsApi.pins_analytics",
@@ -126,38 +242,50 @@ module PinterestSdkClient
     end
 
     # Create Pin
-    # Create a Pin on a board or board section owned by the \"operation user_account\".  Note: If the current \"operation user_account\" (defined by the access token) has access to another user's Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account's permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id=12345&...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called 'curated content', please use our <a href='/docs/add-ons/save-button'>Save button</a> instead. For more tips on creating fresh content for Pinterest, review our <a href='/docs/solutions/content-apps'>Content App Solutions Guide</a>.  <strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.
-    # @param pin [Pin] Create a new Pin.
+    #   Create a Pin on a board or board section owned by the \"operation user_account\".   Note: If the current \"operation user_account\" (defined by the access token) has access to another user's Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account's permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id=12345&...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called 'curated content', please use our [Save button](/docs/web-features/add-ons-overview/) instead. For more tips on creating fresh content for Pinterest, review our [Content App Solutions Guide](/docs/api-features/content-overview/).  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-image-pins)** about image Pin creation.
+    # @param pin_create [PinCreate] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
     # @return [Pin]
-    def pins_create(pin, opts = {})
-      data, _status_code, _headers = pins_create_with_http_info(pin, opts)
+    def pins_create(pin_create, opts = {})
+      data, _status_code, _headers = pins_create_with_http_info(pin_create, opts)
       data
     end
 
     # Create Pin
-    # Create a Pin on a board or board section owned by the \&quot;operation user_account\&quot;.  Note: If the current \&quot;operation user_account\&quot; (defined by the access token) has access to another user&#39;s Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account&#39;s permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id&#x3D;12345&amp;...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called &#39;curated content&#39;, please use our &lt;a href&#x3D;&#39;/docs/add-ons/save-button&#39;&gt;Save button&lt;/a&gt; instead. For more tips on creating fresh content for Pinterest, review our &lt;a href&#x3D;&#39;/docs/solutions/content-apps&#39;&gt;Content App Solutions Guide&lt;/a&gt;.  &lt;strong&gt;&lt;a href&#x3D;&#39;/docs/solutions/content-apps/#creatingvideopins&#39;&gt;Learn more&lt;/a&gt;&lt;/strong&gt; about video Pin creation.
-    # @param pin [Pin] Create a new Pin.
+    #   Create a Pin on a board or board section owned by the \&quot;operation user_account\&quot;.   Note: If the current \&quot;operation user_account\&quot; (defined by the access token) has access to another user&#39;s Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account&#39;s permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id&#x3D;12345&amp;...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called &#39;curated content&#39;, please use our [Save button](/docs/web-features/add-ons-overview/) instead. For more tips on creating fresh content for Pinterest, review our [Content App Solutions Guide](/docs/api-features/content-overview/).  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-image-pins)** about image Pin creation.
+    # @param pin_create [PinCreate] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
     # @return [Array<(Pin, Integer, Hash)>] Pin data, response status code and response headers
-    def pins_create_with_http_info(pin, opts = {})
+    def pins_create_with_http_info(pin_create, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: PinsApi.pins_create ...'
       end
-      # verify the required parameter 'pin' is set
-      if @api_client.config.client_side_validation && pin.nil?
-        fail ArgumentError, "Missing the required parameter 'pin' when calling PinsApi.pins_create"
+      # verify the required parameter 'pin_create' is set
+      if @api_client.config.client_side_validation && pin_create.nil?
+        fail ArgumentError, "Missing the required parameter 'pin_create' when calling PinsApi.pins_create"
+      end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_create, the character length must be smaller than or equal to 18.'
       end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_create, must conform to the pattern #{pattern}."
+      end
+
       # resource path
       local_var_path = '/pins'
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].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(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -168,13 +296,13 @@ module PinterestSdkClient
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(pin)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(pin_create)
 
       # return_type
       return_type = opts[:debug_return_type] || 'Pin'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
 
       new_options = opts.merge(
         :operation => :"PinsApi.pins_create",
@@ -194,9 +322,10 @@ module PinterestSdkClient
     end
 
     # Delete Pin
-    # Delete a Pins owned by the \"operation user_account\" - or on a group board that has been shared with this account. - By default, the \"operation user_account\" is the token user_account.
-    # @param pin_id [String] Unique identifier of a Pin.
+    #    Delete a Pins owned by the \"operation user_account\" - or on a group board that has been shared with this account.   - By default, the \"operation user_account\" is the token user_account.    Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+    # @param pin_id [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
     # @return [nil]
     def pins_delete(pin_id, opts = {})
       pins_delete_with_http_info(pin_id, opts)
@@ -204,9 +333,10 @@ module PinterestSdkClient
     end
 
     # Delete Pin
-    # Delete a Pins owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.
-    # @param pin_id [String] Unique identifier of a Pin.
+    #    Delete a Pins owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account.   - By default, the \&quot;operation user_account\&quot; is the token user_account.    Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+    # @param pin_id [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def pins_delete_with_http_info(pin_id, opts = {})
       if @api_client.config.debugging
@@ -216,16 +346,31 @@ module PinterestSdkClient
       if @api_client.config.client_side_validation && pin_id.nil?
         fail ArgumentError, "Missing the required parameter 'pin_id' when calling PinsApi.pins_delete"
       end
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && pin_id !~ pattern
+        fail ArgumentError, "invalid value for 'pin_id' when calling PinsApi.pins_delete, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_delete, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_delete, must conform to the pattern #{pattern}."
+      end
+
       # resource path
       local_var_path = '/pins/{pin_id}'.sub('{' + 'pin_id' + '}', CGI.escape(pin_id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].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(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -237,7 +382,7 @@ module PinterestSdkClient
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
 
       new_options = opts.merge(
         :operation => :"PinsApi.pins_delete",
@@ -257,10 +402,11 @@ module PinterestSdkClient
     end
 
     # Get Pin
-    # Get a Pin owned by the \"operation user_account\" - or on a group board that has been shared with this account. - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.
-    # @param pin_id [String] Unique identifier of a Pin.
+    #    Get a Pin owned by the \"operation user_account\" - or on a group board that has been shared with this account.   - By default, the \"operation user_account\" is the token user_account.    Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+    # @param pin_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then. (default to false)
     # @return [Pin]
     def pins_get(pin_id, opts = {})
       data, _status_code, _headers = pins_get_with_http_info(pin_id, opts)
@@ -268,10 +414,11 @@ module PinterestSdkClient
     end
 
     # Get Pin
-    # Get a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;&#39;/docs/api/v5/#operation/ad_accounts/list&#39;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt; roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.
-    # @param pin_id [String] Unique identifier of a Pin.
+    #    Get a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account.   - By default, the \&quot;operation user_account\&quot; is the token user_account.    Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+    # @param pin_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then. (default to false)
     # @return [Array<(Pin, Integer, Hash)>] Pin data, response status code and response headers
     def pins_get_with_http_info(pin_id, opts = {})
       if @api_client.config.debugging
@@ -281,6 +428,15 @@ module PinterestSdkClient
       if @api_client.config.client_side_validation && pin_id.nil?
         fail ArgumentError, "Missing the required parameter 'pin_id' when calling PinsApi.pins_get"
       end
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && pin_id !~ pattern
+        fail ArgumentError, "invalid value for 'pin_id' when calling PinsApi.pins_get, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_get, the character length must be smaller than or equal to 18.'
+      end
+
       pattern = Regexp.new(/^\d+$/)
       if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
         fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_get, must conform to the pattern #{pattern}."
@@ -292,11 +448,12 @@ module PinterestSdkClient
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+      query_params[:'pin_metrics'] = opts[:'pin_metrics'] if !opts[:'pin_metrics'].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(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -308,7 +465,7 @@ module PinterestSdkClient
       return_type = opts[:debug_return_type] || 'Pin'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
 
       new_options = opts.merge(
         :operation => :"PinsApi.pins_get",
@@ -326,5 +483,288 @@ module PinterestSdkClient
       end
       return data, status_code, headers
     end
+
+    # List Pins
+    #      Get a list of the Pins owned by the \"operation user_account\".     - By default, the \"operation user_account\" is the token user_account.     - All Pins owned by the \"operation user_account\" are included, regardless of who owns the board they are on.      Optional: Business Access: Specify an `ad_account_id` to use the owner of that ad_account as the \"operation user_account\".      Disclaimer: There are known performance issues when filtering by field `creative_type` and including protected pins.     If your request is timing out in this scenario, we encourage you to use [GET List Pins on Board](/docs/api/v5/#operation/boards/list_pins).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :pin_filter The filter to apply to the pins
+    # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then. (default to false)
+    # @option opts [Boolean] :include_protected_pins Whether to include protected pins in the results (default to false)
+    # @option opts [String] :pin_type The type of pins to return, currently only enabled for private pins
+    # @option opts [Array<CreativeType>] :creative_types Pin creative types filter. **Note:** SHOP_THE_PIN has been deprecated. Please use COLLECTION instead.
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @return [PinsList200Response]
+    def pins_list(opts = {})
+      data, _status_code, _headers = pins_list_with_http_info(opts)
+      data
+    end
+
+    # List Pins
+    #      Get a list of the Pins owned by the \&quot;operation user_account\&quot;.     - By default, the \&quot;operation user_account\&quot; is the token user_account.     - All Pins owned by the \&quot;operation user_account\&quot; are included, regardless of who owns the board they are on.      Optional: Business Access: Specify an &#x60;ad_account_id&#x60; to use the owner of that ad_account as the \&quot;operation user_account\&quot;.      Disclaimer: There are known performance issues when filtering by field &#x60;creative_type&#x60; and including protected pins.     If your request is timing out in this scenario, we encourage you to use [GET List Pins on Board](/docs/api/v5/#operation/boards/list_pins).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :pin_filter The filter to apply to the pins
+    # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then. (default to false)
+    # @option opts [Boolean] :include_protected_pins Whether to include protected pins in the results (default to false)
+    # @option opts [String] :pin_type The type of pins to return, currently only enabled for private pins
+    # @option opts [Array<CreativeType>] :creative_types Pin creative types filter. **Note:** SHOP_THE_PIN has been deprecated. Please use COLLECTION instead.
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @return [Array<(PinsList200Response, Integer, Hash)>] PinsList200Response data, response status code and response headers
+    def pins_list_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PinsApi.pins_list ...'
+      end
+      allowable_values = ["exclude_native", "exclude_repins", "has_been_promoted"]
+      if @api_client.config.client_side_validation && opts[:'pin_filter'] && !allowable_values.include?(opts[:'pin_filter'])
+        fail ArgumentError, "invalid value for \"pin_filter\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["PRIVATE"]
+      if @api_client.config.client_side_validation && opts[:'pin_type'] && !allowable_values.include?(opts[:'pin_type'])
+        fail ArgumentError, "invalid value for \"pin_type\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_list, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_list, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 250
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling PinsApi.pins_list, must be smaller than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling PinsApi.pins_list, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/pins'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'pin_filter'] = opts[:'pin_filter'] if !opts[:'pin_filter'].nil?
+      query_params[:'pin_metrics'] = opts[:'pin_metrics'] if !opts[:'pin_metrics'].nil?
+      query_params[:'include_protected_pins'] = opts[:'include_protected_pins'] if !opts[:'include_protected_pins'].nil?
+      query_params[:'pin_type'] = opts[:'pin_type'] if !opts[:'pin_type'].nil?
+      query_params[:'creative_types'] = @api_client.build_collection_param(opts[:'creative_types'], :multi) if !opts[:'creative_types'].nil?
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+      query_params[:'bookmark'] = opts[:'bookmark'] if !opts[:'bookmark'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PinsList200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"PinsApi.pins_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PinsApi#pins_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Save Pin
+    # Save a Pin on a board or board section owned by the \"operation user_account\". - By default, the \"operation user_account\" is the token user_account. Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  - Any Pin type can be saved: image Pin, video Pin, Idea Pin, product Pin, etc. - Any public Pin can be saved given a pin ID.
+    # @param pin_id [String] Unique identifier of a Pin.
+    # @param pins_save_request [PinsSaveRequest] Request object used to save an existing pin
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Pin]
+    def pins_save(pin_id, pins_save_request, opts = {})
+      data, _status_code, _headers = pins_save_with_http_info(pin_id, pins_save_request, opts)
+      data
+    end
+
+    # Save Pin
+    # Save a Pin on a board or board section owned by the \&quot;operation user_account\&quot;. - By default, the \&quot;operation user_account\&quot; is the token user_account. Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;&#39;/docs/api/v5/#operation/ad_accounts/list&#39;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt; roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  - Any Pin type can be saved: image Pin, video Pin, Idea Pin, product Pin, etc. - Any public Pin can be saved given a pin ID.
+    # @param pin_id [String] Unique identifier of a Pin.
+    # @param pins_save_request [PinsSaveRequest] Request object used to save an existing pin
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Array<(Pin, Integer, Hash)>] Pin data, response status code and response headers
+    def pins_save_with_http_info(pin_id, pins_save_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PinsApi.pins_save ...'
+      end
+      # verify the required parameter 'pin_id' is set
+      if @api_client.config.client_side_validation && pin_id.nil?
+        fail ArgumentError, "Missing the required parameter 'pin_id' when calling PinsApi.pins_save"
+      end
+      # verify the required parameter 'pins_save_request' is set
+      if @api_client.config.client_side_validation && pins_save_request.nil?
+        fail ArgumentError, "Missing the required parameter 'pins_save_request' when calling PinsApi.pins_save"
+      end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_save, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_save, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/pins/{pin_id}/save'.sub('{' + 'pin_id' + '}', CGI.escape(pin_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(pins_save_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Pin'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"PinsApi.pins_save",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PinsApi#pins_save\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update Pin
+    # Update a pin owned by the \"operating user_account\". - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  **This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**
+    # @param pin_id [String] 
+    # @param pin_update [PinUpdate] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Pin]
+    def pins_update(pin_id, pin_update, opts = {})
+      data, _status_code, _headers = pins_update_with_http_info(pin_id, pin_update, opts)
+      data
+    end
+
+    # Update Pin
+    # Update a pin owned by the \&quot;operating user_account\&quot;. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  **This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**
+    # @param pin_id [String] 
+    # @param pin_update [PinUpdate] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Unique identifier of an ad account.
+    # @return [Array<(Pin, Integer, Hash)>] Pin data, response status code and response headers
+    def pins_update_with_http_info(pin_id, pin_update, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PinsApi.pins_update ...'
+      end
+      # verify the required parameter 'pin_id' is set
+      if @api_client.config.client_side_validation && pin_id.nil?
+        fail ArgumentError, "Missing the required parameter 'pin_id' when calling PinsApi.pins_update"
+      end
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && pin_id !~ pattern
+        fail ArgumentError, "invalid value for 'pin_id' when calling PinsApi.pins_update, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'pin_update' is set
+      if @api_client.config.client_side_validation && pin_update.nil?
+        fail ArgumentError, "Missing the required parameter 'pin_update' when calling PinsApi.pins_update"
+      end
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'].to_s.length > 18
+        fail ArgumentError, 'invalid value for "opts[:"ad_account_id"]" when calling PinsApi.pins_update, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && !opts[:'ad_account_id'].nil? && opts[:'ad_account_id'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"ad_account_id\"]' when calling PinsApi.pins_update, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/pins/{pin_id}'.sub('{' + 'pin_id' + '}', CGI.escape(pin_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ad_account_id'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(pin_update)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Pin'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"PinsApi.pins_update",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PinsApi#pins_update\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end