Claude Platform Docs

List Plugin Shares

$ ant beta:organization:plugins:shares list
GET/v1/organizations/plugins/{plugin_id}/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.

Parameters
--plugin-id: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

--limit: optional number⁠Query parameter

Number of items to return per page.

Defaults to 20. Ranges from 1 to 100.

minimum1
maximum100
--organization-id: optional string⁠Query parameter

For a read:org_audit or read:compliance_org_data key created for all of a parent organization's linked organizations: a child organization of that parent to read instead of the organization the key was created in, given as the organization's UUID or its org_-prefixed ID. A value that is neither returns a 400; an organization that is not a child of the key's parent, or where the Plugins API is not available, returns a 404. Any other key may pass only its own organization's ID here; another organization returns a 404.

--page: optional string⁠Query parameter

Optionally set to the next_page token from the previous response.

maxLength2048
--target-type: optional "organization" or "organization_member" or "rbac_group"⁠Query parameter

Only shares with this kind of target: organization (every member), rbac_group (one RBAC Group), or organization_member (one member).

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send ce-plugins-2026-09-01 in this header.

Returns
BetaPluginShareList: object{ data, next_page }
data: array of BetaPluginShare { type: "plugin_share", granted_at, plugin_id, target }
type: "plugin_share"

Always plugin_share.

granted_at: string

When the share was given; a share whose role is later changed in claude.ai is re-granted and carries the time of that change.

formatdate-time
plugin_id: string

The Plugin's ID.

target: BetaPluginTargetOrganization or BetaPluginTargetRBACGroup or BetaPluginTargetOrganizationMember

Who the Plugin is shared with: organization (every member), rbac_group (one RBAC Group), or organization_member (one member).

One of the following:
beta_plugin_target_organization: object{ type: "organization" }
type: "organization"

Every member of the organization.

beta_plugin_target_rbac_group: object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"

An RBAC Group.

rbac_group_id: string

The RBAC Group's ID.

beta_plugin_target_organization_member: object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

user_id: string

The member's User ID.

next_page: string

Token to provide in as page in the subsequent request to retrieve the next page of data.

List Plugin Shares
ant beta:organization:plugins:shares list \
  --api-key my-anthropic-api-key \
  --plugin-id plugin_id
Returns Examples
Response 200
{
  "data": [
    {
      "granted_at": "2026-03-14T09:26:53.589793Z",
      "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
      "target": {
        "type": "organization"
      },
      "type": "plugin_share"
    }
  ],
  "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo"
}