cadenya 0.2.0 → 0.4.0

data/lib/cadenya/models/workspace_admin_list_params.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::WorkspaceAdmin#list
+    class WorkspaceAdminListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #   Pagination cursor from previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute include_archived
+      #   When true, archived workspaces are included in the results. Defaults to false
+      #   (active workspaces only).
+      #
+      #   @return [Boolean, nil]
+      optional :include_archived, Cadenya::Internal::Type::Boolean
+
+      # @!attribute limit
+      #   Maximum number of results to return
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(cursor: nil, include_archived: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::WorkspaceAdminListParams} for more details.
+      #
+      #   @param cursor [String] Pagination cursor from previous response
+      #
+      #   @param include_archived [Boolean] When true, archived workspaces are included in the results. Defaults to
+      #
+      #   @param limit [Integer] Maximum number of results to return
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/workspace_admin_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::WorkspaceAdmin#retrieve
+    class WorkspaceAdminRetrieveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::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 [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/workspace_admin_update_params.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::WorkspaceAdmin#update
+    class WorkspaceAdminUpdateParams < 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 metadata
+      #   UpdateAccountResourceMetadata contains the user-provided fields for updating an
+      #   account-scoped resource. Read-only fields (id, account_id, profile_id) are
+      #   excluded since they are set by the server.
+      #
+      #   @return [Cadenya::Models::WorkspaceAdminUpdateParams::Metadata, nil]
+      optional :metadata, -> { Cadenya::WorkspaceAdminUpdateParams::Metadata }
+
+      # @!attribute spec
+      #
+      #   @return [Cadenya::Models::WorkspaceSpec, nil]
+      optional :spec, -> { Cadenya::WorkspaceSpec }
+
+      # @!attribute update_mask
+      #   Fields to update.
+      #
+      #   @return [String, nil]
+      optional :update_mask, String, api_name: :updateMask
+
+      # @!method initialize(workspace_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::WorkspaceAdminUpdateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param metadata [Cadenya::Models::WorkspaceAdminUpdateParams::Metadata] UpdateAccountResourceMetadata contains the user-provided fields for updating
+      #
+      #   @param spec [Cadenya::Models::WorkspaceSpec]
+      #
+      #   @param update_mask [String] Fields to update.
+      #
+      #   @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::WorkspaceAdminUpdateParams::Metadata} for more details.
+        #
+        #   UpdateAccountResourceMetadata contains the user-provided fields for updating 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/workspace_member.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class WorkspaceMember < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute actor_id
+        #   The actor row linking the profile to the workspace (the junction record).
+        #
+        #   @return [String]
+        required :actor_id, String, api_name: :actorId
+
+        # @!attribute profile_id
+        #   The account profile that has access to the workspace.
+        #
+        #   @return [String]
+        required :profile_id, String, api_name: :profileId
+
+        # @!attribute added_at
+        #   When the member was added to the workspace.
+        #
+        #   @return [Time, nil]
+        optional :added_at, Time, api_name: :addedAt
+
+        # @!attribute email
+        #   Email address of the member's profile.
+        #
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute name
+        #   Display name of the member's profile.
+        #
+        #   @return [String, nil]
+        optional :name, String
+      end
+
+      # @!method initialize(actor_id:, profile_id:, added_at: nil, email: nil, name: nil)
+      #   A member of a workspace: the profile granted access plus the actor row that
+      #   links it to the workspace. Returned by member list/add operations.
+      #
+      #   @param actor_id [String] The actor row linking the profile to the workspace (the junction record).
+      #
+      #   @param profile_id [String] The account profile that has access to the workspace.
+      #
+      #   @param added_at [Time] When the member was added to the workspace.
+      #
+      #   @param email [String] Email address of the member's profile.
+      #
+      #   @param name [String] Display name of the member's profile.
+    end
+  end
+end

data/lib/cadenya/models.rb

@@ -75,6 +75,20 @@ module Cadenya
 
   AgentVariationEntry = Cadenya::Models::AgentVariationEntry
 
+  AIProviderKey = Cadenya::Models::AIProviderKey
+
+  AIProviderKeyCreateParams = Cadenya::Models::AIProviderKeyCreateParams
+
+  AIProviderKeyDeleteParams = Cadenya::Models::AIProviderKeyDeleteParams
+
+  AIProviderKeyListParams = Cadenya::Models::AIProviderKeyListParams
+
+  AIProviderKeyRetrieveParams = Cadenya::Models::AIProviderKeyRetrieveParams
+
+  AIProviderKeySpec = Cadenya::Models::AIProviderKeySpec
+
+  AIProviderKeyUpdateParams = Cadenya::Models::AIProviderKeyUpdateParams
+
   APIKey = Cadenya::Models::APIKey
 
   APIKeyCreateParams = Cadenya::Models::APIKeyCreateParams
@@ -95,10 +109,14 @@ module Cadenya
 
   APIKeyUpdateParams = Cadenya::Models::APIKeyUpdateParams
 
+  ApprovalRequirementFilter = Cadenya::Models::ApprovalRequirementFilter
+
   AssistantMessage = Cadenya::Models::AssistantMessage
 
   AssistantToolCall = Cadenya::Models::AssistantToolCall
 
+  AttributeFilter = Cadenya::Models::AttributeFilter
+
   BareMetadata = Cadenya::Models::BareMetadata
 
   BulkWorkspaceApply = Cadenya::Models::BulkWorkspaceApply
@@ -125,8 +143,6 @@ module Cadenya
 
   CreateResourceMetadata = Cadenya::Models::CreateResourceMetadata
 
-  McpToolFilter = Cadenya::Models::McpToolFilter
-
   MemoryEntryItem = Cadenya::Models::MemoryEntryItem
 
   MemoryLayer = Cadenya::Models::MemoryLayer
@@ -217,6 +233,8 @@ module Cadenya
 
   SearchSearchToolsOrToolSetsParams = Cadenya::Models::SearchSearchToolsOrToolSetsParams
 
+  StringMatcher = Cadenya::Models::StringMatcher
+
   SubAgentSpawned = Cadenya::Models::SubAgentSpawned
 
   SubAgentUpdated = Cadenya::Models::SubAgentUpdated
@@ -239,6 +257,8 @@ module Cadenya
 
   ToolError = Cadenya::Models::ToolError
 
+  ToolFilter = Cadenya::Models::ToolFilter
+
   ToolResult = Cadenya::Models::ToolResult
 
   ToolSet = Cadenya::Models::ToolSet
@@ -249,6 +269,8 @@ module Cadenya
 
   ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp
 
+  ToolSetAdapterOpenAPI = Cadenya::Models::ToolSetAdapterOpenAPI
+
   ToolSetCreateParams = Cadenya::Models::ToolSetCreateParams
 
   ToolSetDeleteParams = Cadenya::Models::ToolSetDeleteParams
@@ -259,6 +281,8 @@ module Cadenya
 
   ToolSetEventData = Cadenya::Models::ToolSetEventData
 
+  ToolSetGetOpenAPISpecParams = Cadenya::Models::ToolSetGetOpenAPISpecParams
+
   ToolSetInfo = Cadenya::Models::ToolSetInfo
 
   ToolSetListEventsParams = Cadenya::Models::ToolSetListEventsParams
@@ -301,10 +325,24 @@ module Cadenya
 
   Workspace = Cadenya::Models::Workspace
 
+  WorkspaceAdmin = Cadenya::Models::WorkspaceAdmin
+
+  WorkspaceAdminArchiveParams = Cadenya::Models::WorkspaceAdminArchiveParams
+
+  WorkspaceAdminCreateParams = Cadenya::Models::WorkspaceAdminCreateParams
+
+  WorkspaceAdminListParams = Cadenya::Models::WorkspaceAdminListParams
+
+  WorkspaceAdminRetrieveParams = Cadenya::Models::WorkspaceAdminRetrieveParams
+
+  WorkspaceAdminUpdateParams = Cadenya::Models::WorkspaceAdminUpdateParams
+
   WorkspaceGetParams = Cadenya::Models::WorkspaceGetParams
 
   WorkspaceListParams = Cadenya::Models::WorkspaceListParams
 
+  WorkspaceMember = Cadenya::Models::WorkspaceMember
+
   WorkspaceSecret = Cadenya::Models::WorkspaceSecret
 
   WorkspaceSecretCreateParams = Cadenya::Models::WorkspaceSecretCreateParams

data/lib/cadenya/resources/ai_provider_keys.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class AIProviderKeys
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AIProviderKeyCreateParams} for more details.
+      #
+      # Creates a new customer-provided AI provider key in the workspace
+      #
+      # @overload create(workspace_id, metadata:, spec:, request_options: {})
+      #
+      # @param workspace_id [String] The workspace that will own this key.
+      #
+      # @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::AIProviderKeySpec]
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::AIProviderKey]
+      #
+      # @see Cadenya::Models::AIProviderKeyCreateParams
+      def create(workspace_id, params)
+        parsed, options = Cadenya::AIProviderKeyCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/workspaces/%1$s/ai_provider_keys", workspace_id],
+          body: parsed,
+          model: Cadenya::AIProviderKey,
+          options: options
+        )
+      end
+
+      # Retrieves an AI provider key by ID from the workspace
+      #
+      # @overload retrieve(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] The key to retrieve.
+      #
+      # @param workspace_id [String] The workspace the key belongs to.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::AIProviderKey]
+      #
+      # @see Cadenya::Models::AIProviderKeyRetrieveParams
+      def retrieve(id, params)
+        parsed, options = Cadenya::AIProviderKeyRetrieveParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/ai_provider_keys/%2$s", workspace_id, id],
+          model: Cadenya::AIProviderKey,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AIProviderKeyUpdateParams} for more details.
+      #
+      # Updates an AI provider key's name or key value in the workspace
+      #
+      # @overload update(id, workspace_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #
+      # @param id [String] Path param: The key to update.
+      #
+      # @param workspace_id [String] Path param: The workspace the key belongs to.
+      #
+      # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+      #
+      # @param spec [Cadenya::Models::AIProviderKeySpec] Body param
+      #
+      # @param update_mask [String] Body param: Fields to update.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::AIProviderKey]
+      #
+      # @see Cadenya::Models::AIProviderKeyUpdateParams
+      def update(id, params)
+        parsed, options = Cadenya::AIProviderKeyUpdateParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :patch,
+          path: ["v1/workspaces/%1$s/ai_provider_keys/%2$s", workspace_id, id],
+          body: parsed,
+          model: Cadenya::AIProviderKey,
+          options: options
+        )
+      end
+
+      # Lists all customer-provided AI provider keys in the workspace
+      #
+      # @overload list(workspace_id, cursor: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      #
+      # @param workspace_id [String] The workspace whose keys will be listed.
+      #
+      # @param cursor [String] Pagination cursor from previous response
+      #
+      # @param limit [Integer] Maximum number of results to return
+      #
+      # @param prefix [String] Filter expression (query param: prefix)
+      #
+      # @param query [String] Free-form search query
+      #
+      # @param sort_order [String] Sort order for results (asc or desc by creation time)
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::AIProviderKey>]
+      #
+      # @see Cadenya::Models::AIProviderKeyListParams
+      def list(workspace_id, params = {})
+        parsed, options = Cadenya::AIProviderKeyListParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/ai_provider_keys", workspace_id],
+          query: query.transform_keys(sort_order: "sortOrder"),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::AIProviderKey,
+          options: options
+        )
+      end
+
+      # Deletes an AI provider key from the workspace
+      #
+      # @overload delete(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] The key to delete.
+      #
+      # @param workspace_id [String] The workspace the key belongs to.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cadenya::Models::AIProviderKeyDeleteParams
+      def delete(id, params)
+        parsed, options = Cadenya::AIProviderKeyDeleteParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :delete,
+          path: ["v1/workspaces/%1$s/ai_provider_keys/%2$s", workspace_id, id],
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cadenya/resources/tool_sets.rb

@@ -184,6 +184,37 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetGetOpenAPISpecParams} for more details.
+      #
+      # Retrieves the current OpenAPI specification JSON that has been consumed by the
+      # tool set. Only applicable to tool sets using the OpenAPI adapter.
+      #
+      # @overload get_openapi_spec(tool_set_id, workspace_id:, request_options: {})
+      #
+      # @param tool_set_id [String] Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ToolSetGetOpenAPISpecResponse]
+      #
+      # @see Cadenya::Models::ToolSetGetOpenAPISpecParams
+      def get_openapi_spec(tool_set_id, params)
+        parsed, options = Cadenya::ToolSetGetOpenAPISpecParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/tool_sets/%2$s/openapi_spec", workspace_id, tool_set_id],
+          model: Cadenya::Models::ToolSetGetOpenAPISpecResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Cadenya::Models::ToolSetListEventsParams} for more details.
       #

data/lib/cadenya/resources/workspace_admin/members.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class WorkspaceAdmin
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      class Members
+        # Lists the members of a workspace. Admin only.
+        #
+        # @overload list(workspace_id, cursor: nil, limit: nil, request_options: {})
+        #
+        # @param workspace_id [String] The workspace whose members will be listed (path).
+        #
+        # @param cursor [String] Pagination cursor from previous response
+        #
+        # @param limit [Integer] Maximum number of results to return
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::WorkspaceMember>]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberListParams
+        def list(workspace_id, params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::MemberListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["v1/account/workspaces/%1$s/members", workspace_id],
+            query: query,
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::WorkspaceMember,
+            options: options
+          )
+        end
+
+        # Grants a profile access to the workspace by creating (or reactivating) the actor
+        # that links the profile to the workspace. Accepts either an existing profile_id
+        # or an email to resolve-or-invite. Idempotent for an already-active member. Admin
+        # only.
+        #
+        # @overload add(workspace_id, email: nil, profile_id: nil, request_options: {})
+        #
+        # @param workspace_id [String] The workspace to add the member to (path).
+        #
+        # @param email [String] Email address to add (resolve-or-invite). Mutually exclusive with profile_id.
+        #
+        # @param profile_id [String] An existing account profile to add. Mutually exclusive with email.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::WorkspaceMember]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberAddParams
+        def add(workspace_id, params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::MemberAddParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["v1/account/workspaces/%1$s/members", workspace_id],
+            body: parsed,
+            model: Cadenya::WorkspaceMember,
+            options: options
+          )
+        end
+
+        # Revokes a member's access by deactivating their actor; the member is immediately
+        # cut off. The underlying profile is not deleted. Admin only.
+        #
+        # @overload remove(profile_id, workspace_id:, request_options: {})
+        #
+        # @param profile_id [String] The profile to remove from the workspace (path).
+        #
+        # @param workspace_id [String] The workspace to remove the member from (path).
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberRemoveParams
+        def remove(profile_id, params)
+          parsed, options = Cadenya::WorkspaceAdmin::MemberRemoveParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/account/workspaces/%1$s/members/%2$s", workspace_id, profile_id],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/workspace_admin/profiles.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class WorkspaceAdmin
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      class Profiles
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::WorkspaceAdmin::ProfileListParams} for more details.
+        #
+        # Searches the account's profiles for a member picker, with free-form name/email
+        # search and an optional type filter. Account-scoped; admin only.
+        #
+        # @overload list(cursor: nil, limit: nil, query: nil, request_options: {})
+        #
+        # @param cursor [String] Pagination cursor from previous response
+        #
+        # @param limit [Integer] Maximum number of results to return
+        #
+        # @param query [String] Free-form search over profile name and email. Case-insensitive substring
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Profile>]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::ProfileListParams
+        def list(params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::ProfileListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "v1/account/profiles",
+            query: query,
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Profile,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end