openlayer 0.16.0 → 0.17.0

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

@@ -13,14 +13,16 @@ module Openlayer
 
         # @!attribute scope
         #   Whether the rule is evaluated once for the whole workspace, or once per project
-        #   the rule's frameworks apply to.
+        #   the rule's frameworks apply to. Must be `project` for platform rules. Fixed once
+        #   the rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Scope]
         required :scope, enum: -> { Openlayer::Models::Governance::RuleUpdateResponse::Scope }
 
         # @!attribute type
         #   `platform` rules are evaluated automatically from the state of your Openlayer
-        #   workspace. `evidence` rules are satisfied by attaching evidence.
+        #   workspace. `evidence` rules are satisfied by attaching evidence. Fixed once the
+        #   rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Type]
         required :type, enum: -> { Openlayer::Models::Governance::RuleUpdateResponse::Type }
@@ -32,7 +34,8 @@ module Openlayer
         optional :assignee_id, String, api_name: :assigneeId, nil?: true
 
         # @!attribute automation_params
-        #   Configuration for the platform check, when the automation takes parameters.
+        #   Configuration for the platform check, when the automation takes parameters. Omit
+        #   or `null` for evidence rules. Fixed once the rule is created.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :automation_params,
@@ -42,8 +45,9 @@ module Openlayer
 
         # @!attribute automation_type
         #   Which workspace signal a platform rule checks, for example
-        #   `monitoring_mode_enabled`, `test_setup`, or `project_owner_set`. `null` for
-        #   evidence rules.
+        #   `monitoring_mode_enabled`, `test_setup`, or `project_owner_set`. Set it for
+        #   platform rules; omit or `null` for evidence rules. Fixed once the rule is
+        #   created.
         #
         #   @return [String, nil]
         optional :automation_type, String, api_name: :automationType, nil?: true
@@ -61,7 +65,8 @@ module Openlayer
         optional :description, String, nil?: true
 
         # @!attribute evidence_type
-        #   The kind of evidence that satisfies the rule. `null` for platform rules.
+        #   The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
+        #   `null` for platform rules. Fixed once the rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::EvidenceType, nil]
         optional :evidence_type,
@@ -71,7 +76,8 @@ module Openlayer
 
         # @!attribute renewal_cadence_days
         #   How often evidence must be renewed, in days. Once evidence is older than this,
-        #   the rule result becomes `due_soon` and then `failing`.
+        #   the rule result becomes `due_soon` and then `failing`. The window restarts
+        #   whenever evidence is attached. Omit or `null` for platform rules.
         #
         #   @return [Integer, nil]
         optional :renewal_cadence_days, Integer, api_name: :renewalCadenceDays, nil?: true
@@ -109,7 +115,8 @@ module Openlayer
                    -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleUpdateResponse::Framework] }
 
           # @!attribute immutable
-          #   Whether the rule is managed by Openlayer and cannot be edited.
+          #   Whether the rule is managed by Openlayer. These rules can't be renamed or
+          #   deleted; set `deactivated` to exclude one from compliance instead.
           #
           #   @return [Boolean, nil]
           optional :immutable, Openlayer::Internal::Type::Boolean
@@ -145,6 +152,11 @@ module Openlayer
         #   Some parameter documentations has been truncated, see
         #   {Openlayer::Models::Governance::RuleUpdateResponse} for more details.
         #
+        #   A single requirement Openlayer tracks. `platform` rules are evaluated
+        #   automatically from the state of your workspace, and `evidence` rules are
+        #   satisfied by attaching evidence. A rule can belong to several frameworks, or to
+        #   none.
+        #
         #   @param id [String] The rule id.
         #
         #   @param date_created [Time] The creation date.
@@ -161,7 +173,7 @@ module Openlayer
         #
         #   @param assignee_id [String, nil] The user responsible for satisfying the rule.
         #
-        #   @param automation_params [Hash{Symbol=>Object}, nil] Configuration for the platform check, when the automation takes parameters.
+        #   @param automation_params [Hash{Symbol=>Object}, nil] Configuration for the platform check, when the automation takes parameters. Omit
         #
         #   @param automation_type [String, nil] Which workspace signal a platform rule checks, for example `monitoring_mode_enab
         #
@@ -169,11 +181,11 @@ module Openlayer
         #
         #   @param description [String, nil] What the rule requires.
         #
-        #   @param evidence_type [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::EvidenceType, nil] The kind of evidence that satisfies the rule. `null` for platform rules.
+        #   @param evidence_type [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::EvidenceType, nil] The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
         #
         #   @param frameworks [Array<Openlayer::Models::Governance::RuleUpdateResponse::Framework>] The frameworks that include this rule.
         #
-        #   @param immutable [Boolean] Whether the rule is managed by Openlayer and cannot be edited.
+        #   @param immutable [Boolean] Whether the rule is managed by Openlayer. These rules can't be renamed or delete
         #
         #   @param renewal_cadence_days [Integer, nil] How often evidence must be renewed, in days. Once evidence is older than this, t
         #
@@ -184,7 +196,8 @@ module Openlayer
         #   @param tags [Array<Openlayer::Models::Governance::RuleUpdateResponse::Tag>, nil] The rule tags associated with the rule.
 
         # Whether the rule is evaluated once for the whole workspace, or once per project
-        # the rule's frameworks apply to.
+        # the rule's frameworks apply to. Must be `project` for platform rules. Fixed once
+        # the rule is created.
         #
         # @see Openlayer::Models::Governance::RuleUpdateResponse#scope
         module Scope
@@ -198,7 +211,8 @@ module Openlayer
         end
 
         # `platform` rules are evaluated automatically from the state of your Openlayer
-        # workspace. `evidence` rules are satisfied by attaching evidence.
+        # workspace. `evidence` rules are satisfied by attaching evidence. Fixed once the
+        # rule is created.
         #
         # @see Openlayer::Models::Governance::RuleUpdateResponse#type
         module Type
@@ -211,7 +225,8 @@ module Openlayer
           #   @return [Array<Symbol>]
         end
 
-        # The kind of evidence that satisfies the rule. `null` for platform rules.
+        # The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
+        # `null` for platform rules. Fixed once the rule is created.
         #
         # @see Openlayer::Models::Governance::RuleUpdateResponse#evidence_type
         module EvidenceType
@@ -311,13 +326,15 @@ module Openlayer
 
         class Result < Openlayer::Internal::Type::BaseModel
           # @!attribute deactivated
-          #   Whether this result is excluded from compliance calculations.
+          #   Whether this result is excluded from compliance calculations. Excludes just this
+          #   result, without deactivating the rule everywhere.
           #
           #   @return [Boolean]
           required :deactivated, Openlayer::Internal::Type::Boolean
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Status]
           required :status, enum: -> { Openlayer::Models::Governance::RuleUpdateResponse::Result::Status }
@@ -344,7 +361,7 @@ module Openlayer
                    -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking] }
 
           # @!attribute deactivated_reason
-          #   Why the result was excluded.
+          #   Why the result was excluded. Required when setting `deactivated` to `true`.
           #
           #   @return [String, nil]
           optional :deactivated_reason, String, api_name: :deactivatedReason, nil?: true
@@ -418,17 +435,23 @@ module Openlayer
           end
 
           # @!method initialize(id:, date_created:, date_updated:, deactivated:, rule_id:, status:, workspace_id:, assignee_id: nil, blocked_by: nil, blocking: nil, date_last_evaluated: nil, date_of_latest_evidence: nil, date_of_next_evaluation: nil, date_of_renewal: nil, deactivated_reason: nil, project_id: nil, status_message: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleUpdateResponse::Result} for more details.
+          #
+          #   The compliance status of one rule for one entity: a project for project-scoped
+          #   rules, or the workspace for workspace-scoped rules.
+          #
           #   @param id [String] The rule result id.
           #
           #   @param date_created [Time] The creation date.
           #
           #   @param date_updated [Time] The last update date.
           #
-          #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations.
+          #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations. Excludes just this
           #
           #   @param rule_id [String] The rule this result belongs to.
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
           #
           #   @param workspace_id [String] The id of the workspace the rule result belongs to.
           #
@@ -446,13 +469,14 @@ module Openlayer
           #
           #   @param date_of_renewal [Time, nil] When the evidence must be renewed. Evidence rules with a renewal cadence only.
           #
-          #   @param deactivated_reason [String, nil] Why the result was excluded.
+          #   @param deactivated_reason [String, nil] Why the result was excluded. Required when setting `deactivated` to `true`.
           #
           #   @param project_id [String, nil] The project this result was evaluated for. `null` for workspace-scoped rules.
           #
           #   @param status_message [String, nil] A human-readable explanation of the status.
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleUpdateResponse::Result#status
           module Status
@@ -477,18 +501,24 @@ module Openlayer
             optional :id, String
 
             # @!attribute status
-            #   The compliance status of the rule for this entity.
+            #   The compliance status of the rule for this entity. Computed by Openlayer and
+            #   can't be set directly.
             #
             #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy::Status, nil]
             optional :status,
                      enum: -> { Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy::Status }
 
             # @!method initialize(id: nil, status: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy} for more
+            #   details.
+            #
             #   @param id [String]
             #
-            #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy::Status] The compliance status of the rule for this entity.
+            #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-            # The compliance status of the rule for this entity.
+            # The compliance status of the rule for this entity. Computed by Openlayer and
+            # can't be set directly.
             #
             # @see Openlayer::Models::Governance::RuleUpdateResponse::Result::BlockedBy#status
             module Status
@@ -514,17 +544,23 @@ module Openlayer
             optional :id, String
 
             # @!attribute status
-            #   The compliance status of the rule for this entity.
+            #   The compliance status of the rule for this entity. Computed by Openlayer and
+            #   can't be set directly.
             #
             #   @return [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking::Status, nil]
             optional :status, enum: -> { Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking::Status }
 
             # @!method initialize(id: nil, status: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking} for more
+            #   details.
+            #
             #   @param id [String]
             #
-            #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking::Status] The compliance status of the rule for this entity.
+            #   @param status [Symbol, Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-            # The compliance status of the rule for this entity.
+            # The compliance status of the rule for this entity. Computed by Openlayer and
+            # can't be set directly.
             #
             # @see Openlayer::Models::Governance::RuleUpdateResponse::Result::Blocking#status
             module Status
@@ -603,7 +639,7 @@ module Openlayer
             required :date_updated, Time, api_name: :dateUpdated
 
             # @!attribute immutable
-            #   Whether the tag is managed by Openlayer and cannot be edited or deleted.
+            #   Whether the tag is managed by Openlayer. These tags can't be deleted.
             #
             #   @return [Boolean]
             required :immutable, Openlayer::Internal::Type::Boolean
@@ -616,6 +652,9 @@ module Openlayer
           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.
@@ -624,7 +663,7 @@ module Openlayer
           #
           #   @param date_updated [Time] The last update date.
           #
-          #   @param immutable [Boolean] Whether the tag is managed by Openlayer and cannot be edited or deleted.
+          #   @param immutable [Boolean] Whether the tag is managed by Openlayer. These tags can't be deleted.
           #
           #   @param name [String] The tag name.
           #

data/lib/openlayer/models/inference_pipeline_retrieve_sessions_response.rb

@@ -92,6 +92,9 @@ module Openlayer
         required :user_ids, Openlayer::Internal::Type::ArrayOf[String], api_name: :userIds
 
         # @!method initialize(id:, cost:, date_created:, date_of_first_record:, date_of_last_record:, duration:, first_record:, last_record:, latency:, records:, tokens:, user_ids:)
+        #   A session in an inference pipeline, with its activity stats: record counts,
+        #   token usage, cost, latency, and its first and last records.
+        #
         #   @param id [String] The unique session identifier
         #
         #   @param cost [Float] Total cost for the session

data/lib/openlayer/models/inference_pipeline_retrieve_users_response.rb

@@ -58,6 +58,9 @@ module Openlayer
         required :tokens, Float
 
         # @!method initialize(id:, cost:, date_of_first_record:, date_of_last_record:, records:, sessions:, tokens:)
+        #   A user who has interacted with an inference pipeline, with their activity stats:
+        #   session and record counts, token usage, and cost.
+        #
         #   @param id [String] The unique user identifier
         #
         #   @param cost [Float] Total cost for this user

data/lib/openlayer/models/storage/presigned_url_retrieve_params.rb

@@ -9,13 +9,17 @@ module Openlayer
         include Openlayer::Internal::Type::RequestParameters
 
         # @!attribute storage_uri
-        #   The object's storage uri.
+        #   The object's storage uri, for example `outputs.storageUri` from a framework
+        #   export's background task.
         #
         #   @return [String]
         required :storage_uri, String
 
         # @!method initialize(storage_uri:, request_options: {})
-        #   @param storage_uri [String] The object's storage uri.
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Storage::PresignedURLRetrieveParams} for more details.
+        #
+        #   @param storage_uri [String] The object's storage uri, for example `outputs.storageUri` from a framework expo
         #
         #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openlayer/models/workspaces/api_key_create_params.rb

@@ -13,15 +13,31 @@ module Openlayer
         #   @return [String]
         required :workspace_id, String
 
+        # @!attribute expires_at
+        #   When the key stops authenticating. `null` means the key never expires. Set when
+        #   the key is created or rotated, and must be in the future. When the request is
+        #   authenticated with an API key that expires, the result can't be later than that
+        #   key's expiry. On create, omit it to inherit that expiry. On rotate, omit it to
+        #   keep the current one. It can't be changed with an update; rotate the key
+        #   instead.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, api_name: :expiresAt, nil?: true
+
         # @!attribute name
         #   The API key name.
         #
         #   @return [String, nil]
         optional :name, String, nil?: true
 
-        # @!method initialize(workspace_id:, name: nil, request_options: {})
+        # @!method initialize(workspace_id:, expires_at: nil, name: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Workspaces::APIKeyCreateParams} for more details.
+        #
         #   @param workspace_id [String]
         #
+        #   @param expires_at [Time, nil] When the key stops authenticating. `null` means the key never expires. Set when
+        #
         #   @param name [String, nil] The API key name.
         #
         #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]

data/lib/openlayer/models/workspaces/api_key_create_response.rb

@@ -5,6 +5,17 @@ module Openlayer
     module Workspaces
       # @see Openlayer::Resources::Workspaces::APIKeys#create
       class APIKeyCreateResponse < Openlayer::Internal::Type::BaseModel
+        # @!attribute expires_at
+        #   When the key stops authenticating. `null` means the key never expires. Set when
+        #   the key is created or rotated, and must be in the future. When the request is
+        #   authenticated with an API key that expires, the result can't be later than that
+        #   key's expiry. On create, omit it to inherit that expiry. On rotate, omit it to
+        #   keep the current one. It can't be changed with an update; rotate the key
+        #   instead.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, api_name: :expiresAt, nil?: true
+
         # @!attribute name
         #   The API key name.
         #
@@ -37,13 +48,45 @@ module Openlayer
           required :date_updated, Time, api_name: :dateUpdated
 
           # @!attribute secure_key
-          #   The API key value.
+          #   An obfuscated hint of the API key value. When a key is created or rotated this
+          #   also holds the full secret, for backward compatibility; prefer `secret`.
           #
           #   @return [String]
           required :secure_key, String, api_name: :secureKey
+
+          # @!attribute status
+          #   The key's lifecycle state. `active`: the current secret authenticates.
+          #   `rotating`: the key was rotated and the previous secret still authenticates
+          #   until `previousKeyExpiresAt`. `expired`: `expiresAt` has passed, no secret
+          #   authenticates, and the key can't be rotated.
+          #
+          #   @return [Symbol, Openlayer::Models::Workspaces::APIKeyCreateResponse::Status]
+          required :status, enum: -> { Openlayer::Models::Workspaces::APIKeyCreateResponse::Status }
+
+          # @!attribute last_rotated_at
+          #   When the key was last rotated.
+          #
+          #   @return [Time, nil]
+          optional :last_rotated_at, Time, api_name: :lastRotatedAt, nil?: true
+
+          # @!attribute previous_key_expires_at
+          #   While `status` is `rotating`, when the previous secret stops authenticating.
+          #
+          #   @return [Time, nil]
+          optional :previous_key_expires_at, Time, api_name: :previousKeyExpiresAt, nil?: true
+
+          # @!attribute secret
+          #   The full API key. Only present in the response that creates or rotates the key,
+          #   and never shown again.
+          #
+          #   @return [String, nil]
+          optional :secret, String
         end
 
-        # @!method initialize(id:, date_created:, date_last_used:, date_updated:, secure_key:, name: nil)
+        # @!method initialize(id:, date_created:, date_last_used:, date_updated:, secure_key:, status:, expires_at: nil, last_rotated_at: nil, name: nil, previous_key_expires_at: nil, secret: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Workspaces::APIKeyCreateResponse} for more details.
+        #
         #   @param id [String] The API key id.
         #
         #   @param date_created [Time] The API key creation date.
@@ -52,9 +95,36 @@ module Openlayer
         #
         #   @param date_updated [Time] The API key last update date.
         #
-        #   @param secure_key [String] The API key value.
+        #   @param secure_key [String] An obfuscated hint of the API key value. When a key is created or rotated this a
+        #
+        #   @param status [Symbol, Openlayer::Models::Workspaces::APIKeyCreateResponse::Status] The key's lifecycle state. `active`: the current secret authenticates. `rotating
+        #
+        #   @param expires_at [Time, nil] When the key stops authenticating. `null` means the key never expires. Set when
+        #
+        #   @param last_rotated_at [Time, nil] When the key was last rotated.
         #
         #   @param name [String, nil] The API key name.
+        #
+        #   @param previous_key_expires_at [Time, nil] While `status` is `rotating`, when the previous secret stops authenticating.
+        #
+        #   @param secret [String] The full API key. Only present in the response that creates or rotates the key,
+
+        # The key's lifecycle state. `active`: the current secret authenticates.
+        # `rotating`: the key was rotated and the previous secret still authenticates
+        # until `previousKeyExpiresAt`. `expired`: `expiresAt` has passed, no secret
+        # authenticates, and the key can't be rotated.
+        #
+        # @see Openlayer::Models::Workspaces::APIKeyCreateResponse#status
+        module Status
+          extend Openlayer::Internal::Type::Enum
+
+          ACTIVE = :active
+          ROTATING = :rotating
+          EXPIRED = :expired
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/openlayer/models/workspaces/api_key_delete_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Workspaces
+      # @see Openlayer::Resources::Workspaces::APIKeys#delete
+      class APIKeyDeleteParams < 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 api_key_id
+        #
+        #   @return [String]
+        required :api_key_id, String
+
+        # @!method initialize(workspace_id:, api_key_id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param api_key_id [String]
+        #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openlayer/models/workspaces/api_key_list_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Workspaces
+      # @see Openlayer::Resources::Workspaces::APIKeys#list
+      class APIKeyListParams < Openlayer::Internal::Type::BaseModel
+        extend Openlayer::Internal::Type::RequestParameters::Converter
+        include Openlayer::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!method initialize(workspace_id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openlayer/models/workspaces/api_key_list_response.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    module Workspaces
+      class APIKeyListResponseItem < Openlayer::Internal::Type::BaseModel
+        # @!attribute expires_at
+        #   When the key stops authenticating. `null` means the key never expires. Set when
+        #   the key is created or rotated, and must be in the future. When the request is
+        #   authenticated with an API key that expires, the result can't be later than that
+        #   key's expiry. On create, omit it to inherit that expiry. On rotate, omit it to
+        #   keep the current one. It can't be changed with an update; rotate the key
+        #   instead.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, api_name: :expiresAt, nil?: true
+
+        # @!attribute name
+        #   The API key name.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        response_only do
+          # @!attribute id
+          #   The API key id.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute date_created
+          #   The API key creation date.
+          #
+          #   @return [Time]
+          required :date_created, Time, api_name: :dateCreated
+
+          # @!attribute date_last_used
+          #   The API key last use date.
+          #
+          #   @return [Time, nil]
+          required :date_last_used, Time, api_name: :dateLastUsed, nil?: true
+
+          # @!attribute date_updated
+          #   The API key last update date.
+          #
+          #   @return [Time]
+          required :date_updated, Time, api_name: :dateUpdated
+
+          # @!attribute secure_key
+          #   An obfuscated hint of the API key value. When a key is created or rotated this
+          #   also holds the full secret, for backward compatibility; prefer `secret`.
+          #
+          #   @return [String]
+          required :secure_key, String, api_name: :secureKey
+
+          # @!attribute status
+          #   The key's lifecycle state. `active`: the current secret authenticates.
+          #   `rotating`: the key was rotated and the previous secret still authenticates
+          #   until `previousKeyExpiresAt`. `expired`: `expiresAt` has passed, no secret
+          #   authenticates, and the key can't be rotated.
+          #
+          #   @return [Symbol, Openlayer::Models::Workspaces::APIKeyListResponseItem::Status]
+          required :status, enum: -> { Openlayer::Models::Workspaces::APIKeyListResponseItem::Status }
+
+          # @!attribute last_rotated_at
+          #   When the key was last rotated.
+          #
+          #   @return [Time, nil]
+          optional :last_rotated_at, Time, api_name: :lastRotatedAt, nil?: true
+
+          # @!attribute previous_key_expires_at
+          #   While `status` is `rotating`, when the previous secret stops authenticating.
+          #
+          #   @return [Time, nil]
+          optional :previous_key_expires_at, Time, api_name: :previousKeyExpiresAt, nil?: true
+
+          # @!attribute secret
+          #   The full API key. Only present in the response that creates or rotates the key,
+          #   and never shown again.
+          #
+          #   @return [String, nil]
+          optional :secret, String
+        end
+
+        # @!method initialize(id:, date_created:, date_last_used:, date_updated:, secure_key:, status:, expires_at: nil, last_rotated_at: nil, name: nil, previous_key_expires_at: nil, secret: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Workspaces::APIKeyListResponseItem} for more details.
+        #
+        #   @param id [String] The API key id.
+        #
+        #   @param date_created [Time] The API key creation date.
+        #
+        #   @param date_last_used [Time, nil] The API key last use date.
+        #
+        #   @param date_updated [Time] The API key last update date.
+        #
+        #   @param secure_key [String] An obfuscated hint of the API key value. When a key is created or rotated this a
+        #
+        #   @param status [Symbol, Openlayer::Models::Workspaces::APIKeyListResponseItem::Status] The key's lifecycle state. `active`: the current secret authenticates. `rotating
+        #
+        #   @param expires_at [Time, nil] When the key stops authenticating. `null` means the key never expires. Set when
+        #
+        #   @param last_rotated_at [Time, nil] When the key was last rotated.
+        #
+        #   @param name [String, nil] The API key name.
+        #
+        #   @param previous_key_expires_at [Time, nil] While `status` is `rotating`, when the previous secret stops authenticating.
+        #
+        #   @param secret [String] The full API key. Only present in the response that creates or rotates the key,
+
+        # The key's lifecycle state. `active`: the current secret authenticates.
+        # `rotating`: the key was rotated and the previous secret still authenticates
+        # until `previousKeyExpiresAt`. `expired`: `expiresAt` has passed, no secret
+        # authenticates, and the key can't be rotated.
+        #
+        # @see Openlayer::Models::Workspaces::APIKeyListResponseItem#status
+        module Status
+          extend Openlayer::Internal::Type::Enum
+
+          ACTIVE = :active
+          ROTATING = :rotating
+          EXPIRED = :expired
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @type [Openlayer::Internal::Type::Converter]
+      APIKeyListResponse =
+        Openlayer::Internal::Type::ArrayOf[-> { Openlayer::Models::Workspaces::APIKeyListResponseItem }]
+    end
+  end
+end