hanzoai 8.5.156

data/lib/hanzoai/api/social_api.rb

@@ -0,0 +1,857 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class SocialApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Removes one connected account from the org and answers 204 with no body; an id that is not there is 404.
+    # Removes one connected account from the org and answers 204 with no body; an id that is not there is 404.  It removes the account record only. Posts that already published through it keep their published state and their recorded external ids — this does not retract anything from the network.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_social_accounts_by_id(id, opts = {})
+      delete_social_accounts_by_id_with_http_info(id, opts)
+      nil
+    end
+
+    # Removes one connected account from the org and answers 204 with no body; an id that is not there is 404.
+    # Removes one connected account from the org and answers 204 with no body; an id that is not there is 404.  It removes the account record only. Posts that already published through it keep their published state and their recorded external ids — this does not retract anything from the network.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_social_accounts_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.delete_social_accounts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.delete_social_accounts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/accounts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # 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] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.delete_social_accounts_by_id",
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SocialApi#delete_social_accounts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Removes one post from the org and answers 204 with no body; an id that is not there is 404.
+    # Removes one post from the org and answers 204 with no body; an id that is not there is 404.  It deletes the record here only. A post that has already published is not retracted from the network by deleting it.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_social_posts_by_id(id, opts = {})
+      delete_social_posts_by_id_with_http_info(id, opts)
+      nil
+    end
+
+    # Removes one post from the org and answers 204 with no body; an id that is not there is 404.
+    # Removes one post from the org and answers 204 with no body; an id that is not there is 404.  It deletes the record here only. A post that has already published is not retracted from the network by deleting it.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_social_posts_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.delete_social_posts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.delete_social_posts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/posts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # 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] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.delete_social_posts_by_id",
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SocialApi#delete_social_posts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's connected accounts — each one's id, network, handle, status and timestamps, most-recently-updated first.
+    # Returns the org's connected accounts — each one's id, network, handle, status and timestamps, most-recently-updated first.  An account's provider access token is NEVER included in any response on this surface. Only the publisher reads it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :provider Provider keeps only accounts on one network — x, facebook, instagram, linkedin, tiktok, youtube or threads. Omit it for every network. It is lower-cased and trimmed before it is matched, and a value that names no network simply matches nothing rather than being refused.
+    # @option opts [String] :limit Limit bounds the page, defaulting to 200 and capped at 1000. It is a string rather than an integer on purpose: the route parses it with a leading trim and falls back to the default on anything it cannot read, so &#x60;?limit&#x3D;%2050&#x60; is a page of fifty today. An integer field would refuse the space and read an unparseable value as zero, which is a different page.
+    # @return [SocialAccounts]
+    def get_social_accounts(opts = {})
+      data, _status_code, _headers = get_social_accounts_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s connected accounts — each one&#39;s id, network, handle, status and timestamps, most-recently-updated first.
+    # Returns the org&#39;s connected accounts — each one&#39;s id, network, handle, status and timestamps, most-recently-updated first.  An account&#39;s provider access token is NEVER included in any response on this surface. Only the publisher reads it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :provider Provider keeps only accounts on one network — x, facebook, instagram, linkedin, tiktok, youtube or threads. Omit it for every network. It is lower-cased and trimmed before it is matched, and a value that names no network simply matches nothing rather than being refused.
+    # @option opts [String] :limit Limit bounds the page, defaulting to 200 and capped at 1000. It is a string rather than an integer on purpose: the route parses it with a leading trim and falls back to the default on anything it cannot read, so &#x60;?limit&#x3D;%2050&#x60; is a page of fifty today. An integer field would refuse the space and read an unparseable value as zero, which is a different page.
+    # @return [Array<(SocialAccounts, Integer, Hash)>] SocialAccounts data, response status code and response headers
+    def get_social_accounts_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_accounts ...'
+      end
+      # resource path
+      local_var_path = '/v1/social/accounts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'provider'] = opts[:'provider'] if !opts[:'provider'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'SocialAccounts'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_accounts",
+        :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: SocialApi#get_social_accounts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one of the org's connected accounts by id — its network, handle, status and timestamps — or 404.
+    # Returns one of the org's connected accounts by id — its network, handle, status and timestamps — or 404. The provider access token is not part of the response.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [SocialAccount]
+    def get_social_accounts_by_id(id, opts = {})
+      data, _status_code, _headers = get_social_accounts_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one of the org&#39;s connected accounts by id — its network, handle, status and timestamps — or 404.
+    # Returns one of the org&#39;s connected accounts by id — its network, handle, status and timestamps — or 404. The provider access token is not part of the response.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialAccount, Integer, Hash)>] SocialAccount data, response status code and response headers
+    def get_social_accounts_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_accounts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.get_social_accounts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/accounts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialAccount'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_accounts_by_id",
+        :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: SocialApi#get_social_accounts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first.
+    # Returns the org's posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Status keeps only posts in one state — draft, scheduled, published or failed. Omit it for every state. The transient publishing claim is not a user-visible state and matching it is not useful.
+    # @option opts [String] :limit Limit bounds the page, defaulting to 200 and capped at 1000. A string for the same reason accountFilter.Limit is.
+    # @return [SocialPosts]
+    def get_social_posts(opts = {})
+      data, _status_code, _headers = get_social_posts_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first.
+    # Returns the org&#39;s posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Status keeps only posts in one state — draft, scheduled, published or failed. Omit it for every state. The transient publishing claim is not a user-visible state and matching it is not useful.
+    # @option opts [String] :limit Limit bounds the page, defaulting to 200 and capped at 1000. A string for the same reason accountFilter.Limit is.
+    # @return [Array<(SocialPosts, Integer, Hash)>] SocialPosts data, response status code and response headers
+    def get_social_posts_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_posts ...'
+      end
+      # resource path
+      local_var_path = '/v1/social/posts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'SocialPosts'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_posts",
+        :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: SocialApi#get_social_posts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one of the org's posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under.
+    # Returns one of the org's posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under. 404 when there is no such post for this org.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [SocialPost]
+    def get_social_posts_by_id(id, opts = {})
+      data, _status_code, _headers = get_social_posts_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one of the org&#39;s posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under.
+    # Returns one of the org&#39;s posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under. 404 when there is no such post for this org.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialPost, Integer, Hash)>] SocialPost data, response status code and response headers
+    def get_social_posts_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_posts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.get_social_posts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/posts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialPost'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_posts_by_id",
+        :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: SocialApi#get_social_posts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing.
+    # Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing.  This is a live read of the deployment's own configuration, not a static list of networks — it answers \"can I connect this today\", which is what a connect affordance and a pre-cutover checklist both need. It says nothing about whether the caller has connected an account; that is the accounts listing.
+    # @param [Hash] opts the optional parameters
+    # @return [SocialProviders]
+    def get_social_providers(opts = {})
+      data, _status_code, _headers = get_social_providers_with_http_info(opts)
+      data
+    end
+
+    # Reports each supported network&#39;s publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing.
+    # Reports each supported network&#39;s publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing.  This is a live read of the deployment&#39;s own configuration, not a static list of networks — it answers \&quot;can I connect this today\&quot;, which is what a connect affordance and a pre-cutover checklist both need. It says nothing about whether the caller has connected an account; that is the accounts listing.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialProviders, Integer, Hash)>] SocialProviders data, response status code and response headers
+    def get_social_providers_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_providers ...'
+      end
+      # resource path
+      local_var_path = '/v1/social/providers'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialProviders'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_providers",
+        :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: SocialApi#get_social_providers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns four counts for the caller's org: total posts, how many are scheduled, how many have published, and how many accounts are connected.
+    # Returns four counts for the caller's org: total posts, how many are scheduled, how many have published, and how many accounts are connected. It is the dashboard roll-up, computed over the org's own rows in one read.
+    # @param [Hash] opts the optional parameters
+    # @return [SocialSummary]
+    def get_social_summary(opts = {})
+      data, _status_code, _headers = get_social_summary_with_http_info(opts)
+      data
+    end
+
+    # Returns four counts for the caller&#39;s org: total posts, how many are scheduled, how many have published, and how many accounts are connected.
+    # Returns four counts for the caller&#39;s org: total posts, how many are scheduled, how many have published, and how many accounts are connected. It is the dashboard roll-up, computed over the org&#39;s own rows in one read.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialSummary, Integer, Hash)>] SocialSummary data, response status code and response headers
+    def get_social_summary_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.get_social_summary ...'
+      end
+      # resource path
+      local_var_path = '/v1/social/summary'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialSummary'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.get_social_summary",
+        :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: SocialApi#get_social_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by.
+    # Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by.
+    # @param social_account_body [SocialAccountBody] 
+    # @param [Hash] opts the optional parameters
+    # @return [SocialAccount]
+    def post_social_accounts(social_account_body, opts = {})
+      data, _status_code, _headers = post_social_accounts_with_http_info(social_account_body, opts)
+      data
+    end
+
+    # Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by.
+    # Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by.
+    # @param social_account_body [SocialAccountBody] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialAccount, Integer, Hash)>] SocialAccount data, response status code and response headers
+    def post_social_accounts_with_http_info(social_account_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.post_social_accounts ...'
+      end
+      # verify the required parameter 'social_account_body' is set
+      if @api_client.config.client_side_validation && social_account_body.nil?
+        fail ArgumentError, "Missing the required parameter 'social_account_body' when calling SocialApi.post_social_accounts"
+      end
+      # resource path
+      local_var_path = '/v1/social/accounts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # 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(social_account_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialAccount'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.post_social_accounts",
+        :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: SocialApi#post_social_accounts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Stores a post for the org and answers 201 with the stored row.
+    # Stores a post for the org and answers 201 with the stored row.  A post created as scheduled for a time that has already passed is published IMMEDIATELY, and the row returned carries that outcome — this is the one behaviour a reader would otherwise miss. A future-scheduled post is left for the scheduler, and a draft is left alone. Publishing never fails the creation: the post is stored either way, and a publish that could not run leaves the row for the scheduler to retry.
+    # @param social_post_body [SocialPostBody] 
+    # @param [Hash] opts the optional parameters
+    # @return [SocialPost]
+    def post_social_posts(social_post_body, opts = {})
+      data, _status_code, _headers = post_social_posts_with_http_info(social_post_body, opts)
+      data
+    end
+
+    # Stores a post for the org and answers 201 with the stored row.
+    # Stores a post for the org and answers 201 with the stored row.  A post created as scheduled for a time that has already passed is published IMMEDIATELY, and the row returned carries that outcome — this is the one behaviour a reader would otherwise miss. A future-scheduled post is left for the scheduler, and a draft is left alone. Publishing never fails the creation: the post is stored either way, and a publish that could not run leaves the row for the scheduler to retry.
+    # @param social_post_body [SocialPostBody] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialPost, Integer, Hash)>] SocialPost data, response status code and response headers
+    def post_social_posts_with_http_info(social_post_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.post_social_posts ...'
+      end
+      # verify the required parameter 'social_post_body' is set
+      if @api_client.config.client_side_validation && social_post_body.nil?
+        fail ArgumentError, "Missing the required parameter 'social_post_body' when calling SocialApi.post_social_posts"
+      end
+      # resource path
+      local_var_path = '/v1/social/posts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # 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(social_post_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialPost'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.post_social_posts",
+        :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: SocialApi#post_social_posts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under.
+    # Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under.  It is IDEMPOTENT: a post that has already published, or that another caller is publishing right now, comes back unchanged rather than being posted twice. That claim is taken before any network call, which is what makes a double submit safe.  The two failure shapes differ on purpose. Having no connected account for the channel is the caller's to fix, so it is recorded ON the post as failed with the reason and answers normally. A deployment that lacks the network's own credentials cannot publish for anyone, so that is a 503 naming exactly what is missing.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [SocialPost]
+    def post_social_posts_by_id_publish(id, opts = {})
+      data, _status_code, _headers = post_social_posts_by_id_publish_with_http_info(id, opts)
+      data
+    end
+
+    # Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under.
+    # Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under.  It is IDEMPOTENT: a post that has already published, or that another caller is publishing right now, comes back unchanged rather than being posted twice. That claim is taken before any network call, which is what makes a double submit safe.  The two failure shapes differ on purpose. Having no connected account for the channel is the caller&#39;s to fix, so it is recorded ON the post as failed with the reason and answers normally. A deployment that lacks the network&#39;s own credentials cannot publish for anyone, so that is a 503 naming exactly what is missing.
+    # @param id [String] ID is the account or post to act on, taken from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialPost, Integer, Hash)>] SocialPost data, response status code and response headers
+    def post_social_posts_by_id_publish_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.post_social_posts_by_id_publish ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.post_social_posts_by_id_publish"
+      end
+      # resource path
+      local_var_path = '/v1/social/posts/{id}/publish'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialPost'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.post_social_posts_by_id_publish",
+        :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: SocialApi#post_social_posts_by_id_publish\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replaces the account's network, handle and status with what the body carries, and answers with the stored row.
+    # Replaces the account's network, handle and status with what the body carries, and answers with the stored row.  This is a REPLACEMENT, not a merge, which is the rule most easily got wrong: a field the body omits is written as its default, so leaving out the handle blanks it and leaving out the status resets it to connected. Send the whole record. The same vocabularies as create apply, and an unknown network or status is refused rather than coerced.
+    # @param id [String] 
+    # @param social_account_write [SocialAccountWrite] 
+    # @param [Hash] opts the optional parameters
+    # @return [SocialAccount]
+    def put_social_accounts_by_id(id, social_account_write, opts = {})
+      data, _status_code, _headers = put_social_accounts_by_id_with_http_info(id, social_account_write, opts)
+      data
+    end
+
+    # Replaces the account&#39;s network, handle and status with what the body carries, and answers with the stored row.
+    # Replaces the account&#39;s network, handle and status with what the body carries, and answers with the stored row.  This is a REPLACEMENT, not a merge, which is the rule most easily got wrong: a field the body omits is written as its default, so leaving out the handle blanks it and leaving out the status resets it to connected. Send the whole record. The same vocabularies as create apply, and an unknown network or status is refused rather than coerced.
+    # @param id [String] 
+    # @param social_account_write [SocialAccountWrite] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialAccount, Integer, Hash)>] SocialAccount data, response status code and response headers
+    def put_social_accounts_by_id_with_http_info(id, social_account_write, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.put_social_accounts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.put_social_accounts_by_id"
+      end
+      # verify the required parameter 'social_account_write' is set
+      if @api_client.config.client_side_validation && social_account_write.nil?
+        fail ArgumentError, "Missing the required parameter 'social_account_write' when calling SocialApi.put_social_accounts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/accounts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # 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(social_account_write)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialAccount'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.put_social_accounts_by_id",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SocialApi#put_social_accounts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Replaces the post's content, channel, status, scheduled time and media with what the body carries, and answers with the stored row.
+    # Replaces the post's content, channel, status, scheduled time and media with what the body carries, and answers with the stored row.  A REPLACEMENT, not a merge: an omitted field is written as its default, so omitting media clears it and omitting the status resets the post to draft. `content` is required on every update. Unlike create, this never triggers a publish — moving a post's scheduled time into the past here leaves it for the scheduler; publish now is its own operation.
+    # @param id [String] 
+    # @param social_post_write [SocialPostWrite] 
+    # @param [Hash] opts the optional parameters
+    # @return [SocialPost]
+    def put_social_posts_by_id(id, social_post_write, opts = {})
+      data, _status_code, _headers = put_social_posts_by_id_with_http_info(id, social_post_write, opts)
+      data
+    end
+
+    # Replaces the post&#39;s content, channel, status, scheduled time and media with what the body carries, and answers with the stored row.
+    # Replaces the post&#39;s content, channel, status, scheduled time and media with what the body carries, and answers with the stored row.  A REPLACEMENT, not a merge: an omitted field is written as its default, so omitting media clears it and omitting the status resets the post to draft. &#x60;content&#x60; is required on every update. Unlike create, this never triggers a publish — moving a post&#39;s scheduled time into the past here leaves it for the scheduler; publish now is its own operation.
+    # @param id [String] 
+    # @param social_post_write [SocialPostWrite] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SocialPost, Integer, Hash)>] SocialPost data, response status code and response headers
+    def put_social_posts_by_id_with_http_info(id, social_post_write, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SocialApi.put_social_posts_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SocialApi.put_social_posts_by_id"
+      end
+      # verify the required parameter 'social_post_write' is set
+      if @api_client.config.client_side_validation && social_post_write.nil?
+        fail ArgumentError, "Missing the required parameter 'social_post_write' when calling SocialApi.put_social_posts_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/social/posts/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # 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(social_post_write)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SocialPost'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SocialApi.put_social_posts_by_id",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SocialApi#put_social_posts_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end