anthropic 1.74.0 → 1.76.0

data/lib/anthropic/resources/beta/organization/plugin_marketplaces.rb

@@ -0,0 +1,295 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class PluginMarketplaces
+          # Retrieve a plugin marketplace by ID.
+          #
+          # **Accepted credentials:** an Admin API key with the `read:plugins` or
+          # `read:org_audit` scope, or a Compliance Access Key with the
+          # `read:compliance_org_data` scope.
+          #
+          # Every request must include the beta header
+          # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+          # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+          # available to Claude Enterprise organizations only. It is not available to Claude
+          # Platform (Claude Console) organizations, or to organizations with HIPAA
+          # readiness enabled.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Organization::PluginMarketplaceRetrieveParams} for
+          # more details.
+          #
+          # @overload retrieve(marketplace_id, organization_id: nil, betas: nil, request_options: {})
+          #
+          # @param marketplace_id [String] Path param: ID of the plugin marketplace (prefixed `marketplace_`).
+          #
+          # @param organization_id [String, nil] Query param: For a `read:org_audit` or `read:compliance_org_data` key created fo
+          #
+          # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::Beta::Organization::BetaPluginMarketplace]
+          #
+          # @see Anthropic::Models::Beta::Organization::PluginMarketplaceRetrieveParams
+          def retrieve(marketplace_id, params = {})
+            query_params = [:organization_id]
+            parsed, options = Anthropic::Beta::Organization::PluginMarketplaceRetrieveParams.dump_request(params)
+            query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
+            @client.request(
+              method: :get,
+              path: ["v1/organizations/plugin_marketplaces/%1$s?beta=true", marketplace_id],
+              query: query,
+              headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+              model: Anthropic::Beta::Organization::BetaPluginMarketplace,
+              options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+            )
+          end
+
+          # Set the default installation setting of one of the organization's own plugin
+          # marketplaces. Every Plugin in it without a setting of its own gets this default
+          # as its organization-wide setting, including Plugins added later.
+          #
+          # Pass it as `default_installation_preference`. A member's personal marketplace
+          # cannot be updated here (403).
+          #
+          # **Accepted credentials:** an Admin API key with the `write:plugins` scope.
+          #
+          # Every request must include the beta header
+          # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+          # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+          # available to Claude Enterprise organizations only. It is not available to Claude
+          # Platform (Claude Console) organizations, or to organizations with HIPAA
+          # readiness enabled.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Organization::PluginMarketplaceUpdateParams} for more
+          # details.
+          #
+          # @overload update(marketplace_id, default_installation_preference:, betas: nil, request_options: {})
+          #
+          # @param marketplace_id [String] Path param: ID of the plugin marketplace (prefixed `marketplace_`).
+          #
+          # @param default_installation_preference [Symbol, Anthropic::Models::Beta::Organization::PluginMarketplaceUpdateParams::DefaultInstallationPreference] Body param: The organization-wide installation setting every Plugin in the marke
+          #
+          # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::Beta::Organization::BetaPluginMarketplace]
+          #
+          # @see Anthropic::Models::Beta::Organization::PluginMarketplaceUpdateParams
+          def update(marketplace_id, params)
+            parsed, options = Anthropic::Beta::Organization::PluginMarketplaceUpdateParams.dump_request(params)
+            header_params = {betas: "anthropic-beta"}
+            @client.request(
+              method: :post,
+              path: ["v1/organizations/plugin_marketplaces/%1$s?beta=true", marketplace_id],
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
+              model: Anthropic::Beta::Organization::BetaPluginMarketplace,
+              options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+            )
+          end
+
+          # List the plugin marketplaces Plugins live in, newest first: the organization's
+          # own and its members' personal ones.
+          #
+          # Plugin marketplaces are created, connected to a repository and deleted in
+          # claude.ai, not through this API. The organization's library marketplace, the
+          # organization-owned `manual` marketplace that uploads go to when no marketplace
+          # is named, is created the first time something is put in it and is listed from
+          # then on.
+          #
+          # **Accepted credentials:** an Admin API key with the `read:plugins` or
+          # `read:org_audit` scope, or a Compliance Access Key with the
+          # `read:compliance_org_data` scope.
+          #
+          # Every request must include the beta header
+          # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+          # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+          # available to Claude Enterprise organizations only. It is not available to Claude
+          # Platform (Claude Console) organizations, or to organizations with HIPAA
+          # readiness enabled.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Organization::PluginMarketplaceListParams} for more
+          # details.
+          #
+          # @overload list(limit: nil, organization_id: nil, owner_type: nil, page: nil, source: nil, betas: nil, request_options: {})
+          #
+          # @param limit [Integer] Query param: Number of items to return per page.
+          #
+          # @param organization_id [String, nil] Query param: For a `read:org_audit` or `read:compliance_org_data` key created fo
+          #
+          # @param owner_type [Symbol, Anthropic::Models::Beta::Organization::PluginMarketplaceListParams::OwnerType, nil] Query param: `organization` for the organization's plugin marketplaces, `user` f
+          #
+          # @param page [String, nil] Query param: Optionally set to the `next_page` token from the previous response.
+          #
+          # @param source [Symbol, Anthropic::Models::Beta::Organization::PluginMarketplaceListParams::Source, nil] Query param: Only plugin marketplaces with this `source`: `manual` for those who
+          #
+          # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::BetaPluginMarketplace>]
+          #
+          # @see Anthropic::Models::Beta::Organization::PluginMarketplaceListParams
+          def list(params = {})
+            query_params = [:limit, :organization_id, :owner_type, :page, :source]
+            parsed, options = Anthropic::Beta::Organization::PluginMarketplaceListParams.dump_request(params)
+            query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
+            @client.request(
+              method: :get,
+              path: "v1/organizations/plugin_marketplaces?beta=true",
+              query: query,
+              headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+              page: Anthropic::Internal::PageCursor,
+              model: Anthropic::Beta::Organization::BetaPluginMarketplace,
+              options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+            )
+          end
+
+          # Check whether a plugin marketplace, uploaded as a `.zip` of the marketplace
+          # directory, would synchronize into claude.ai, without connecting or storing it.
+          #
+          # To check a public GitHub repository instead, use Validate Plugin Marketplace
+          # Repository.
+          #
+          # The report says whether `marketplace.json` is well-formed, which plugins a
+          # synchronization would skip and why, and which plugins would synchronize only in
+          # part, with some files left out. An archive that cannot be read as a marketplace
+          # is reported, not refused: the response is a report with `valid: false`. Plugin
+          # sources outside the marketplace are fetched anonymously from GitHub, so a
+          # private one is reported as not found; a source on any other host is not fetched
+          # here, and the report notes that it will be checked when the marketplace actually
+          # synchronizes.
+          #
+          # Nothing is recorded on the Compliance API activity feed.
+          #
+          # For a worked example, see
+          # [Validate marketplace content](/docs/en/manage-claude/plugins-api#validate-marketplace-content)
+          # in the Plugins API guide.
+          #
+          # **Accepted credentials:** an Admin API key with the `read:plugins` or
+          # `write:plugins` scope; `read:org_audit` and `read:compliance_org_data` do not
+          # grant it.
+          #
+          # Every request must include the beta header
+          # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+          # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+          # available to Claude Enterprise organizations only. It is not available to Claude
+          # Platform (Claude Console) organizations, or to organizations with HIPAA
+          # readiness enabled.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Organization::PluginMarketplaceValidateArchiveParams}
+          # for more details.
+          #
+          # @overload validate_archive(archive:, betas: nil, request_options: {})
+          #
+          # @param archive [Pathname, StringIO, IO, String, Anthropic::FilePart] Body param: A .zip of the marketplace directory (its contents at the root, or wr
+          #
+          # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::Beta::Organization::BetaPluginMarketplaceValidationReport]
+          #
+          # @see Anthropic::Models::Beta::Organization::PluginMarketplaceValidateArchiveParams
+          def validate_archive(params)
+            parsed, options =
+              Anthropic::Beta::Organization::PluginMarketplaceValidateArchiveParams.dump_request(params)
+            header_params = {betas: "anthropic-beta"}
+            @client.request(
+              method: :post,
+              path: "v1/organizations/plugin_marketplaces/validate_archive?beta=true",
+              headers: {
+                "content-type" => "multipart/form-data",
+                **parsed.slice(*header_params.keys)
+              }.transform_keys(
+                header_params
+              ),
+              body: parsed.except(*header_params.keys),
+              model: Anthropic::Beta::Organization::BetaPluginMarketplaceValidationReport,
+              options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+            )
+          end
+
+          # Check whether a plugin marketplace held in a public GitHub repository would
+          # synchronize into claude.ai, without connecting or storing it.
+          #
+          # To check a `.zip` of the marketplace directory instead, use Validate Plugin
+          # Marketplace Archive.
+          #
+          # The report says whether `marketplace.json` is well-formed, which plugins a
+          # synchronization would skip and why, and which plugins would synchronize only in
+          # part, with some files left out. A repository that is missing, private, or has no
+          # such branch or commit is reported, not refused: the response is a report with
+          # `valid: false`. Plugin sources outside the marketplace are fetched anonymously
+          # from GitHub, so a private one is reported as not found; a source on any other
+          # host is not fetched here, and the report notes that it will be checked when the
+          # marketplace actually synchronizes.
+          #
+          # Nothing is recorded on the Compliance API activity feed.
+          #
+          # For a worked example, see
+          # [Validate marketplace content](/docs/en/manage-claude/plugins-api#validate-marketplace-content)
+          # in the Plugins API guide.
+          #
+          # **Accepted credentials:** an Admin API key with the `read:plugins` or
+          # `write:plugins` scope; `read:org_audit` and `read:compliance_org_data` do not
+          # grant it.
+          #
+          # Every request must include the beta header
+          # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+          # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+          # available to Claude Enterprise organizations only. It is not available to Claude
+          # Platform (Claude Console) organizations, or to organizations with HIPAA
+          # readiness enabled.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::Organization::PluginMarketplaceValidateRepositoryParams}
+          # for more details.
+          #
+          # @overload validate_repository(repository_url:, ref: nil, betas: nil, request_options: {})
+          #
+          # @param repository_url [String] Body param: The `https://` URL of a public repository on github.com that holds t
+          #
+          # @param ref [String, nil] Body param: The branch to validate the tip of, or the full 40-character SHA of t
+          #
+          # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+          #
+          # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Anthropic::Models::Beta::Organization::BetaPluginMarketplaceValidationReport]
+          #
+          # @see Anthropic::Models::Beta::Organization::PluginMarketplaceValidateRepositoryParams
+          def validate_repository(params)
+            parsed, options =
+              Anthropic::Beta::Organization::PluginMarketplaceValidateRepositoryParams.dump_request(params)
+            header_params = {betas: "anthropic-beta"}
+            @client.request(
+              method: :post,
+              path: "v1/organizations/plugin_marketplaces/validate_repository?beta=true",
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
+              model: Anthropic::Beta::Organization::BetaPluginMarketplaceValidationReport,
+              options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Anthropic::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta/organization/plugins/installation_settings.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Plugins
+          class InstallationSettings
+            # List an organization-owned Plugin's installation settings, which say which
+            # members it is for, most recently created first.
+            #
+            # The list holds the Plugin's own organization-wide setting (absent while the
+            # Plugin inherits its marketplace's default) and each RBAC Group's own setting. A
+            # member-owned Plugin has shares instead, so this path returns 404 for one.
+            #
+            # **Accepted credentials:** an Admin API key with the `read:plugins` or
+            # `read:org_audit` scope, or a Compliance Access Key with the
+            # `read:compliance_org_data` scope.
+            #
+            # Every request must include the beta header
+            # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+            # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+            # available to Claude Enterprise organizations only. It is not available to Claude
+            # Platform (Claude Console) organizations, or to organizations with HIPAA
+            # readiness enabled.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Plugins::InstallationSettingListParams}
+            # for more details.
+            #
+            # @overload list(plugin_id, limit: nil, organization_id: nil, page: nil, target_type: nil, betas: nil, request_options: {})
+            #
+            # @param plugin_id [String] Path param: ID of the Plugin (prefixed `plugin_`).
+            #
+            # @param limit [Integer] Query param: Number of items to return per page.
+            #
+            # @param organization_id [String, nil] Query param: For a `read:org_audit` or `read:compliance_org_data` key created fo
+            #
+            # @param page [String, nil] Query param: Optionally set to the `next_page` token from the previous response.
+            #
+            # @param target_type [Symbol, Anthropic::Models::Beta::Organization::Plugins::InstallationSettingListParams::TargetType, nil] Query param: Only settings for this kind of target: `organization` (the organiza
+            #
+            # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::Plugins::BetaPluginInstallationSetting>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Plugins::InstallationSettingListParams
+            def list(plugin_id, params = {})
+              query_params = [:limit, :organization_id, :page, :target_type]
+              parsed, options =
+                Anthropic::Beta::Organization::Plugins::InstallationSettingListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
+              @client.request(
+                method: :get,
+                path: ["v1/organizations/plugins/%1$s/installation_settings?beta=true", plugin_id],
+                query: query,
+                headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::Plugins::BetaPluginInstallationSetting,
+                options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+              )
+            end
+
+            # Remove an organization-owned Plugin's own installation setting for the whole
+            # organization or for one RBAC Group.
+            #
+            # Removing the `organization` target returns the Plugin to its marketplace's
+            # default installation setting and leaves the groups' settings in place. Removing
+            # a group's setting makes the group's members fall back to the Plugin's
+            # organization-wide setting or to the settings of their other groups.
+            #
+            # A target that holds no setting of its own returns 404 (a Plugin that already
+            # inherits its marketplace's default holds no `organization` setting), and so does
+            # a member-owned Plugin.
+            #
+            # A removal counts as one of the Plugin's installation-setting writes: send all of
+            # those writes one at a time. If several arrive for the same Plugin at the same
+            # time, the server handles them one after another and can answer some of them with
+            # `503` and `x-should-retry: true` instead of applying them; wait a second or two
+            # and send the removal again. A `404` on the repeat means the setting is already
+            # gone.
+            #
+            # **Accepted credentials:** an Admin API key with the `write:plugins` scope.
+            #
+            # Every request must include the beta header
+            # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+            # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+            # available to Claude Enterprise organizations only. It is not available to Claude
+            # Platform (Claude Console) organizations, or to organizations with HIPAA
+            # readiness enabled.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Plugins::InstallationSettingRemoveParams}
+            # for more details.
+            #
+            # @overload remove(target, plugin_id:, betas: nil, request_options: {})
+            #
+            # @param target [String] Path param: The target whose own setting is removed: the literal `organization`
+            #
+            # @param plugin_id [String] Path param: ID of the Plugin (prefixed `plugin_`).
+            #
+            # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Models::Beta::Organization::Plugins::BetaDeletedPluginInstallationSetting]
+            #
+            # @see Anthropic::Models::Beta::Organization::Plugins::InstallationSettingRemoveParams
+            def remove(target, params)
+              parsed, options =
+                Anthropic::Beta::Organization::Plugins::InstallationSettingRemoveParams.dump_request(params)
+              plugin_id =
+                parsed.delete(:plugin_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              @client.request(
+                method: :delete,
+                path: [
+                  "v1/organizations/plugins/%1$s/installation_settings/%2$s?beta=true",
+                  plugin_id,
+                  target
+                ],
+                headers: parsed.transform_keys(betas: "anthropic-beta"),
+                model: Anthropic::Beta::Organization::Plugins::BetaDeletedPluginInstallationSetting,
+                options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+              )
+            end
+
+            # Set or change an organization-owned Plugin's installation setting for the whole
+            # organization or for one RBAC Group.
+            #
+            # Writing the value a target already holds of its own changes nothing.
+            #
+            # A member-owned Plugin has shares instead of installation settings, so this path
+            # returns 404 for one.
+            #
+            # Send a Plugin's installation-setting writes one at a time. If several writes for
+            # the same Plugin arrive at the same time, the server handles them one after
+            # another and can answer some of them with `503` instead of applying them. That
+            # `503` carries `x-should-retry: true`, and the write is safe to repeat: wait a
+            # second or two, then send it again.
+            #
+            # **Accepted credentials:** an Admin API key with the `write:plugins` scope.
+            #
+            # Every request must include the beta header
+            # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+            # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+            # available to Claude Enterprise organizations only. It is not available to Claude
+            # Platform (Claude Console) organizations, or to organizations with HIPAA
+            # readiness enabled.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Plugins::InstallationSettingSetParams}
+            # for more details.
+            #
+            # @overload set(target, plugin_id:, installation_preference:, betas: nil, request_options: {})
+            #
+            # @param target [String] Path param: The target whose setting is written: the literal `organization` for
+            #
+            # @param plugin_id [String] Path param: ID of the Plugin (prefixed `plugin_`).
+            #
+            # @param installation_preference [Symbol, Anthropic::Models::Beta::Organization::Plugins::InstallationSettingSetParams::InstallationPreference] Body param: The installation setting the target is to hold for this Plugin: one
+            #
+            # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Models::Beta::Organization::Plugins::BetaPluginInstallationSetting]
+            #
+            # @see Anthropic::Models::Beta::Organization::Plugins::InstallationSettingSetParams
+            def set(target, params)
+              parsed, options =
+                Anthropic::Beta::Organization::Plugins::InstallationSettingSetParams.dump_request(params)
+              plugin_id =
+                parsed.delete(:plugin_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              header_params = {betas: "anthropic-beta"}
+              @client.request(
+                method: :post,
+                path: [
+                  "v1/organizations/plugins/%1$s/installation_settings/%2$s?beta=true",
+                  plugin_id,
+                  target
+                ],
+                headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                body: parsed.except(*header_params.keys),
+                model: Anthropic::Beta::Organization::Plugins::BetaPluginInstallationSetting,
+                options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [Anthropic::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/resources/beta/organization/plugins/shares.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Organization
+        class Plugins
+          class Shares
+            # List the shares the owner of a member-owned Plugin has given — to every member
+            # of the organization, to an RBAC Group, or to one member — most recently granted
+            # first.
+            #
+            # Shares are read-only in this API: members give and withdraw them in claude.ai,
+            # and who gave a share is recorded on the Compliance API activity feed rather than
+            # on the share. An organization-owned Plugin has installation settings instead, so
+            # this path returns 404 for one.
+            #
+            # **Accepted credentials:** an Admin API key with the `read:plugins` or
+            # `read:org_audit` scope, or a Compliance Access Key with the
+            # `read:compliance_org_data` scope.
+            #
+            # Every request must include the beta header
+            # `anthropic-beta: ce-plugins-2026-09-01`. A request without it returns `404`,
+            # exactly as if the endpoint did not exist. The Plugins API is in beta and is
+            # available to Claude Enterprise organizations only. It is not available to Claude
+            # Platform (Claude Console) organizations, or to organizations with HIPAA
+            # readiness enabled.
+            #
+            # Some parameter documentations has been truncated, see
+            # {Anthropic::Models::Beta::Organization::Plugins::ShareListParams} for more
+            # details.
+            #
+            # @overload list(plugin_id, limit: nil, organization_id: nil, page: nil, target_type: nil, betas: nil, request_options: {})
+            #
+            # @param plugin_id [String] Path param: ID of the Plugin (prefixed `plugin_`).
+            #
+            # @param limit [Integer] Query param: Number of items to return per page.
+            #
+            # @param organization_id [String, nil] Query param: For a `read:org_audit` or `read:compliance_org_data` key created fo
+            #
+            # @param page [String, nil] Query param: Optionally set to the `next_page` token from the previous response.
+            #
+            # @param target_type [Symbol, Anthropic::Models::Beta::Organization::Plugins::ShareListParams::TargetType, nil] Query param: Only shares with this kind of target: `organization` (every member)
+            #
+            # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Header param: This endpoint is in beta: requests must send `ce-plugins-2026-09-0
+            #
+            # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Anthropic::Internal::PageCursor<Anthropic::Models::Beta::Organization::Plugins::BetaPluginShare>]
+            #
+            # @see Anthropic::Models::Beta::Organization::Plugins::ShareListParams
+            def list(plugin_id, params = {})
+              query_params = [:limit, :organization_id, :page, :target_type]
+              parsed, options = Anthropic::Beta::Organization::Plugins::ShareListParams.dump_request(params)
+              query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
+              @client.request(
+                method: :get,
+                path: ["v1/organizations/plugins/%1$s/shares?beta=true", plugin_id],
+                query: query,
+                headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+                page: Anthropic::Internal::PageCursor,
+                model: Anthropic::Beta::Organization::Plugins::BetaPluginShare,
+                options: {extra_headers: {"anthropic-beta" => "ce-plugins-2026-09-01"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [Anthropic::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end