openlayer 0.15.0 → 0.17.0

data/lib/openlayer/models/governance/rule_stat_retrieve_params.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Governance
+      # @see Openlayer::Resources::Governance::RuleStats#retrieve
+      class RuleStatRetrieveParams < Openlayer::Internal::Type::BaseModel
+        extend Openlayer::Internal::Type::RequestParameters::Converter
+        include Openlayer::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute framework_id
+        #   Only include items belonging to this framework.
+        #
+        #   @return [String, nil]
+        optional :framework_id, String
+
+        # @!attribute project_id
+        #   Only include items that apply to this project.
+        #
+        #   @return [String, nil]
+        optional :project_id, String
+
+        # @!method initialize(workspace_id:, framework_id: nil, project_id: nil, request_options: {})
+        #   @param workspace_id [String]
+        #
+        #   @param framework_id [String] Only include items belonging to this framework.
+        #
+        #   @param project_id [String] Only include items that apply to this project.
+        #
+        #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openlayer/models/governance/rule_stat_retrieve_response.rb

@@ -0,0 +1,508 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Governance
+      # @see Openlayer::Resources::Governance::RuleStats#retrieve
+      class RuleStatRetrieveResponse < Openlayer::Internal::Type::BaseModel
+        # @!attribute rule_results
+        #   Counts of rule results, after any filters in the request, with breakdowns by the
+        #   type and scope of the rule each result belongs to.
+        #
+        #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults]
+        required :rule_results,
+                 -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults },
+                 api_name: :ruleResults
+
+        # @!attribute rules
+        #   Counts of the rules themselves, after any filters in the request.
+        #
+        #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules]
+        required :rules, -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules }
+
+        # @!method initialize(rule_results:, rules:)
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Governance::RuleStatRetrieveResponse} for more details.
+        #
+        #   Counts of rules and their results by status. Narrowed by the request's filters,
+        #   so `frameworkId` gives one framework's compliance and `projectId` gives one
+        #   project's.
+        #
+        #   @param rule_results [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults] Counts of rule results, after any filters in the request, with breakdowns by the
+        #
+        #   @param rules [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules] Counts of the rules themselves, after any filters in the request.
+
+        # @see Openlayer::Models::Governance::RuleStatRetrieveResponse#rule_results
+        class RuleResults < Openlayer::Internal::Type::BaseModel
+          # @!attribute total
+          #   The total number of rule results.
+          #
+          #   @return [Integer]
+          required :total, Integer
+
+          # @!attribute total_due_soon
+          #   The number of rule results whose evidence is about to expire.
+          #
+          #   @return [Integer]
+          required :total_due_soon, Integer, api_name: :totalDueSoon
+
+          # @!attribute total_error
+          #   The number of rule results that errored during evaluation.
+          #
+          #   @return [Integer]
+          required :total_error, Integer, api_name: :totalError
+
+          # @!attribute total_failing
+          #   The number of failing rule results.
+          #
+          #   @return [Integer]
+          required :total_failing, Integer, api_name: :totalFailing
+
+          # @!attribute total_passing
+          #   The number of passing rule results.
+          #
+          #   @return [Integer]
+          required :total_passing, Integer, api_name: :totalPassing
+
+          # @!attribute total_pending
+          #   The number of rule results that have not been satisfied yet.
+          #
+          #   @return [Integer]
+          required :total_pending, Integer, api_name: :totalPending
+
+          # @!attribute total_running
+          #   The number of rule results currently being evaluated.
+          #
+          #   @return [Integer]
+          required :total_running, Integer, api_name: :totalRunning
+
+          # @!attribute total_skipped
+          #   The number of skipped rule results.
+          #
+          #   @return [Integer]
+          required :total_skipped, Integer, api_name: :totalSkipped
+
+          # @!attribute by_rule_scope
+          #
+          #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope, nil]
+          optional :by_rule_scope,
+                   -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope },
+                   api_name: :byRuleScope
+
+          # @!attribute by_rule_type
+          #
+          #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType, nil]
+          optional :by_rule_type,
+                   -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType },
+                   api_name: :byRuleType
+
+          # @!method initialize(total:, total_due_soon:, total_error:, total_failing:, total_passing:, total_pending:, total_running:, total_skipped:, by_rule_scope: nil, by_rule_type: nil)
+          #   Counts of rule results, after any filters in the request, with breakdowns by the
+          #   type and scope of the rule each result belongs to.
+          #
+          #   @param total [Integer] The total number of rule results.
+          #
+          #   @param total_due_soon [Integer] The number of rule results whose evidence is about to expire.
+          #
+          #   @param total_error [Integer] The number of rule results that errored during evaluation.
+          #
+          #   @param total_failing [Integer] The number of failing rule results.
+          #
+          #   @param total_passing [Integer] The number of passing rule results.
+          #
+          #   @param total_pending [Integer] The number of rule results that have not been satisfied yet.
+          #
+          #   @param total_running [Integer] The number of rule results currently being evaluated.
+          #
+          #   @param total_skipped [Integer] The number of skipped rule results.
+          #
+          #   @param by_rule_scope [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope]
+          #
+          #   @param by_rule_type [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType]
+
+          # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults#by_rule_scope
+          class ByRuleScope < Openlayer::Internal::Type::BaseModel
+            # @!attribute project
+            #
+            #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Project, nil]
+            optional :project,
+                     -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Project }
+
+            # @!attribute workspace
+            #
+            #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Workspace, nil]
+            optional :workspace,
+                     -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Workspace }
+
+            # @!method initialize(project: nil, workspace: nil)
+            #   @param project [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Project]
+            #   @param workspace [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope::Workspace]
+
+            # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope#project
+            class Project < Openlayer::Internal::Type::BaseModel
+              # @!attribute total
+              #   The total number of rule results.
+              #
+              #   @return [Integer]
+              required :total, Integer
+
+              # @!attribute total_due_soon
+              #   The number of rule results whose evidence is about to expire.
+              #
+              #   @return [Integer]
+              required :total_due_soon, Integer, api_name: :totalDueSoon
+
+              # @!attribute total_error
+              #   The number of rule results that errored during evaluation.
+              #
+              #   @return [Integer]
+              required :total_error, Integer, api_name: :totalError
+
+              # @!attribute total_failing
+              #   The number of failing rule results.
+              #
+              #   @return [Integer]
+              required :total_failing, Integer, api_name: :totalFailing
+
+              # @!attribute total_passing
+              #   The number of passing rule results.
+              #
+              #   @return [Integer]
+              required :total_passing, Integer, api_name: :totalPassing
+
+              # @!attribute total_pending
+              #   The number of rule results that have not been satisfied yet.
+              #
+              #   @return [Integer]
+              required :total_pending, Integer, api_name: :totalPending
+
+              # @!attribute total_running
+              #   The number of rule results currently being evaluated.
+              #
+              #   @return [Integer]
+              required :total_running, Integer, api_name: :totalRunning
+
+              # @!attribute total_skipped
+              #   The number of skipped rule results.
+              #
+              #   @return [Integer]
+              required :total_skipped, Integer, api_name: :totalSkipped
+
+              # @!method initialize(total:, total_due_soon:, total_error:, total_failing:, total_passing:, total_pending:, total_running:, total_skipped:)
+              #   @param total [Integer] The total number of rule results.
+              #
+              #   @param total_due_soon [Integer] The number of rule results whose evidence is about to expire.
+              #
+              #   @param total_error [Integer] The number of rule results that errored during evaluation.
+              #
+              #   @param total_failing [Integer] The number of failing rule results.
+              #
+              #   @param total_passing [Integer] The number of passing rule results.
+              #
+              #   @param total_pending [Integer] The number of rule results that have not been satisfied yet.
+              #
+              #   @param total_running [Integer] The number of rule results currently being evaluated.
+              #
+              #   @param total_skipped [Integer] The number of skipped rule results.
+            end
+
+            # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleScope#workspace
+            class Workspace < Openlayer::Internal::Type::BaseModel
+              # @!attribute total
+              #   The total number of rule results.
+              #
+              #   @return [Integer]
+              required :total, Integer
+
+              # @!attribute total_due_soon
+              #   The number of rule results whose evidence is about to expire.
+              #
+              #   @return [Integer]
+              required :total_due_soon, Integer, api_name: :totalDueSoon
+
+              # @!attribute total_error
+              #   The number of rule results that errored during evaluation.
+              #
+              #   @return [Integer]
+              required :total_error, Integer, api_name: :totalError
+
+              # @!attribute total_failing
+              #   The number of failing rule results.
+              #
+              #   @return [Integer]
+              required :total_failing, Integer, api_name: :totalFailing
+
+              # @!attribute total_passing
+              #   The number of passing rule results.
+              #
+              #   @return [Integer]
+              required :total_passing, Integer, api_name: :totalPassing
+
+              # @!attribute total_pending
+              #   The number of rule results that have not been satisfied yet.
+              #
+              #   @return [Integer]
+              required :total_pending, Integer, api_name: :totalPending
+
+              # @!attribute total_running
+              #   The number of rule results currently being evaluated.
+              #
+              #   @return [Integer]
+              required :total_running, Integer, api_name: :totalRunning
+
+              # @!attribute total_skipped
+              #   The number of skipped rule results.
+              #
+              #   @return [Integer]
+              required :total_skipped, Integer, api_name: :totalSkipped
+
+              # @!method initialize(total:, total_due_soon:, total_error:, total_failing:, total_passing:, total_pending:, total_running:, total_skipped:)
+              #   @param total [Integer] The total number of rule results.
+              #
+              #   @param total_due_soon [Integer] The number of rule results whose evidence is about to expire.
+              #
+              #   @param total_error [Integer] The number of rule results that errored during evaluation.
+              #
+              #   @param total_failing [Integer] The number of failing rule results.
+              #
+              #   @param total_passing [Integer] The number of passing rule results.
+              #
+              #   @param total_pending [Integer] The number of rule results that have not been satisfied yet.
+              #
+              #   @param total_running [Integer] The number of rule results currently being evaluated.
+              #
+              #   @param total_skipped [Integer] The number of skipped rule results.
+            end
+          end
+
+          # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults#by_rule_type
+          class ByRuleType < Openlayer::Internal::Type::BaseModel
+            # @!attribute evidence
+            #
+            #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Evidence, nil]
+            optional :evidence,
+                     -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Evidence }
+
+            # @!attribute platform
+            #
+            #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Platform, nil]
+            optional :platform,
+                     -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Platform }
+
+            # @!method initialize(evidence: nil, platform: nil)
+            #   @param evidence [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Evidence]
+            #   @param platform [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType::Platform]
+
+            # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType#evidence
+            class Evidence < Openlayer::Internal::Type::BaseModel
+              # @!attribute total
+              #   The total number of rule results.
+              #
+              #   @return [Integer]
+              required :total, Integer
+
+              # @!attribute total_due_soon
+              #   The number of rule results whose evidence is about to expire.
+              #
+              #   @return [Integer]
+              required :total_due_soon, Integer, api_name: :totalDueSoon
+
+              # @!attribute total_error
+              #   The number of rule results that errored during evaluation.
+              #
+              #   @return [Integer]
+              required :total_error, Integer, api_name: :totalError
+
+              # @!attribute total_failing
+              #   The number of failing rule results.
+              #
+              #   @return [Integer]
+              required :total_failing, Integer, api_name: :totalFailing
+
+              # @!attribute total_passing
+              #   The number of passing rule results.
+              #
+              #   @return [Integer]
+              required :total_passing, Integer, api_name: :totalPassing
+
+              # @!attribute total_pending
+              #   The number of rule results that have not been satisfied yet.
+              #
+              #   @return [Integer]
+              required :total_pending, Integer, api_name: :totalPending
+
+              # @!attribute total_running
+              #   The number of rule results currently being evaluated.
+              #
+              #   @return [Integer]
+              required :total_running, Integer, api_name: :totalRunning
+
+              # @!attribute total_skipped
+              #   The number of skipped rule results.
+              #
+              #   @return [Integer]
+              required :total_skipped, Integer, api_name: :totalSkipped
+
+              # @!method initialize(total:, total_due_soon:, total_error:, total_failing:, total_passing:, total_pending:, total_running:, total_skipped:)
+              #   @param total [Integer] The total number of rule results.
+              #
+              #   @param total_due_soon [Integer] The number of rule results whose evidence is about to expire.
+              #
+              #   @param total_error [Integer] The number of rule results that errored during evaluation.
+              #
+              #   @param total_failing [Integer] The number of failing rule results.
+              #
+              #   @param total_passing [Integer] The number of passing rule results.
+              #
+              #   @param total_pending [Integer] The number of rule results that have not been satisfied yet.
+              #
+              #   @param total_running [Integer] The number of rule results currently being evaluated.
+              #
+              #   @param total_skipped [Integer] The number of skipped rule results.
+            end
+
+            # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults::ByRuleType#platform
+            class Platform < Openlayer::Internal::Type::BaseModel
+              # @!attribute total
+              #   The total number of rule results.
+              #
+              #   @return [Integer]
+              required :total, Integer
+
+              # @!attribute total_due_soon
+              #   The number of rule results whose evidence is about to expire.
+              #
+              #   @return [Integer]
+              required :total_due_soon, Integer, api_name: :totalDueSoon
+
+              # @!attribute total_error
+              #   The number of rule results that errored during evaluation.
+              #
+              #   @return [Integer]
+              required :total_error, Integer, api_name: :totalError
+
+              # @!attribute total_failing
+              #   The number of failing rule results.
+              #
+              #   @return [Integer]
+              required :total_failing, Integer, api_name: :totalFailing
+
+              # @!attribute total_passing
+              #   The number of passing rule results.
+              #
+              #   @return [Integer]
+              required :total_passing, Integer, api_name: :totalPassing
+
+              # @!attribute total_pending
+              #   The number of rule results that have not been satisfied yet.
+              #
+              #   @return [Integer]
+              required :total_pending, Integer, api_name: :totalPending
+
+              # @!attribute total_running
+              #   The number of rule results currently being evaluated.
+              #
+              #   @return [Integer]
+              required :total_running, Integer, api_name: :totalRunning
+
+              # @!attribute total_skipped
+              #   The number of skipped rule results.
+              #
+              #   @return [Integer]
+              required :total_skipped, Integer, api_name: :totalSkipped
+
+              # @!method initialize(total:, total_due_soon:, total_error:, total_failing:, total_passing:, total_pending:, total_running:, total_skipped:)
+              #   @param total [Integer] The total number of rule results.
+              #
+              #   @param total_due_soon [Integer] The number of rule results whose evidence is about to expire.
+              #
+              #   @param total_error [Integer] The number of rule results that errored during evaluation.
+              #
+              #   @param total_failing [Integer] The number of failing rule results.
+              #
+              #   @param total_passing [Integer] The number of passing rule results.
+              #
+              #   @param total_pending [Integer] The number of rule results that have not been satisfied yet.
+              #
+              #   @param total_running [Integer] The number of rule results currently being evaluated.
+              #
+              #   @param total_skipped [Integer] The number of skipped rule results.
+            end
+          end
+        end
+
+        # @see Openlayer::Models::Governance::RuleStatRetrieveResponse#rules
+        class Rules < Openlayer::Internal::Type::BaseModel
+          # @!attribute by_scope
+          #   Rule counts by scope.
+          #
+          #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByScope, nil]
+          optional :by_scope,
+                   -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByScope },
+                   api_name: :byScope
+
+          # @!attribute by_type
+          #   Rule counts by type.
+          #
+          #   @return [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByType, nil]
+          optional :by_type,
+                   -> { Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByType },
+                   api_name: :byType
+
+          # @!attribute total
+          #   The total number of rules.
+          #
+          #   @return [Integer, nil]
+          optional :total, Integer
+
+          # @!method initialize(by_scope: nil, by_type: nil, total: nil)
+          #   Counts of the rules themselves, after any filters in the request.
+          #
+          #   @param by_scope [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByScope] Rule counts by scope.
+          #
+          #   @param by_type [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules::ByType] Rule counts by type.
+          #
+          #   @param total [Integer] The total number of rules.
+
+          # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules#by_scope
+          class ByScope < Openlayer::Internal::Type::BaseModel
+            # @!attribute project
+            #
+            #   @return [Integer, nil]
+            optional :project, Integer
+
+            # @!attribute workspace
+            #
+            #   @return [Integer, nil]
+            optional :workspace, Integer
+
+            # @!method initialize(project: nil, workspace: nil)
+            #   Rule counts by scope.
+            #
+            #   @param project [Integer]
+            #   @param workspace [Integer]
+          end
+
+          # @see Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules#by_type
+          class ByType < Openlayer::Internal::Type::BaseModel
+            # @!attribute evidence
+            #
+            #   @return [Integer, nil]
+            optional :evidence, Integer
+
+            # @!attribute platform
+            #
+            #   @return [Integer, nil]
+            optional :platform, Integer
+
+            # @!method initialize(evidence: nil, platform: nil)
+            #   Rule counts by type.
+            #
+            #   @param evidence [Integer]
+            #   @param platform [Integer]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openlayer/models/governance/rule_tag_list_params.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Governance
+      # @see Openlayer::Resources::Governance::RuleTags#list
+      class RuleTagListParams < Openlayer::Internal::Type::BaseModel
+        extend Openlayer::Internal::Type::RequestParameters::Converter
+        include Openlayer::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute page
+        #   The page to return in a paginated query.
+        #
+        #   @return [Integer, nil]
+        optional :page, Integer
+
+        # @!attribute per_page
+        #   Maximum number of items to return per page.
+        #
+        #   @return [Integer, nil]
+        optional :per_page, Integer
+
+        # @!method initialize(workspace_id:, page: nil, per_page: nil, request_options: {})
+        #   @param workspace_id [String]
+        #
+        #   @param page [Integer] The page to return in a paginated query.
+        #
+        #   @param per_page [Integer] Maximum number of items to return per page.
+        #
+        #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openlayer/models/governance/rule_tag_list_response.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Governance
+      # @see Openlayer::Resources::Governance::RuleTags#list
+      class RuleTagListResponse < Openlayer::Internal::Type::BaseModel
+        # @!attribute items
+        #
+        #   @return [Array<Openlayer::Models::Governance::RuleTagListResponse::Item>]
+        required :items,
+                 -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleTagListResponse::Item] }
+
+        # @!method initialize(items:)
+        #   @param items [Array<Openlayer::Models::Governance::RuleTagListResponse::Item>]
+
+        class Item < Openlayer::Internal::Type::BaseModel
+          # @!attribute name
+          #   The tag name.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute color
+          #   The color the tag is displayed with.
+          #
+          #   @return [String, nil]
+          optional :color, String, nil?: true
+
+          response_only do
+            # @!attribute id
+            #   The rule tag id.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute creator_id
+            #   The user who created the tag. `null` for tags that ship with Openlayer.
+            #
+            #   @return [String, nil]
+            required :creator_id, String, api_name: :creatorId, nil?: true
+
+            # @!attribute date_created
+            #   The creation date.
+            #
+            #   @return [Time]
+            required :date_created, Time, api_name: :dateCreated
+
+            # @!attribute date_updated
+            #   The last update date.
+            #
+            #   @return [Time]
+            required :date_updated, Time, api_name: :dateUpdated
+
+            # @!attribute immutable
+            #   Whether the tag is managed by Openlayer. These tags can't be deleted.
+            #
+            #   @return [Boolean]
+            required :immutable, Openlayer::Internal::Type::Boolean
+
+            # @!attribute workspace_id
+            #   The id of the workspace the tag belongs to.
+            #
+            #   @return [String]
+            required :workspace_id, String, api_name: :workspaceId
+          end
+
+          # @!method initialize(id:, creator_id:, date_created:, date_updated:, immutable:, name:, workspace_id:, color: nil)
+          #   A label that groups rules across frameworks, for example by team or control
+          #   family.
+          #
+          #   @param id [String] The rule tag id.
+          #
+          #   @param creator_id [String, nil] The user who created the tag. `null` for tags that ship with Openlayer.
+          #
+          #   @param date_created [Time] The creation date.
+          #
+          #   @param date_updated [Time] The last update date.
+          #
+          #   @param immutable [Boolean] Whether the tag is managed by Openlayer. These tags can't be deleted.
+          #
+          #   @param name [String] The tag name.
+          #
+          #   @param workspace_id [String] The id of the workspace the tag belongs to.
+          #
+          #   @param color [String, nil] The color the tag is displayed with.
+        end
+      end
+    end
+  end
+end