ths-apimatic-sdk-sdk 1.0.0

data/lib/thought_spot_public_rest_api/controllers/custom_action_controller.rb

@@ -0,0 +1,205 @@
+# thought_spot_public_rest_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module ThoughtSpotPublicRestApi
+  # CustomActionController
+  class CustomActionController < BaseController
+    #  <span class="since-beta-tag">Version: 9.6.0.cl or later</span>
+    # Creates a custom action that appears as a menu action on a saved Answer or
+    # Liveboard visualization.
+    # Requires `DEVELOPER` (**Has Developer privilege**) or `ADMINISTRATION`
+    # (**Can administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # instance, the `DEVELOPER` (**Has developer privilege**) privilege is
+    # required.
+    # #### Usage Guidelines
+    # The API lets you create the following types of custom actions:
+    # * URL-based action
+    #   Allows pushing data to an external URL.
+    # * Callback action
+    #   Triggers a callback to the host application and initiates a response
+    # payload on an embedded ThoughtSpot instance.
+    # By default, custom actions are visible to only administrator or developer
+    # users. To make a custom action available to other users, and specify the
+    # groups in `group_identifiers`.
+    # By default, the custom action is set as a _global_ action on all
+    # visualizations and saved Answers. To assign a custom action to specific
+    # Liveboard visualization, saved Answer, or Worksheet, set `visibility` to
+    # `false` in `default_action_config` property and specify the GUID or name
+    # of the object in `associate_metadata`.
+    # For more information, see [Custom
+    # actions](https://developers.thoughtspot.com/docs/custom-action-intro).
+    # #### Endpoint URL
+    # @param [CreateCustomActionRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_custom_action(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/customization/custom-actions',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ResponseCustomAction.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 9.6.0.cl or later</span>
+    # Removes the custom action specified in the API request.
+    # Requires `DEVELOPER` (**Has Developer privilege**) or `ADMINISTRATION`
+    # (**Can administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # instance, the `DEVELOPER` (**Has developer privilege**) privilege is
+    # required.
+    # #### Endpoint URL
+    # @param [String] custom_action_identifier Required parameter: Unique ID or
+    # name of the custom action.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_custom_action(custom_action_identifier)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/customization/custom-actions/{custom_action_identifier}/delete',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(custom_action_identifier, key: 'custom_action_identifier')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 9.6.0.cl or later</span>
+    # Gets custom actions configured on the cluster.
+    # Requires `DEVELOPER` (**Has Developer privilege**) or `ADMINISTRATION`
+    # (**Can administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # instance, the `DEVELOPER` (**Has developer privilege**) privilege is
+    # required.
+    # #### Endpoint URL
+    # @param [SearchCustomActionsRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def search_custom_actions(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/customization/custom-actions/search',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ResponseCustomAction.method(:from_hash))
+                    .is_api_response(true)
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 9.6.0.cl or later</span>
+    # Updates a custom action.
+    # Requires `DEVELOPER` (**Has Developer privilege**) or `ADMINISTRATION`
+    # (**Can administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # instance, the `DEVELOPER` (**Has developer privilege**) privilege is
+    # required.
+    # #### Usage Guidelines
+    # The API allows you to modify the following properties:
+    # * Name of the custom action
+    # * Action availability to groups
+    # * Association to metadata objects
+    # * Authentication settings for a URL-based action
+    # For more information, see [Custom
+    # actions](https://developers.thoughtspot.com/docs/custom-action-intro).
+    # #### Endpoint URL
+    # @param [String] custom_action_identifier Required parameter: Unique ID or
+    # name of the custom action.
+    # @param [UpdateCustomActionRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def update_custom_action(custom_action_identifier,
+                             body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/customization/custom-actions/{custom_action_identifier}/update',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(custom_action_identifier, key: 'custom_action_identifier')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+  end
+end

data/lib/thought_spot_public_rest_api/controllers/custom_calendars_controller.rb

@@ -0,0 +1,373 @@
+# thought_spot_public_rest_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module ThoughtSpotPublicRestApi
+  # CustomCalendarsController
+  class CustomCalendarsController < BaseController
+    #  <span class="since-beta-tag">Version: 10.12.0.cl or later</span>
+    # Creates a new [custom
+    # calendar](https://docs.thoughtspot.com/cloud/latest/connections-cust-cal).
+    # Requires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can
+    # administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # ThoughtSpot instance, the `CAN_MANAGE_CUSTOM_CALENDAR` (**Can manage
+    # custom calendars**) privilege is required.
+    # #### Usage guidelines
+    # You can create a custom calendar from scratch or an existing Table in
+    # ThoughtSpot. For both methods of calendar creation, the following
+    # parameters are required:
+    # * Name of the custom calendar.
+    # * Calendar creation method. To create a calendar from an existing table,
+    # specify the method:
+    #  - `FROM_EXISTING_TABLE` - Creates calendar from the table reference
+    # provided in the API request.
+    #  - `FROM_INPUT_PARAMS` - Creates a calendar from the parameters defined in
+    # the API request.
+    # * Connection ID and Table name
+    # * Database and schema name attributes:
+    #   For most Cloud Data Warehouse (CDW) connectors, both `database_name` and
+    # `schema_name` attributes are required.
+    #   However, the attribute requirements are conditional and vary based on
+    # the connector type and its metadata structure. For example, for connectors
+    # such as Teradata, MySQL, SingleSore, Amazon Aurora MySQL, Amazon RDS
+    # MySQL, Oracle, and GCP_MYSQL, the `schema_name` is required, whereas the
+    # `database_name` attribute is not.
+    #   Similarly, connectors such as ClickHouse require you to specify the
+    # `database_name` and the schema specification in such cases is optional.
+    # **NOTE**: If you are creating a calendar from an existing table, ensure
+    # that the referenced table matches the required DDL for custom calendars.
+    # If the schema does not match, the API returns an error.
+    # ##### Calendar type
+    # The API allows you to create the following types of calendars:
+    # * `MONTH_OFFSET`. The default calendar type. A `MONTH_OFFSET` calendar is
+    # offset by a few months from the standard calendar months (January to
+    # December) and the year begins with the month defined in the request. For
+    # example, if the `month_offset` value is set as `April`, the calendar year
+    # begins in April.
+    # * `4-4-5`. Each quarter in the calendar will include two 4-week months
+    # followed by one 5-week month.
+    # * `4-5-4`. Each quarter in the calendar will include two 4-week months
+    # with a 5-week month between.
+    # * `5-4-4`. Each quarter begins with a 5-week month, followed by two 4-week
+    # months.
+    # To start and end the calendar on a specific date, specify the dates in the
+    # `MM/DD/YYYY` format. For `MONTH_OFFSET` calendars, ensure that the
+    # `start_date` matches the month specified in the `month_offset` attribute.
+    # You can also set the starting day of the week and customize the prefixes
+    # for year and quarter labels.
+    # #### Examples
+    # To create a calendar from an existing table:
+    # ```
+    # {
+    #   "name": "MyCustomCalendar1",
+    #   "table_reference": {
+    #     "connection_identifier": "4db8ea22-2ff4-4224-b05a-26674717e468",
+    #     "table_name": "MyCalendarTable",
+    #     "database_name": "RETAILAPPAREL",
+    #     "schema_name": "PUBLIC"
+    #   },
+    #   "creation_method": "FROM_EXISTING_TABLE",
+    # }
+    # ```
+    # To create a calendar from scratch:
+    # ```
+    # {
+    #   "name": "MyCustomCalendar1",
+    #   "table_reference": {
+    #     "connection_identifier": "4db8ea22-2ff4-4224-b05a-26674717e468",
+    #     "table_name": "MyCalendarTable",
+    #     "database_name": "RETAILAPPAREL",
+    #     "schema_name": "PUBLIC"
+    #   },
+    #   "creation_method": "FROM_INPUT_PARAMS",
+    #   "calendar_type": "MONTH_OFFSET",
+    #   "month_offset": "April",
+    #   "start_day_of_week": "Monday",
+    #   "quarter_name_prefix": "Q",
+    #   "year_name_prefix": "FY",
+    #   "start_date": "04/01/2025",
+    #   "end_date": "04/31/2025"
+    # }
+    # ```
+    # #### Endpoint URL
+    # @param [CreateCalendarRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_calendar(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/calendars/create',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(CalendarResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 10.12.0.cl or later</span>
+    # Deletes a [custom
+    # calendar](https://docs.thoughtspot.com/cloud/latest/connections-cust-cal).
+    # Requires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can
+    # administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # ThoughtSpot instance, the `CAN_MANAGE_CUSTOM_CALENDAR` (**Can manage
+    # custom calendars**) privilege is required.
+    # #### Usage guidelines
+    # To delete a custom calendar, specify the calendar ID as a path parameter
+    # in the request URL.
+    # #### Endpoint URL
+    # @param [String] calendar_identifier Required parameter: Unique ID or name
+    # of the Calendar.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_calendar(calendar_identifier)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/calendars/{calendar_identifier}/delete',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(calendar_identifier, key: 'calendar_identifier')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 10.12.0.cl or later</span>
+    # Exports a [custom
+    # calendar](https://docs.thoughtspot.com/cloud/latest/connections-cust-cal)
+    # in the CSV format.
+    # Requires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can
+    # administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # ThoughtSpot instance, the `CAN_MANAGE_CUSTOM_CALENDAR` (**Can manage
+    # custom calendars**) privilege is required.
+    # #### Usage guidelines
+    # Use this API to download a custom calendar in the CSV file format. In your
+    # API request, specify the following parameters.
+    # * Start and end date of the calendar. For "month offset" calendars, the
+    # start date must match the month defined in the `month_offset` attribute.
+    # You can also specify optional parameters such as the starting day of the
+    # week and prefixes for the quarter and year labels.
+    # #### Endpoint URL
+    # @param [GenerateCsvRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def generate_csv(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/calendars/generate-csv',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:json_deserialize))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 10.12.0.cl or later</span>
+    # Gets a list of [custom
+    # calendars](https://docs.thoughtspot.com/cloud/latest/connections-cust-cal)
+    # .
+    # Requires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can
+    # administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # ThoughtSpot instance, the `CAN_MANAGE_CUSTOM_CALENDAR` (**Can manage
+    # custom calendars**) privilege is required.
+    # #### Usage guidelines
+    # By default, the API returns a list of custom calendars for all connection
+    # objects. To retrieve custom calendar details for a particular connection,
+    # specify the connection ID. You can also use other search parameters such
+    # as `name_pattern` and `sort_options` as search filters.
+    # The `name_pattern` parameter filters and returns only those objects that
+    # match the specified pattern. Use `%` as a wildcard for pattern matching.
+    # #### Endpoint URL
+    # @param [SearchCalendarsRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def search_calendars(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/calendars/search',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(CalendarResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+
+    #  <span class="since-beta-tag">Version: 10.12.0.cl or later</span>
+    # Updates the properties of a [custom
+    # calendar](https://docs.thoughtspot.com/cloud/latest/connections-cust-cal).
+    # Requires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can
+    # administer ThoughtSpot**) privilege.
+    # If [Role-Based Access Control
+    # (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your
+    # ThoughtSpot instance, the `CAN_MANAGE_CUSTOM_CALENDAR` (**Can manage
+    # custom calendars**) privilege is required.
+    # #### Usage guidelines
+    # You can update the properties of a calendar using one of the following
+    # methods:
+    # * `FROM_INPUT_PARAMS` to update the calendar properties with the values
+    # defined in the API request.
+    # * `FROM_EXISTING_TABLE` Creates a calendar from the parameters defined in
+    # the API request.
+    # To update a custom calendar, specify the calendar ID as a path parameter
+    # in the request URL and the following parameters in the request body:
+    # * Connection ID and Table name
+    # * Database and schema name attributes:
+    #   For most Cloud Data Warehouse (CDW) connectors, both `database_name` and
+    # `schema_name` attributes are required.
+    #   However, the attribute requirements are conditional and vary based on
+    # the connector type and its metadata structure. For example, for connectors
+    # such as Teradata, MySQL, SingleSore, Amazon Aurora MySQL, Amazon RDS
+    # MySQL, Oracle, and GCP_MYSQL, the `schema_name` is required, whereas the
+    # `database_name` attribute is not.
+    #   Similarly, connectors such as ClickHouse require you to specify the
+    # `database_name` and the schema specification in such cases is optional.
+    # The API allows you to modify the calendar type, month offset value, start
+    # and end date, starting day of the week, and prefixes assigned to the year
+    # and quarter labels.
+    # #### Examples
+    # Update a custom calendar using an existing Table in ThoughtSpot:
+    # ```
+    # {
+    #   "update_method": "FROM_EXISTING_TABLE",
+    #   "table_reference": {
+    #     "connection_identifier": "Connection1",
+    #     "database_name": "db1",
+    #     "table_name": "custom_calendar_2025",
+    #     "schame_name": "schemaVar"
+    #   }
+    # }
+    # ```
+    # Update a custom calendar with the attributes defined in the API request:
+    # ```
+    # {
+    #   "update_method": "FROM_INPUT_PARAMS",
+    #   "table_reference": {
+    #     "connection_identifier": "Connection1",
+    #     "database_name": "db1",
+    #     "table_name": "custom_calendar_2025",
+    #     "schame_name": "schemaVar"
+    #   },
+    #   "month_offset": "August",
+    #   "start_day_of_week": "Monday",
+    #   "start_date": "08/01/2025",
+    #   "end_date": "07/31/2026"
+    # }
+    # ```
+    # #### Endpoint URL
+    # @param [String] calendar_identifier Required parameter: Unique Id or name
+    # of the calendar.
+    # @param [UpdateCalendarRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def update_calendar(calendar_identifier,
+                        body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/api/rest/2.0/calendars/{calendar_identifier}/update',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(calendar_identifier, key: 'calendar_identifier')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('bearerAuth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Invalid request.',
+                                 ErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized access.',
+                                 ErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden access.',
+                                 ErrorResponseException)
+                    .local_error('500',
+                                 'Unexpected error',
+                                 ErrorResponseException))
+        .execute
+    end
+  end
+end