cadenya 0.1.0

data/lib/cadenya/models/agents/variation_remove_memory_layer_params.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#remove_memory_layer
+      class VariationRemoveMemoryLayerParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute variation_id
+        #
+        #   @return [String]
+        required :variation_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, variation_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param variation_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/variation_retrieve_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#retrieve
+      class VariationRetrieveParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/variation_update_memory_layer_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#update_memory_layer
+      class VariationUpdateMemoryLayerParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute variation_id
+        #
+        #   @return [String]
+        required :variation_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute position
+        #   New position. Only field currently updatable on an assignment.
+        #
+        #   @return [Integer, nil]
+        optional :position, Integer
+
+        # @!method initialize(workspace_id:, agent_id:, variation_id:, id:, position: nil, request_options: {})
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param variation_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param position [Integer] New position. Only field currently updatable on an assignment.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/variation_update_params.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#update
+      class VariationUpdateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute metadata
+        #   UpdateResourceMetadata contains the user-provided fields for updating a
+        #   workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+        #   profile_id, created_at) are excluded since they are set by the server.
+        #
+        #   @return [Cadenya::Models::UpdateResourceMetadata, nil]
+        optional :metadata, -> { Cadenya::UpdateResourceMetadata }
+
+        # @!attribute spec
+        #   AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpec, nil]
+        optional :spec, -> { Cadenya::Agents::AgentVariationSpec }
+
+        # @!attribute update_mask
+        #   Fields to update
+        #
+        #   @return [String, nil]
+        optional :update_mask, String, api_name: :updateMask
+
+        # @!method initialize(workspace_id:, agent_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationUpdateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @param update_mask [String] Fields to update
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/webhook_delivery.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::WebhookDeliveries#list
+      class WebhookDelivery < Cadenya::Internal::Type::BaseModel
+        # @!attribute data
+        #   Webhook delivery details.
+        #
+        #   @return [Cadenya::Models::Agents::WebhookDeliveryData]
+        required :data, -> { Cadenya::Agents::WebhookDeliveryData }
+
+        # @!attribute metadata
+        #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        #   runs)
+        #
+        #   @return [Cadenya::Models::OperationMetadata]
+        required :metadata, -> { Cadenya::OperationMetadata }
+
+        # @!method initialize(data:, metadata:)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::WebhookDelivery} for more details.
+        #
+        #   @param data [Cadenya::Models::Agents::WebhookDeliveryData] Webhook delivery details.
+        #
+        #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/webhook_delivery_data.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class WebhookDeliveryData < Cadenya::Internal::Type::BaseModel
+        # @!attribute agent_id
+        #   Related resources
+        #
+        #   @return [String]
+        required :agent_id, String, api_name: :agentId
+
+        # @!attribute attempt_count
+        #
+        #   @return [Integer]
+        required :attempt_count, Integer, api_name: :attemptCount
+
+        # @!attribute event_type
+        #   The type of objective event that triggered this webhook delivery
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::WebhookDeliveryData::EventType]
+        required :event_type,
+                 enum: -> {
+                   Cadenya::Agents::WebhookDeliveryData::EventType
+                 },
+                 api_name: :eventType
+
+        # @!attribute http_status_code
+        #   Response details. The response body is not retained.
+        #
+        #   @return [Integer]
+        required :http_status_code, Integer, api_name: :httpStatusCode
+
+        # @!attribute last_attempt_at
+        #
+        #   @return [Time]
+        required :last_attempt_at, Time, api_name: :lastAttemptAt
+
+        # @!attribute latency_ms
+        #
+        #   @return [Integer]
+        required :latency_ms, Integer, api_name: :latencyMs
+
+        # @!attribute objective_event_id
+        #
+        #   @return [String]
+        required :objective_event_id, String, api_name: :objectiveEventId
+
+        # @!attribute objective_id
+        #
+        #   @return [String]
+        required :objective_id, String, api_name: :objectiveId
+
+        # @!attribute response_content_length
+        #   Content length of the response body in bytes
+        #
+        #   @return [String]
+        required :response_content_length, String, api_name: :responseContentLength
+
+        # @!attribute status
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::WebhookDeliveryData::Status]
+        required :status, enum: -> { Cadenya::Agents::WebhookDeliveryData::Status }
+
+        # @!attribute webhook_id
+        #
+        #   @return [String]
+        required :webhook_id, String, api_name: :webhookId
+
+        # @!attribute webhook_url
+        #   Webhook delivery details
+        #
+        #   @return [String]
+        required :webhook_url, String, api_name: :webhookUrl
+
+        # @!attribute error_message
+        #
+        #   @return [String, nil]
+        optional :error_message, String, api_name: :errorMessage
+
+        # @!attribute response_headers
+        #   Response headers received from the webhook endpoint
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :response_headers, Cadenya::Internal::Type::HashOf[String], api_name: :responseHeaders
+
+        # @!method initialize(agent_id:, attempt_count:, event_type:, http_status_code:, last_attempt_at:, latency_ms:, objective_event_id:, objective_id:, response_content_length:, status:, webhook_id:, webhook_url:, error_message: nil, response_headers: nil)
+        #   @param agent_id [String] Related resources
+        #
+        #   @param attempt_count [Integer]
+        #
+        #   @param event_type [Symbol, Cadenya::Models::Agents::WebhookDeliveryData::EventType] The type of objective event that triggered this webhook delivery
+        #
+        #   @param http_status_code [Integer] Response details. The response body is not retained.
+        #
+        #   @param last_attempt_at [Time]
+        #
+        #   @param latency_ms [Integer]
+        #
+        #   @param objective_event_id [String]
+        #
+        #   @param objective_id [String]
+        #
+        #   @param response_content_length [String] Content length of the response body in bytes
+        #
+        #   @param status [Symbol, Cadenya::Models::Agents::WebhookDeliveryData::Status]
+        #
+        #   @param webhook_id [String]
+        #
+        #   @param webhook_url [String] Webhook delivery details
+        #
+        #   @param error_message [String]
+        #
+        #   @param response_headers [Hash{Symbol=>String}] Response headers received from the webhook endpoint
+
+        # The type of objective event that triggered this webhook delivery
+        #
+        # @see Cadenya::Models::Agents::WebhookDeliveryData#event_type
+        module EventType
+          extend Cadenya::Internal::Type::Enum
+
+          OBJECTIVE_EVENT_TYPE_UNSPECIFIED = :OBJECTIVE_EVENT_TYPE_UNSPECIFIED
+          OBJECTIVE_EVENT_TYPE_USER_MESSAGE = :OBJECTIVE_EVENT_TYPE_USER_MESSAGE
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
+          OBJECTIVE_EVENT_TYPE_TOOL_DENIED = :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
+          OBJECTIVE_EVENT_TYPE_TOOL_CALLED = :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
+          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED = :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
+          OBJECTIVE_EVENT_TYPE_ERROR = :OBJECTIVE_EVENT_TYPE_ERROR
+          OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE = :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
+          OBJECTIVE_EVENT_TYPE_TOOL_RESULT = :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
+          OBJECTIVE_EVENT_TYPE_TOOL_ERROR = :OBJECTIVE_EVENT_TYPE_TOOL_ERROR
+          OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED = :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
+          OBJECTIVE_EVENT_TYPE_MEMORY_READ = :OBJECTIVE_EVENT_TYPE_MEMORY_READ
+          OBJECTIVE_EVENT_TYPE_CANCELLED = :OBJECTIVE_EVENT_TYPE_CANCELLED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Cadenya::Models::Agents::WebhookDeliveryData#status
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          WEBHOOK_DELIVERY_STATUS_UNSPECIFIED = :WEBHOOK_DELIVERY_STATUS_UNSPECIFIED
+          WEBHOOK_DELIVERY_STATUS_PENDING = :WEBHOOK_DELIVERY_STATUS_PENDING
+          WEBHOOK_DELIVERY_STATUS_COMPLETED = :WEBHOOK_DELIVERY_STATUS_COMPLETED
+          WEBHOOK_DELIVERY_STATUS_FAILED = :WEBHOOK_DELIVERY_STATUS_FAILED
+          WEBHOOK_DELIVERY_STATUS_DISABLED = :WEBHOOK_DELIVERY_STATUS_DISABLED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/webhook_delivery_list_params.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::WebhookDeliveries#list
+      class WebhookDeliveryListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute event_type
+        #   Optional filter by event type
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::WebhookDeliveryListParams::EventType, nil]
+        optional :event_type, enum: -> { Cadenya::Agents::WebhookDeliveryListParams::EventType }
+
+        # @!attribute limit
+        #   Maximum number of results to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute objective_id
+        #   Optional filter by objective ID
+        #
+        #   @return [String, nil]
+        optional :objective_id, String
+
+        # @!method initialize(workspace_id:, agent_id:, cursor: nil, event_type: nil, limit: nil, objective_id: nil, request_options: {})
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param cursor [String] Pagination cursor from previous response
+        #
+        #   @param event_type [Symbol, Cadenya::Models::Agents::WebhookDeliveryListParams::EventType] Optional filter by event type
+        #
+        #   @param limit [Integer] Maximum number of results to return
+        #
+        #   @param objective_id [String] Optional filter by objective ID
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+        # Optional filter by event type
+        module EventType
+          extend Cadenya::Internal::Type::Enum
+
+          OBJECTIVE_EVENT_TYPE_UNSPECIFIED = :OBJECTIVE_EVENT_TYPE_UNSPECIFIED
+          OBJECTIVE_EVENT_TYPE_USER_MESSAGE = :OBJECTIVE_EVENT_TYPE_USER_MESSAGE
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
+          OBJECTIVE_EVENT_TYPE_TOOL_DENIED = :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
+          OBJECTIVE_EVENT_TYPE_TOOL_CALLED = :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
+          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED = :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
+          OBJECTIVE_EVENT_TYPE_ERROR = :OBJECTIVE_EVENT_TYPE_ERROR
+          OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE = :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
+          OBJECTIVE_EVENT_TYPE_TOOL_RESULT = :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
+          OBJECTIVE_EVENT_TYPE_TOOL_ERROR = :OBJECTIVE_EVENT_TYPE_TOOL_ERROR
+          OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED = :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
+          OBJECTIVE_EVENT_TYPE_MEMORY_READ = :OBJECTIVE_EVENT_TYPE_MEMORY_READ
+          OBJECTIVE_EVENT_TYPE_CANCELLED = :OBJECTIVE_EVENT_TYPE_CANCELLED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/api_key.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::APIKeys#create
+    class APIKey < Cadenya::Internal::Type::BaseModel
+      # @!attribute metadata
+      #   AccountResourceMetadata is used to represent a resource that is associated to an
+      #   account but not to a workspace.
+      #
+      #   @return [Cadenya::Models::AccountResourceMetadata]
+      required :metadata, -> { Cadenya::AccountResourceMetadata }
+
+      # @!attribute spec
+      #   Configuration for an API key.
+      #
+      #   @return [Cadenya::Models::APIKeySpec]
+      required :spec, -> { Cadenya::APIKeySpec }
+
+      # @!attribute info
+      #
+      #   @return [Cadenya::Models::APIKeyInfo, nil]
+      optional :info, -> { Cadenya::APIKeyInfo }
+
+      # @!method initialize(metadata:, spec:, info: nil)
+      #   Some parameter documentations has been truncated, see {Cadenya::Models::APIKey}
+      #   for more details.
+      #
+      #   An API key for the account. Use workspace-association RPCs to grant the key
+      #   access to specific workspaces; a key with zero workspaces is valid but cannot
+      #   access workspace-scoped resources.
+      #
+      #   @param metadata [Cadenya::Models::AccountResourceMetadata] AccountResourceMetadata is used to represent a resource that is associated to an
+      #
+      #   @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.
+      #
+      #   @param info [Cadenya::Models::APIKeyInfo]
+    end
+  end
+end

data/lib/cadenya/models/api_key_create_params.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::APIKeys#create
+    class APIKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute metadata
+      #   CreateAccountResourceMetadata contains the user-provided fields for creating an
+      #   account-scoped resource. Read-only fields (id, account_id, profile_id) are
+      #   excluded since they are set by the server.
+      #
+      #   @return [Cadenya::Models::APIKeyCreateParams::Metadata]
+      required :metadata, -> { Cadenya::APIKeyCreateParams::Metadata }
+
+      # @!attribute spec
+      #   Configuration for an API key.
+      #
+      #   @return [Cadenya::Models::APIKeySpec]
+      required :spec, -> { Cadenya::APIKeySpec }
+
+      # @!attribute initial_workspace_ids
+      #   Workspaces this API key will have access to on creation. Optional — a key can be
+      #   created with no workspace access and granted later via AddAPIKeyWorkspace.
+      #
+      #   @return [Array<String>, nil]
+      optional :initial_workspace_ids,
+               Cadenya::Internal::Type::ArrayOf[String],
+               api_name: :initialWorkspaceIds
+
+      # @!method initialize(metadata:, spec:, initial_workspace_ids: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::APIKeyCreateParams} for more details.
+      #
+      #   @param metadata [Cadenya::Models::APIKeyCreateParams::Metadata] CreateAccountResourceMetadata contains the user-provided fields for creating
+      #
+      #   @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.
+      #
+      #   @param initial_workspace_ids [Array<String>] Workspaces this API key will have access to on creation. Optional —
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      class Metadata < Cadenya::Internal::Type::BaseModel
+        # @!attribute name
+        #   Human-readable name for the resource (e.g., "Production API Key", "Staging
+        #   Workspace")
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute external_id
+        #   External ID for the resource (e.g., a workflow ID from an external system)
+        #
+        #   @return [String, nil]
+        optional :external_id, String, api_name: :externalId
+
+        # @!attribute labels
+        #   Arbitrary key-value pairs for categorization and filtering Examples:
+        #   {"environment": "production", "team": "platform", "version": "v2"}
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+        # @!method initialize(name:, external_id: nil, labels: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::APIKeyCreateParams::Metadata} for more details.
+        #
+        #   CreateAccountResourceMetadata contains the user-provided fields for creating an
+        #   account-scoped resource. Read-only fields (id, account_id, profile_id) are
+        #   excluded since they are set by the server.
+        #
+        #   @param name [String] Human-readable name for the resource (e.g., "Production API Key", "Staging Works
+        #
+        #   @param external_id [String] External ID for the resource (e.g., a workflow ID from an external system)
+        #
+        #   @param labels [Hash{Symbol=>String}] Arbitrary key-value pairs for categorization and filtering
+      end
+    end
+  end
+end

data/lib/cadenya/models/api_key_delete_params.rb

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

data/lib/cadenya/models/api_key_info.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class APIKeyInfo < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute created_by
+        #   A profile identifies a user or non-human principal (such as an API key) at the
+        #   account level. Profiles are account-scoped and can be granted access to multiple
+        #   workspaces.
+        #
+        #   @return [Cadenya::Models::Profile, nil]
+        optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+        # @!attribute workspaces_preview
+        #   Up to a small number of workspaces this key has access to, intended for display
+        #   ("Workspace 1, Workspace 2, and 4 more"). Use ListAPIKeyWorkspaces for the full
+        #   paginated list.
+        #
+        #   @return [Array<Cadenya::Models::BareMetadata>, nil]
+        optional :workspaces_preview,
+                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::BareMetadata] },
+                 api_name: :workspacesPreview
+
+        # @!attribute workspaces_total
+        #   Total number of workspaces this key has access to.
+        #
+        #   @return [Integer, nil]
+        optional :workspaces_total, Integer, api_name: :workspacesTotal
+      end
+
+      # @!method initialize(created_by: nil, workspaces_preview: nil, workspaces_total: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::APIKeyInfo} for more details.
+      #
+      #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+      #
+      #   @param workspaces_preview [Array<Cadenya::Models::BareMetadata>] Up to a small number of workspaces this key has access to, intended
+      #
+      #   @param workspaces_total [Integer] Total number of workspaces this key has access to.
+    end
+  end
+end